MCP relay so Claude Code agents on different machines can exchange messages via named channels.
MCP relay so Claude Code agents on different machines can exchange messages via named channels.
Claude Code's native Agent Teams coordinate multiple instances on the same machine. Claude Bridge fills the gap — it lets Claude Code agents on different machines communicate in real time over a shared MCP relay server.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
bridge_send — Send a message to a named channelbridge_receive — Read messages — pass since_id for incremental pollingbridge_channels — List all active channels and message countsbridge_ping — Health check + server statsbridge_clear — Clear all messages from a channelbridge_status — Cross-channel overview with recent messagesmcp, starlette, uvicorn, anyio, sse-starlette (declared in pyproject.toml; installed automatically by pip install claude-bridge) - A reachable network path between machines — localhost, LAN, Tailscale, or any other route (see Networking) ---Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| bridge_send | Send a message to a named channel |
| bridge_receive | Read messages — pass since_id for incremental polling |
| bridge_channels | List all active channels and message counts |
| bridge_ping | Health check + server stats |
| bridge_clear | Clear all messages from a channel |
| bridge_status | Cross-channel overview with recent messages |
{
"mcpServers": {
"claude-code-bridge": {
"command": "uvx",
"args": ["claude-code-bridge"],
"env": {
"CLAUDE_BRIDGE_AUTH_TOKEN": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
mcp, starlette, uvicorn, anyio, sse-starlette (declared in pyproject.toml; installed automatically by pip install claude-bridge) - A reachable network path between machines — localhost, LAN, Tailscale, or any other route (see Networking) ---| Variable | Description | Required |
|---|---|---|
| CLAUDE_BRIDGE_AUTH_TOKEN | Credential the server authenticates with. | Yes |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
Connect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.