MCP connector troubleshooting and FAQ
Error messages
| Message | What to do |
|---|---|
| “AI agent access isn’t available on this account yet” or “AI agent access is included in the Gold plan and up” | Your plan doesn’t include it. AI agent access is on Gold, Platinum and Managed. |
| “Send your CRM CoPilot API key as ‘Authorization: Bearer cpk_…'” | The app isn’t sending a key. Check the header in your config, or connect with sign-in. |
| “This API key is invalid or turned off” | The key or connected app was disabled or deleted, or the key was copied wrong. Check Settings → API Tokens. |
| “This API key has expired” | Create a new key and update your app. |
| “This key was made for Custom Opportunities only” | The key was created without the AI assistants box ticked. Create a new key with it ticked. |
| “This key can’t spend credits”, “This key or connection is read-only” or “This key can’t read … dismissing agent findings” | The key or connection is read-only, and the request needs Also allow it to take actions. Create a new key with it ticked, or reconnect the app and tick it on the consent screen. |
| “This key may spend N credits a day; … are used today” | The daily limit is reached. Wait until midnight UTC, or create a key with a higher limit. |
| “Unlocking N people can cost up to X credits, more than max_credits” | Working as designed: the assistant must ask you, then retry with the higher cap. |
| “This account has used its 200 searches for today” | The account’s daily search limit is reached. It resets at midnight UTC. |
| “Rate limit: 60 requests per minute per key” | Wait a moment and try again. |
| “Send the key in the Authorization header, never in the URL” | Move the key from the URL into the header. |
| “Connect a mailbox (Gmail or Outlook) in CRM CoPilot first” | Connect a mailbox in Settings before adding people to a sequence. |
| “That CRM isn’t connected to this account” | Connect the CRM in Settings → Integrations. |
| “This app isn’t registered. Remove the connector and add it again.” | Remove CRM CoPilot from the app’s connectors (in ChatGPT, the custom plugin) and add it again. |
| “This connection was turned off. Connect the app again.” | The connected app was disabled or deleted. Enable it in Settings, or connect again. |
Connection problems
- Claude or ChatGPT answers by searching the web: check CRM CoPilot is switched on in the chat’s tools menu, and start your request with “Use CRM CoPilot to…”.
- It couldn’t connect after you clicked Allow: try again in a private window to rule out a browser extension, and allow pop-ups for CRMCoPilot.
- Claude shows CRM CoPilot twice: you connected it two ways (for example claude.ai and the config file). Keep one, restart Claude, and delete the unused key in Settings → API Tokens.
- Added in a terminal, but Claude Desktop doesn’t see it: Claude Code and Claude Desktop have separate settings. Set up each one with its own steps.
- Claude Code shows it in only one folder: it was added without
--scope user. Runclaude mcp remove crm-copilot, then add it again. - A search ignored part of what you asked: check how the search was understood in the answer, then rephrase with the missing part, such as “in the software industry”.
- Claude Desktop doesn’t show CRM CoPilot: quit Claude completely and reopen it. Check that Node.js is installed and the config file is valid JSON. Or switch to sign-in.
- Claude Code: run
claude mcp list; it should showcrm-copilot … ✔ Connected. If it says it needs authentication, type/mcpand choose Authenticate. - The sign-in window says the app can’t connect: remove the connector (or ChatGPT plugin), add it again with the exact URL, and sign in again.
- An approval link says nothing is waiting: the request may have expired (after 24 hours) or been decided already. Check the History tab.
FAQ
Will it unlock emails or spend credits without asking?
Only a key or connection allowed to act can spend credits, and never more than its daily limit. The assistant is told to state the cost and ask first, and every unlock carries a credit cap. Bigger actions, like sending to your CRM, always wait for your approval.
Can it send emails?
No. It can add people to a sequence once you approve, and the sequence then sends as usual.
Does the connector cost anything?
Connecting is free on Gold, Platinum and Managed. You spend credits only on decision makers, company searches, email unlocks and the actions you approve.
Can my team use it?
Yes. Each team member connects with their own sign-in or key, and sees only what their own account can see.