Add "Use coding agents with Aspire" getting started guide

[Copilot]

Adds documentation for integrating AI coding agents with Aspire applications via the MCP server, positioned after "Deploy your first app" in the getting started flow.

Changes

• New article: /src/frontend/src/content/docs/get-started/coding-agents.mdx

  • PivotSelector for VS Code, Cursor, Claude Desktop, and Visual Studio
  • aspire mcp init command walkthrough with agent-specific configuration paths
  • Documentation of 6 MCP tools: list_resources, list_console_logs, list_structured_logs, list_traces, list_trace_structured_logs, execute_resource_command
  • Playwright MCP server setup recommendation
  • Common workflows and troubleshooting

• Sidebar configuration: Added navigation entry in /src/frontend/config/sidebar/sidebar.topics.ts with i18n translations

MCP Tools Example

// Coding agents can interact with running Aspire apps via MCP tools
"Show me all my resources and their current status"     // → list_resources
"Show me the latest console logs for the apiservice"    // → list_console_logs
"Show me recent traces involving the database resource" // → list_traces
"Restart the apiservice resource"                       // → execute_resource_command

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/CommunityToolkit/Aspire
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ep grep -l aspire mcp init abases/surrealdb.mdx cal/bin/grep MCP date.mdx ep grep -l aspire mcp init tools/mailpit.mdx rep aspire mcp nfig-get.mdx cal/bin/grep grep (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js /home/REDACTED/.ca--noprofile grep -l uild da/index.mdx lib/node-gyp-bin/sh MCP (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ire.dev/src/node--pretty=format:������������ %H �� %aI �� %s �� %D �� %b �� %aN �� %aE ���� git log �� %aE ���� --follow ire.dev/node_modules/.bin/git publishers001.mdnode rc/content/docs//usr/local/bin/npm ire.dev/node_modrun git log %D �� %b �� %aN �� %aE ���� --follow s/.bin/node agnostics/aspirenode rc/content/docs//usr/local/bin/npm e_modules/.bin/srun git (http block)
• https://api.github.com/repos/dotnet/aspire
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ep grep -l aspire mcp init abases/surrealdb.mdx cal/bin/grep MCP date.mdx ep grep -l aspire mcp init tools/mailpit.mdx rep aspire mcp nfig-get.mdx cal/bin/grep grep (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js /home/REDACTED/.ca--noprofile grep -l uild da/index.mdx lib/node-gyp-bin/sh MCP (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ire.dev/src/node--pretty=format:������������ %H �� %aI �� %s �� %D �� %b �� %aN �� %aE ���� git log �� %aE ���� --follow ire.dev/node_modules/.bin/git publishers001.mdnode rc/content/docs//usr/local/bin/npm ire.dev/node_modrun git log %D �� %b �� %aN �� %aE ���� --follow s/.bin/node agnostics/aspirenode rc/content/docs//usr/local/bin/npm e_modules/.bin/srun git (http block)
• https://api.github.com/repos/dotnet/aspire-samples
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ep grep -l aspire mcp init abases/surrealdb.mdx cal/bin/grep MCP date.mdx ep grep -l aspire mcp init tools/mailpit.mdx rep aspire mcp nfig-get.mdx cal/bin/grep grep (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js /home/REDACTED/.ca--noprofile grep -l uild da/index.mdx lib/node-gyp-bin/sh MCP (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ire.dev/src/node--pretty=format:������������ %H �� %aI �� %s �� %D �� %b �� %aN �� %aE ���� git log �� %aE ���� --follow ire.dev/node_modules/.bin/git publishers001.mdnode rc/content/docs//usr/local/bin/npm ire.dev/node_modrun git log %D �� %b �� %aN �� %aE ���� --follow s/.bin/node agnostics/aspirenode rc/content/docs//usr/local/bin/npm e_modules/.bin/srun git (http block)
• https://api.github.com/repos/microsoft/aspire.dev
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ep grep -l aspire mcp init abases/surrealdb.mdx cal/bin/grep MCP date.mdx ep grep -l aspire mcp init tools/mailpit.mdx rep aspire mcp nfig-get.mdx cal/bin/grep grep (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js /home/REDACTED/.ca--noprofile grep -l uild da/index.mdx lib/node-gyp-bin/sh MCP (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ire.dev/src/node--pretty=format:������������ %H �� %aI �� %s �� %D �� %b �� %aN �� %aE ���� git log �� %aE ���� --follow ire.dev/node_modules/.bin/git publishers001.mdnode rc/content/docs//usr/local/bin/npm ire.dev/node_modrun git log %D �� %b �� %aN �� %aE ���� --follow s/.bin/node agnostics/aspirenode rc/content/docs//usr/local/bin/npm e_modules/.bin/srun git (http block)
• telemetry.astro.build
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/astro build grep -l aspire mcp init abases/mongodb-extensions.mdx p/bin/grep MCP n.mdx nfig/composer/venode ./scripts/write-git-env.cjs grep -l aspire mcp init -13.mdx cal/bin/grep aspire mcp earch-logic-desc-c rgo/bin/grep grep (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/astro build grep -l aspire mcp init ko/index.mdx ode /docs dx cal/bin/bash -data-downloader -l aspire mcp init rc/content/docs/integrations/databases/efcore/azauto h aspire mcp urces.mdx rgo/bin/grep grep (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/astro build git log �� %aE ���� --follow it ew.mdx rc/content/docs/-c grep git log %D �� %b �� %aN �� %aE ���� --follow (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

We need to create a new article which walks through using coding agents with Aspire. This will go under the Getting started document section and should probably become the next logical link after you deploy your first app.

We can assume that you've created an app host, potentialy deployed it and now you want to get cranking on some code and use AI to do it.

We need to walk through running the aspire mcp init command, explain what it does (interms of setting up MCP config files) and then how you can work with it with various coding agents. We'll probably need a selector at the top of the page like in some of the other getting started pages where we provide instructions for each coding agent environment.

The page should explain the various MCP tools that we expose as well as recommending setting up the playwright MCP server.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.