Connecting Claude Code
Claude Code connects to Bridge Town via the Model Context Protocol (MCP) over Streamable HTTP.
Prerequisites
Section titled “Prerequisites”- Claude Code installed
- A Bridge Town account with an API token (create one from Connect AI or directly at app.bridgetown.builders/connect)
Connect
Section titled “Connect”Run this command in your terminal (replace btk_YOUR_TOKEN with your actual token):
claude mcp add bridge-town https://app.bridgetown.builders/mcp --transport http \ --header "Authorization: Bearer btk_YOUR_TOKEN"Restart Claude Code after adding the server.
In Bridge Town, you can manage and revoke tokens from Connect AI (/connect).
Verify
Section titled “Verify”Ask Claude:
“Check if Bridge Town is connected”
Claude will read the health://status resource and show your tenant ID and user ID if everything is working.
Self-hosted / local dev
Section titled “Self-hosted / local dev”If you’re running Bridge Town locally via Docker Compose:
claude mcp add bridge-town http://localhost:8000/mcp --transport http \ --header "Authorization: Bearer btk_YOUR_TOKEN"Troubleshooting
Section titled “Troubleshooting”“Connection refused”
- Check the MCP server is running:
curl http://localhost:8000/health - Verify the URL matches your deployment
“401 Unauthorized”
- Verify your token is correct and not revoked
- Token must start with
btk_
“Tools not showing up”
- Restart Claude Code after adding the MCP server
- Check
claude mcp listto verify the server was added
Other clients
Section titled “Other clients”Codex, Gemini, OpenCode, ChatGPT-compatible runtimes, and custom MCP agents follow the same Streamable HTTP + bearer token pattern — see Connecting any MCP client for the generic config.