Quickstart

Get AllMCP connected to your AI clients in under 90 seconds.

Tip

~90 seconds. Run npx allmcp — it signs you in from the browser, detects your AI clients, and connects them. No API key to copy, no config to edit.

Sign up Log in Browse providers

---

1. Run the one-command setup

   In any terminal (Node.js 18.17+):

   npx allmcp

   The interactive setup walks you through everything:

   1. Sign in — your browser opens for a 5-second OAuth sign-in (Google or GitHub). No API key needed.
   2. Pick your clients — Claude Desktop, Claude Code, Codex, Cursor, and ChatGPT are auto-detected and preselected.
   3. Review the plan — it shows exactly what it will write before touching anything, backs existing configs up to .bak, and never removes your other MCP servers.
   4. Verify — it makes a first call to your endpoint and confirms your providers are live.
   Scripting, CI, or prefer an API key?

   Grab a key at allmcp.co/login (it looks like allmcp_xxxxxxxxxxxxxxxxxxxxxxxx) and use the non-interactive form:

   npx allmcp install claude-desktop --key YOUR_API_KEY

   The key can also come from the ALLMCP_KEY environment variable. allmcp login, allmcp status, and allmcp doctor cover sign-in, connection health, and troubleshooting from the terminal.

2. Or set up one client at a time

   Claude Desktop

   Run one command in a terminal — keyless by default (Claude Desktop signs you in from the browser on first launch):

   npx allmcp install claude-desktop

   It backs your existing config up to claude_desktop_config.json.bak and merges AllMCP in without touching your other servers. Then fully quit and reopen Claude Desktop.

   Need Node? → nodejs.org (Claude Desktop needs it to reach remote servers anyway).

   Prefer to edit the config by hand?

   Open the config file:

   • Windows: C:\Users\<your-username>\AppData\Roaming\Claude\claude_desktop_config.json (same as %APPDATA%\Claude\…)
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   Add the allmcp entry (Claude Desktop reaches remote servers through the mcp-remote bridge, so Node.js must be installed). Keyless — the sign-in happens in your browser on first launch:

   {
     "mcpServers": {
       "allmcp": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://go.allmcp.co/mcp/"]
       }
     }
   }

   Or pin an API key instead of OAuth:

   {
     "mcpServers": {
       "allmcp": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://go.allmcp.co/mcp/", "--header", "X-API-Key:${ALLMCP_API_KEY}"],
         "env": {
           "ALLMCP_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }

   Save the file and fully quit and reopen Claude Desktop.

   Cursor

   Run one command in a terminal — keyless by default (Cursor runs the OAuth sign-in itself):

   npx allmcp install cursor

   It backs up ~/.cursor/mcp.json to mcp.json.bak and merges AllMCP in alongside your other servers. Then reload the Cursor window (Ctrl+Shift+P → “Developer: Reload Window”).

   Prefer to edit the config by hand?

   Create or edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project. Cursor indexes tools once, so use the full-catalog URL:

   {
     "mcpServers": {
       "allmcp": {
         "url": "https://go.allmcp.co/mcp/?full_catalog=true"
       }
     }
   }

   Or pin an API key instead of OAuth:

   {
     "mcpServers": {
       "allmcp": {
         "url": "https://go.allmcp.co/mcp/?full_catalog=true",
         "headers": {
           "X-API-Key": "YOUR_API_KEY"
         }
       }
     }
   }

   Reload the Cursor window (Ctrl+Shift+P → “Developer: Reload Window”).

   Windsurf

   Open Windsurf Settings → MCP Servers → Add Server and fill in:

   • URL: https://go.allmcp.co/mcp/
   • Header name: X-API-Key
   • Header value: YOUR_API_KEY

   Or edit ~/.codeium/windsurf/mcp_config.json directly:

   mcp_config.json

   {
     "mcpServers": {
       "allmcp": {
         "serverUrl": "https://go.allmcp.co/mcp/",
         "headers": {
           "X-API-Key": "YOUR_API_KEY"
         }
       }
     }
   }

   Windsurf uses serverUrl for remote servers — not url.

   VS Code

   Using a different client? See the dedicated setup pages for VS Code and OpenAI Codex.

   Connect a client
   OpenAI Codex

   Using a different client? See the dedicated setup pages for VS Code and OpenAI Codex.

   Connect a client

3. Verify the connection

   Open a new conversation and type:

   List the available integrations

   Your agent will return a catalog of everything AllMCP supports, along with the connection status for each provider.

4. Connect your first provider

   Bitrix24 (API key)

   Connect my Bitrix24. The webhook URL is https://portal.bitrix24.ru/rest/1/abc123secret/

   Google Sheets (OAuth)

   Connect Google Sheets

   For OAuth providers like Google Sheets, your agent will hand back a consent link. Open it in your browser, grant access, and you’re connected. AllMCP handles the consent screen and keeps your access refreshed for you, so you won’t have to sign in again.

Caution

Something not working?

No tools showing up

Make sure you restarted (or reloaded) your MCP client after editing the config, and that the url is exactly https://go.allmcp.co/mcp/.

401 Unauthorized

Check that the X-API-Key header is present and that YOUR_API_KEY was replaced with your real key (it starts with allmcp_).

OAuth provider won’t connect

For OAuth providers like Google Sheets, your agent hands back a consent link. Open it in your browser and grant access, then ask your agent to try the provider again.

---

What’s next

All providers Browse every connected provider.

Connect from a framework LangChain, CrewAI, PydanticAI, LlamaIndex, and more.

Multi-tenancy Serve many users from one key with per-user connections.