Skip to content

Use BugBoard from Windsurf

You need a BugBoard key and Windsurf installed.

1. Save your key

In BugBoard, open the MCP page and create a key. It starts with bb_ and is shown once. Save it as BUGBOARD_MCP_TOKEN in your shell, not in the repo.

~/.zshrc or ~/.bashrc
export BUGBOARD_MCP_TOKEN="bb_…"

2. Add the server

mcp_config.json
{
  "mcpServers": {
    "bugboard": {
      "serverUrl": "https://api.bugboard.ai/mcp/sse",
      "headers": {
        "Authorization": "Bearer ${env:BUGBOARD_MCP_TOKEN}"
      }
    }
  }
}

Windsurf's documentation names two locations: the file that Open MCP config file opens in the Cascade menu (~/.config/devin/mcp_config.json on macOS and Linux), and ~/.codeium/windsurf/mcp_config.json, which the editor uses for discovery. Edit the file that menu action opens. Windsurf fills in ${env:NAME} in the headers, and accepts url in place of serverUrl.

3. Check it

Open Cascade's MCP menu. bugboard should be listed with its tools.

Then ask

  • “What bugs are open in my BugBoard project?”
  • “File this stack trace as a bug, but check for duplicates first.”
  • “Log 45 minutes on the task I just finished.”

Check the key without the editor

This call lists the tools the server offers. It needs only the key, so it tells you whether the key or the editor is the problem.

Terminal
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"}'

If it does not connect

Config format checked against the Windsurf documentation on 2026-11-14. Windsurf MCP documentation This page as Markdown

Other editors