Connecting Claude.ai

Claude.ai connects to Bridge Town via OAuth — no API token needed. This is the recommended way to get started.

Prerequisites

• A Claude.ai account (Pro, Team, or Enterprise)
• A Bridge Town account

Connect

1. Open Claude.ai and sign in.

2. Click Customize.

3. Click + then Add custom connector.

4. Paste your Bridge Town MCP URL:

   https://app.bridgetown.builders/mcp

5. Set Name to Bridge Town and paste the URL into Remote MCP server URL.

6. Click Connect.

7. Claude will redirect you to Bridge Town to authorise the connection. Sign in with your Bridge Town account and click Authorise.

8. You’re connected. Claude.ai can now access your Bridge Town workspace.

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

If you’re running Bridge Town locally via Docker Compose, use:

http://localhost:8000/mcp

Note: Claude.ai must be able to reach this URL. For local development, a tunnelling tool like ngrok or cloudflared is required.

Troubleshooting

“Connector not found”

• Confirm you pasted the full URL including the /mcp path

“Authorisation failed”

• Make sure you’re signed in to Bridge Town before approving the connection
• Try the flow again from the connectors page

“Tools not available”

• Disconnect and reconnect the connector
• Check that your Bridge Town account is active

Other clients

Codex, Gemini, OpenCode, ChatGPT-compatible runtimes, and custom MCP agents connect via API token instead of OAuth — see Connecting any MCP client.