Skip to main content
VS Code supports MCP servers in Copilot’s agent mode. With Spyro AI connected, the agent can read your audit, ranking and Search Console data while you work.

Connect with sign-in

1

Add the server

Create or open .vscode/mcp.json in your project, or run MCP: Add Server from the Command Palette and choose HTTP. Use servers, not mcpServers:
.vscode/mcp.json
2

Start and sign in

Click Start above the server in the file, or run MCP: List Servers. VS Code asks you to sign in. Pick your workspaces and click Allow.

Connect with a key

Use an inputs entry so VS Code prompts for the key once and stores it securely. It never sits in the file:
.vscode/mcp.json

Use it

1

Open Copilot Chat in agent mode

Open Chat and choose Agent in the mode picker.
2

Check the tools

Open the tools picker and make sure the spyro-ai tools are ticked. You can untick the nine manage* tools to keep the agent read only.
3

Ask

“Use Spyro AI to give me an overview of my workspace.”

Try these prompts

  • “Use Spyro AI to list my critical audit issues, then fix the ones in this repo.”
  • “Find pages with a low click rate in Search Console and rewrite their meta descriptions.”
  • “Check my AI visibility with Spyro AI and suggest content to add.”

Tips

  • Put the file in .vscode/mcp.json for a team, or add the server to your user settings for all projects.
  • Add .vscode/mcp.json to .gitignore if it holds anything sensitive. The inputs form keeps the key itself out of it.
  • VS Code asks you to confirm tool calls. Read action requests before you accept.
  • Check MCP: List Servers and Show Output if a server does not start.

If it fails

  • Server is not found: the top-level key must be servers. Copying an mcpServers example from another editor will not work here.
  • Cannot start: check type is "http" and the address is exact.
  • 401 error: sign in again, or re-enter the key when VS Code prompts.
  • More: Troubleshooting.
VS Code’s reference: MCP configuration.