Connect Claude Desktop with an API key
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
- After creating your key, open the Claude Desktop tab in CRMCoPilot and copy the message shown there. It already has your key in it.
- Paste it into a Claude Desktop chat and let Claude make the change.
- Quit Claude Desktop completely (not just close the window) and open it again.
Or edit the config file yourself
- 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.
- Mac:
- 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" } } } } - On Windows, if it doesn’t start, use
"command": "cmd"and put"/c", "npx",at the start ofargs. - Save, quit Claude Desktop completely and reopen it.
Then ask: “Use CRM CoPilot to show my hot leads from this week.”