> ## Documentation Index
> Fetch the complete documentation index at: https://spyro.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# VS Code

> Add Spyro AI to Visual Studio Code with GitHub Copilot agent mode, using sign-in or a key that VS Code prompts for and stores securely.



Let your AI agent configure this for you

        Copy configuration prompt


      \<details><summary>Preview the prompt</summary>
        \<pre /></details>

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`:```json .vscode/mcp.json theme={null}
{
  "servers": {
    "spyro-ai": {
      "type": "http",
      "url": "https://mcp.spyro.app/mcp"
    }
  }
}
```**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 keyUse an `inputs` entry so VS Code prompts for the key once and stores it securely. It never sits in the file:```json .vscode/mcp.json theme={null}
{
  "inputs": [
    {
      "type": "promptString",
      "id": "spyro-ai-key",
      "description": "Spyro AI MCP key",
      "password": true
    }
  ],
  "servers": {
    "spyro-ai": {
      "type": "http",
      "url": "https://mcp.spyro.app/mcp",
      "headers": {
        "Authorization": "Bearer ${input:spyro-ai-key}"
      }
    }
  }
}
```## 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](https://spyro.app/docs/product/mcp-troubleshooting.md).VS Code's reference: [MCP configuration](https://code.visualstudio.com/docs/agents/reference/mcp-configuration).## Related- [All connection options](https://spyro.app/docs/product/mcp-connect.md)
- [Tools reference](https://spyro.app/docs/product/mcp-tools.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.