Skip to content

MCP connection

Let your AI tool talk to Switchboard directly through MCP.

MCP (Model Context Protocol) is a way to give your AI tool extra tools. With the Switchboard MCP your AI can check your website's status, read the logs, change settings and publish by itself, without typing a terminal command each time.

It's optional: everything works without MCP too, through the commands. But your AI is sometimes a bit handier with it.

#Adding it to Claude Code

Paste this command in your terminal (not inside Claude itself). It doesn't matter which folder your terminal is in: thanks to --scope user the connection works for all your websites.

PowerShell
claude mcp add --scope user switchboard -- cmd /c npx -y @switchboard-host/cli@latest mcp

Then restart Claude. Type /mcp in Claude to check that switchboard is in the list.

Is switchboard missing? Then the connection was probably added without --scope user and only works in the folder where you ran the command back then. Run the command above once more (exactly as shown) and restart Claude.

#What your AI can do with it

Tool What it does
list_apps List your websites.
app_status Check a website's status.
deploy Publish your changes.
deployment_status See how publishing is going.
deployment_log Read the build log (handy when something fails).
app_logs Read your live website's logs.
env_list List your settings (secrets stay secret).
env_set Save a setting.
env_unset Remove a setting.
domains_list Your domain names and whether they work.
restart Restart your website.

Your AI decides when to use which tool. You can also ask: "Use Switchboard to check the logs of my live website."

#Other AI tools

Most tools use a settings file in JSON. Add this (your tool's documentation says exactly where, for example .cursor/mcp.json for Cursor or ~/.gemini/settings.json for Gemini CLI):

mcp.json
{
	"mcpServers": {
		"switchboard": {
			"command": "npx",
			"args": ["-y", "@switchboard-host/cli@latest", "mcp"]
		}
	}
}

On Windows npx sometimes doesn't work directly. Then use "command": "cmd" and "args": ["/c", "npx", "-y", "@switchboard-host/cli@latest", "mcp"].

Codex CLI uses a TOML file, ~/.codex/config.toml:

config.toml
[mcp_servers.switchboard]
command = "npx"
args = ["-y", "@switchboard-host/cli@latest", "mcp"]

Was this helpful?

Guide

Search the guide

Type a word or a question. Tip: press Ctrl K to open this anywhere.