Connect Claude Desktop with an API key

Updated November 22, 2026

Applies to Claude

The simplest way is sign-in: add CRM CoPilot as a custom connector and it works in Claude Desktop too. See Connect Claude with sign-in. Use the steps below if your Claude plan doesn’t allow custom connectors or you prefer an API key.

Before you start

  • Create an API key with AI agent access.
  • Install Node.js (the LTS version). Claude Desktop uses it to run the small bridge (mcp-remote) that connects to CRMCoPilot.

Easiest: let Claude set it up

  1. After creating your key, open the Claude Desktop tab in CRMCoPilot and copy the message shown there. It already has your key in it.
  2. Paste it into a Claude Desktop chat and let Claude make the change.
  3. Quit Claude Desktop completely (not just close the window) and open it again.

Or edit the config file yourself

  1. Open claude_desktop_config.json:
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json (the Microsoft Store version keeps it under its own app folder)
    • Or in Claude: ☰ → Help → Troubleshooting → Enable Developer Mode, then Settings → Developer → Edit Config.
  2. Paste this, with your key in place of cpk_YOUR_KEY. If the file already lists other servers, add only the "crm-copilot" part inside "mcpServers".
    {
      "mcpServers": {
        "crm-copilot": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://production.crmcopilot.ai/api/agent/v1/mcp",
                   "--header", "Authorization:${AUTH_HEADER}"],
          "env": { "AUTH_HEADER": "Bearer cpk_YOUR_KEY" }
        }
      }
    }
  3. On Windows, if it doesn’t start, use "command": "cmd" and put "/c", "npx", at the start of args.
  4. Save, quit Claude Desktop completely and reopen it.

Then ask: “Use CRM CoPilot to show my hot leads from this week.”

Shopping cart