Switchboard Docs
Guides

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 teamPart 1, then Part 2
A team member and an Owner has already enabled SwitchboardPart 2
Someone who needs it working now and the workspace hasn't enabled itFallback

Connector URL (you'll need this):

https://api.switchboard.build/mcp

Part 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.

  1. In a browser, go to claude.ai/admin-settings/connectors (this is Organization settings → Connectors).
  2. Click the Add button.
  3. Hover over Custom, then choose Web.
  4. Enter:
    • Name: Switchboard
    • Remote MCP server URL: https://api.switchboard.build/mcp
    • Leave Advanced settings (OAuth Client ID/Secret) blank.
  5. 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/connectors just 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):

  1. Open Claude Desktop or claude.aiCustomize → Connectors.
  2. Find Switchboard in the list — it'll be tagged Custom (usually under Not connected).
  3. Click Connect.
  4. Claude opens your browser — log in with your Switchboard account and approve.
  5. The connector shows Connected.
  6. 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:

  1. 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.
  2. Add a switchboard entry (merge into mcpServers if it already exists):
{
  "mcpServers": {
    "switchboard": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.switchboard.build/mcp"]
    }
  }
}
  1. Save, then fully quit and reopen Claude Desktop.
  2. A browser window opens for the Switchboard sign-in — log in and approve.
  3. switchboard now 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 workspaceget_models
Describe one model's columns, aggregations, and relationshipsget_model_details
List your connected data sourceslist_sources
Show a source's tables and sync stateget_source_details
Show recent build runslist_build_runs
Show one build run's status and any errorsget_build_run
Query against your dataexecute_sql

On this page