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.
claude mcp add --scope user switchboard -- cmd /c npx -y @switchboard-host/cli@latest mcpclaude mcp add --scope user switchboard -- npx -y @switchboard-host/cli@latest mcpclaude mcp add --scope user switchboard -- npx -y @switchboard-host/cli@latest mcpThen 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):
{
"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:
[mcp_servers.switchboard]
command = "npx"
args = ["-y", "@switchboard-host/cli@latest", "mcp"]