Skip to main content

MCP Clients — Bridge Town

Connect Bridge Town to the agent your team already uses. Claude.ai uses OAuth (no token needed). Other clients use a bearer token from app.bridgetown.builders/connect.

Claude.ai

The fastest way to get started. Open Claude.ai → Customize → + Add custom connector, paste the URL below, and authorise via Bridge Town’s OAuth consent screen.

https://api.bridgetown.builders/mcp

→ Connect Claude.ai step by step

Claude Desktop

Claude Desktop requires the mcp-remote bridge. Add the following to your claude_desktop_config.json under mcpServers:

{
  "bridge-town": {
    "command": "npx",
    "args": [
      "-y", "mcp-remote",
      "https://api.bridgetown.builders/mcp",
      "--header",
      "Authorization: Bearer btk_YOUR_TOKEN"
    ]
  }
}

Generate your token at app.bridgetown.builders/connect.

→ Connect Claude Desktop step by step

Claude Code

Install via the CLI with your bearer token:

claude mcp add bridge-town https://api.bridgetown.builders/mcp \
  --transport http \
  --header "Authorization: Bearer btk_YOUR_TOKEN"

Generate your token at app.bridgetown.builders/connect. claude mcp list to verify.

→ Connect Claude Code step by step

Codex

codex mcp add bridge-town https://api.bridgetown.builders/mcp \
  --transport http \
  --header "Authorization: Bearer btk_YOUR_TOKEN"

Generate your token at app.bridgetown.builders/connect. codex mcp list to verify.

Cursor

Add to your Cursor MCP config (~/.cursor/mcp.json):

{
  "mcpServers": {
    "bridge-town": {
      "transport": {
        "type": "http",
        "url": "https://api.bridgetown.builders/mcp",
        "headers": {
          "Authorization": "Bearer btk_YOUR_TOKEN"
        }
      }
    }
  }
}

Restart Cursor after saving. Generate your token at app.bridgetown.builders/connect.

OpenCode

opencode mcp add bridge-town https://api.bridgetown.builders/mcp \
  --transport http \
  --header "Authorization: Bearer btk_YOUR_TOKEN"

Or use the JSON config form (same shape as the Cursor example above in opencode.json → mcpServers).

Any other MCP client

Any client that supports MCP Streamable HTTP transport can connect:

Transport: http
URL: https://api.bridgetown.builders/mcp
Header: Authorization: Bearer btk_YOUR_TOKEN

See the manual connection guide for the full JSON config format and mcp-remote bridge instructions for legacy SSE-only clients.

Questions?

→ Full getting started guide
→ MCP overview
→ support@bridgetown.builders