# Connect BugBoard to VS Code

Once the server is in its config, VS Code can read and write your BugBoard tasks over MCP. You need a BugBoard account and about two minutes.

## 1. Create a token

In BugBoard, open the MCP page and create a key. It starts with bb_ and is shown once. The server keeps only a hash of it, so if you lose it, re-issue it from the same page.

[Open the MCP page](https://bugboard.ai/mcp)

## 2. Put the token in an environment variable

The configs below read the token from BUGBOARD_MCP_TOKEN, so it never lands in a file you commit. Set it in your shell profile or your secrets manager.

## 3. Add the server

Save as .vscode/mcp.json:

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "bugboard-token",
      "description": "BugBoard MCP token",
      "password": true
    }
  ],
  "servers": {
    "bugboard": {
      "type": "http",
      "url": "https://api.bugboard.ai/mcp/sse",
      "headers": {
        "Authorization": "Bearer ${input:bugboard-token}"
      }
    }
  }
}
```

Or, in the portable format, save as .mcp.json:

```json
{
  "mcpServers": {
    "bugboard": {
      "type": "http",
      "url": "https://api.bugboard.ai/mcp/sse",
      "headers": {
        "Authorization": "Bearer ${BUGBOARD_MCP_TOKEN}"
      }
    }
  }
}
```

VS Code asks for the token the first time the server starts and stores it, so the token is not in the file. If your setup reads the portable .mcp.json in the workspace root instead, use the second file: it has no inputs and reads the token from the environment variable.

## 4. Check the connection

Ask the agent to list your BugBoard projects: it calls list_projects. Without an agent, this call lists the tools the server offers:

```bash
curl -sS https://api.bugboard.ai/mcp/message \
  -H "Authorization: Bearer $BUGBOARD_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Authentication is this token. A key can be narrowed to read-only access or to chosen projects, and every call is rate-limited per token; the MCP guide has the details.

- [BugBoard MCP guide (tools, scopes, rate limit), as Markdown](https://bugboard.ai/llms/mcp.md)
- [VS Code MCP documentation](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)
- Config format checked against the VS Code documentation on 2026-11-14.

## Other clients

- [Claude Code](https://bugboard.ai/mcp-server/claude-code.md)
- [Cursor](https://bugboard.ai/mcp-server/cursor.md)
- [Windsurf](https://bugboard.ai/mcp-server/windsurf.md)
- [Codex](https://bugboard.ai/mcp-server/codex.md)
