How to connect Runheed to VS Code

VS Code runs MCP servers for Copilot agent mode. The config below prompts for the key once, so it never lands in the repo.

Runheed is an error tracker with an MCP server: your app reports exceptions through a small SDK, and VS Code reads them through the server below.

Steps

1. Create an agent key in Runheed under Settings > Agent keys.
2. Create .vscode/mcp.json with the block below.
3. Start the server from the file (or the MCP: List Servers command) and paste the key when VS Code asks.
4. Open Copilot Chat in agent mode; the runheed tools appear in the tools picker.

Where the config lives: Workspace: .vscode/mcp.json. VS Code uses a "servers" key, not "mcpServers".

{
  "inputs": [
    {
      "type": "promptString",
      "id": "runheed-key",
      "description": "Runheed agent key (al_...)",
      "password": true
    }
  ],
  "servers": {
    "runheed": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://runheed.com/dl/runheed-mcp-0.1.0.tgz"
      ],
      "env": {
        "RUNHEED_API_KEY": "${input:runheed-key}"
      }
    }
  }
}

The npm and PyPI releases are not out yet, so these commands install the same package files straight from runheed.com. Nothing else changes when the registry versions ship.

The server runs with npx, so Node.js 18 or newer must be installed on the machine.

Check that it works

In agent mode: "#runheed_get_recent what errors came in since yesterday?"

If the agent reports a problem

Every Runheed tool error says what went wrong and where to fix it. The common ones:

"RUNHEED_API_KEY is not set"

The key is missing from the server env. Add it and restart the client.

"That is a project key (pk_...)"

You pasted the DSN key. The MCP server needs an agent key that starts with al_.

"This agent key is not recognised"

Typo, or the key was revoked. Create a new one in Settings; keys are shown once.

"The workspace has no active plan"

Choose a plan or fix the card in Settings > Billing. The key works again as soon as the plan is active.

"No errors have been reported yet"

The agent side works. Check that the app has RUNHEED_DSN set and calls runheed.init() at startup.

Still need the SDK side? See the setup docs, or tell VS Code: Read https://runheed.com/SETUP.txt and set up error tracking. Official reference: VS Code MCP servers docs.

Other clients: Claude Code · Cursor · Claude Desktop · Windsurf · Codex CLI