Skip to content
MCP Bridge Docs

Quick Start

Use this path when you want a working setup in a few minutes.

1) Install

Section titled “1) Install”
Terminal window
npm install -g @aiwerk/mcp-bridge

2) Initialize local config

Section titled “2) Initialize local config”
Terminal window
mcp-bridge init

This creates:

  • ~/.mcp-bridge/config.json
  • ~/.mcp-bridge/.env (chmod 600)

3) Install a server recipe

Section titled “3) Install a server recipe”
Terminal window
mcp-bridge install todoist

4) Add credentials

Section titled “4) Add credentials”
Terminal window
echo "TODOIST_API_TOKEN=your-token" >> ~/.mcp-bridge/.env

5) Start the bridge (default stdio)

Section titled “5) Start the bridge (default stdio)”
Terminal window
mcp-bridge

6) Connect from a client

Section titled “6) Connect from a client”

Use mcp-bridge as your MCP command in Claude Desktop, Cursor, Windsurf, Cline, or OpenClaw.

{
  "mcpServers": {
    "bridge": {
      "command": "mcp-bridge",
      "args": []
    }
  }
}

Next: Installation details and Server configuration.