Connect Claude (MCP)
Connect Claude to Switchboard so you can explore your data directly in a Claude conversation.
Connect Claude to Switchboard so you can explore your data directly in a Claude conversation.
How it works
Switchboard connects to Claude as a custom connector. On a Team/Enterprise workspace there are two roles:
- A workspace Owner enables it once for the whole team (Part 1).
- Everyone then connects their own account in a couple of clicks (Part 2).
Individual members cannot add a custom connector themselves. If your workspace can't or won't enable it, there's a per-user fallback at the end.
Which section do I need?
| You are… | Go to |
|---|---|
| A workspace Owner / Primary Owner setting this up for the team | Part 1, then Part 2 |
| A team member and an Owner has already enabled Switchboard | Part 2 |
| Someone who needs it working now and the workspace hasn't enabled it | Fallback |
Connector URL (you'll need this):
https://api.switchboard.build/mcpPart 1 — Owner: enable Switchboard for the team (one time)
Only a workspace Owner / Primary Owner can do this. It's done in the admin console, which is separate from Settings and Customize.
- In a browser, go to
claude.ai/admin-settings/connectors(this is Organization settings → Connectors). - Click the Add button.
- Hover over Custom, then choose Web.
- Enter:
- Name:
Switchboard - Remote MCP server URL:
https://api.switchboard.build/mcp - Leave Advanced settings (OAuth Client ID/Secret) blank.
- Name:
- Click Add.
Switchboard is now available to the whole workspace. This does not grant anyone data access on its own — each person still connects and signs in (Part 2).
If
claude.ai/admin-settings/connectorsjust redirects you to Customize: your account isn't the workspace's Primary Owner, or custom connectors aren't enabled for your plan/workspace. Confirm who the Primary Owner is, or contact Anthropic support. Members who need access before then can use the Fallback below.
Part 2 — Everyone: connect your account
Once an Owner has enabled Switchboard (Part 1):
- Open Claude Desktop or claude.ai → Customize → Connectors.
- Find Switchboard in the list — it'll be tagged Custom (usually under Not connected).
- Click Connect.
- Claude opens your browser — log in with your Switchboard account and approve.
- The connector shows Connected.
- In a chat, open the connectors/tools menu in the message box and make sure Switchboard is on.
Fallback — per-user setup (no admin needed)
Use this only if your workspace hasn't enabled the Switchboard connector and you need it working now. It runs a small helper on your own machine, so it doesn't depend on workspace settings.
Requires: Node.js installed (provides npx).
What it is: mcp-remote is an open-source bridge that lets Claude Desktop's local config talk to Switchboard's remote server and handles the browser sign-in. It runs on your machine and connects directly to Switchboard.
Steps:
- Open Claude Desktop's config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Or via Settings → Developer → Edit Config.
- macOS:
- Add a
switchboardentry (merge intomcpServersif it already exists):
{
"mcpServers": {
"switchboard": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.switchboard.build/mcp"]
}
}
}- Save, then fully quit and reopen Claude Desktop.
- A browser window opens for the Switchboard sign-in — log in and approve.
switchboardnow appears in your tools menu.
Verify it works
Start a new chat and ask:
List my Switchboard models.
Claude should return your models. Also try:
How many data sources do I have connected, and what's the sync state of each?
What columns are on my Customers model?
What were the results of my most recent build runs — did anything fail?
What you get
Once connected, Claude can:
| Ask Claude to… | It uses |
|---|---|
| List the data models in your workspace | get_models |
| Describe one model's columns, aggregations, and relationships | get_model_details |
| List your connected data sources | list_sources |
| Show a source's tables and sync state | get_source_details |
| Show recent build runs | list_build_runs |
| Show one build run's status and any errors | get_build_run |
| Query against your data | execute_sql |