# Connect BugBoard to Codex

Once the server is in its config, Codex 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 ~/.codex/config.toml:

```toml
[mcp_servers.bugboard]
url = "https://api.bugboard.ai/mcp/sse"
bearer_token_env_var = "BUGBOARD_MCP_TOKEN"
```

Codex reads MCP servers from the [mcp_servers] tables of ~/.codex/config.toml, or of .codex/config.toml in a trusted project. bearer_token_env_var names the variable whose value Codex sends as the bearer token.

## 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)
- [Codex MCP documentation](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)
- Config format checked against the Codex 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)
- [VS Code](https://bugboard.ai/mcp-server/vscode.md)
- [Windsurf](https://bugboard.ai/mcp-server/windsurf.md)
