Skip to content

Use BugBoard from Claude Code

You need a BugBoard key and Claude Code 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

Run in your project

Terminal
claude mcp add --transport http bugboard https://api.bugboard.ai/mcp/sse \
  --header "Authorization: Bearer $BUGBOARD_MCP_TOKEN"

Save as .mcp.json

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

The command saves the server for you only. To share it with your team, commit the .mcp.json file: Claude Code asks each person to approve a project server the first time. In .mcp.json the type must be http, because an entry with a url and no type is skipped.

3. Check it

Run /mcp in Claude Code. You should see bugboard as connected.

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 Claude Code documentation on 2026-11-14. Claude Code MCP documentation This page as Markdown

Other editors