Connect Claude (MCP)

Connect Claude to Switchboard so you can explore your data in a Claude conversation — or vibe code any dashboard you want in Replit, Claude artifacts, and more.

Connect Claude to Switchboard and explore your data directly in a Claude conversation — or vibe code any dashboard you want in Replit, Claude artifacts, or any other tool that speaks MCP. List your models, check sync states, and query your data without leaving the chat.

Every setup path below uses the same connector URL:

https://api.switchboard.build/mcp

How it works

Switchboard connects to Claude as a custom connector. On a Team or Enterprise workspace, setup has two halves: a workspace Owner enables Switchboard once for everyone, then each person connects their own account in a couple of clicks. Individual members can't add a custom connector themselves.

Pick your path:

I'm a workspace Owner

Enable Switchboard for the team once, then connect your own account.

Preferred

I'm a team member

An Owner has already enabled Switchboard — just connect your account.

Preferred

No admin available

Set it up for yourself with a small local helper. No workspace changes needed.

Possible, not preferred

Enable it for your team (Owner)

Only a workspace Owner or Primary Owner can do this, and only once. It happens 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 Add, hover over Custom, then choose Web.

Enter the connector details, and leave the advanced OAuth fields blank:

Name: Switchboard
Remote MCP server URL: https://api.switchboard.build/mcp

Click Add. Switchboard is now available to the whole workspace.

Enabling the connector does not grant anyone data access on its own — each person still connects and signs in with their own Switchboard account.

Redirected to Customize instead?

If claude.ai/admin-settings/connectors redirects you to Customize, your account isn't the workspace's Primary Owner, or custom connectors aren't enabled for your plan. Confirm who the Primary Owner is, or contact Anthropic support. Anyone who needs access before then can use the fallback.

Connect your account

Once an Owner has enabled Switchboard for the workspace:

Open Claude Desktop or claude.ai, then go to Customize → Connectors.

Find Switchboard in the list — it's tagged Custom, usually under Not connected — and click Connect.

Claude opens your browser. Log in with your Switchboard account and approve.

Back in Claude, the connector shows Connected. In a chat, open the connectors menu in the message box and make sure Switchboard is toggled on.

Fallback: per-user setup

Use this only if your workspace hasn't enabled the Switchboard connector and you need it working now. It runs mcp-remote, an open-source bridge, on your own machine — so it doesn't depend on workspace settings. You'll need Node.js installed (it provides npx).

Open Claude Desktop's config file — via Settings → Developer → Edit Config, or directly:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add a switchboard entry (merge it into mcpServers if that key 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. 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. A few more prompts to 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?

Permissions

The connection acts as you. A connected user inherits the same permissions they have within Switchboard — Claude can only see and query what your Switchboard account can, and nothing more. Roles, groups, and document shares apply to the connection the same way they do in the app.

What Claude can do

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`