Restructure AI coding agents docs: skill-first, MCP as sub-pages#561
Merged
IEvangelist merged 14 commits intorelease/13.2from Mar 19, 2026
Merged
Restructure AI coding agents docs: skill-first, MCP as sub-pages#561IEvangelist merged 14 commits intorelease/13.2from
IEvangelist merged 14 commits intorelease/13.2from
Conversation
- Rename page from 'Configure the MCP server' to 'AI coding agents' - Lead with aspire agent init and the Aspire skill file - Add AGENTS.md migration section (skill file replaces it) - Move MCP server details to a linked sub-page (to be created) - Add AI/MCP/agent SEO keywords to site metadata - Update sidebar label and cross-references Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Move MCP tools reference, security model, troubleshooting, and deployment considerations to a dedicated page under the AI coding agents section. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
New page covering WithMcpServer(), WithPostgresMcp(), aspire mcp tools, and aspire mcp call for resources that expose their own MCP endpoints. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Add C#/TypeScript tabs to all 4 AppHost code blocks across aspire-mcp-server.mdx and resource-mcp-servers.mdx - Add 5 missing MCP tools to the tools table: list_docs, search_docs, get_doc, doctor, refresh_tools Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Explain the CLI's agent-friendly design: background start, wait, structured output, non-interactive mode, docs search, and how the skill file teaches agents these patterns. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The AI coding agents overview now just links to the MCP server page for configuration details. The per-environment JSON examples live on the dedicated page where they belong. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Rename the file to match its content. Update all 11 cross-references across the site. Add redirect from old URL. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
davidfowl
requested review from
IEvangelist,
JamesNK and
maddymontaquila
as code owners
IEvangelist
approved these changes
Mar 19, 2026
src/frontend/src/content/docs/diagnostics/aspirepostgres001.mdx
Outdated
Show resolved
Hide resolved
Comment on lines
+182
to
+186
| - **Resource metadata** — names, types, states, health status, endpoints, and commands | ||
| - **Console logs** — standard output and error streams | ||
| - **Structured logs** — log entries via OpenTelemetry | ||
| - **Distributed traces** — request flow across resources | ||
| - **Integration catalog** — available hosting integration packages |
Member
There was a problem hiding this comment.
Should we need to call out docs here?
IEvangelist
reviewed
Mar 19, 2026
Co-authored-by: David Pine <david.pine@microsoft.com>
maddymontaquila
requested changes
Mar 19, 2026
src/frontend/src/content/docs/diagnostics/aspirepostgres001.mdx
Outdated
Show resolved
Hide resolved
src/frontend/src/content/docs/get-started/aspire-mcp-server.mdx
Outdated
Show resolved
Hide resolved
src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx
Outdated
Show resolved
Hide resolved
src/frontend/src/content/docs/get-started/resource-mcp-servers.mdx
Outdated
Show resolved
Hide resolved
maddymontaquila
approved these changes
Mar 19, 2026
Co-authored-by: Maddy Montaquila (Leger) <maddyleger1@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Restructure the AI coding agents documentation from a single "Configure the MCP server" page into a proper three-page section that leads with the agent experience, not the plumbing.
Changes
Page restructure
configure-mcp.mdx→ai-coding-agents.mdx) — overview page leading withaspire agent init, the Aspire skill file, AGENTS.md migration, and "Why Aspire for coding agents"WithMcpServer(),WithPostgresMcp(),aspire mcp tools/call, custom MCP endpointsSidebar
/get-started/configure-mcp/URLOther changes
AI, MCP, model context protocol, AI coding agents, agentic development, copilot, cursor, claude code, vibe codinglist_docs,search_docs,get_doc,doctor,refresh_tools)