AI Connections (MCP)
Troubleshooting AI Connections
Fix common problems with connecting ChatGPT or Claude to BaTimo: adding it, access errors, deletes, images, connecting channels and WhatsApp messages.
The connector cannot be added
- ChatGPT says "Couldn't add plugin. Try again.": upload the file from the ChatGPT card in Settings > AI Connections exactly as downloaded. Don't unzip and re-zip it, and don't use the Claude file in ChatGPT. Download it again if in doubt.
- ChatGPT has no Add or upload option on the Plugins page: your account or workspace doesn't allow plugin uploads. Add BaTimo by its server address instead (see below).
- Claude rejects the uploaded file: use the file from the Claude card, unchanged. On Team and Enterprise plans an Owner may have turned off plugin uploads; ask them, or add BaTimo as a custom connector.
- The uploaded plugin is added but BaTimo doesn't work in chat: connect it. In ChatGPT, connect BaTimo when asked; in Claude, open the plugin's Connectors tab, add BaTimo and select Connect, then approve the connection in BaTimo.
- ChatGPT has no "Add custom MCP server" option: custom servers need developer mode. On Business, Enterprise and Edu workspaces ask your admin to turn it on (in the workspace's permissions and roles settings). Personal plans may not offer it, or may only allow reading. Use the ChatGPT website to add it.
- Claude has no "Add custom connector" option: on Team and Enterprise plans only an Owner can add it under Organization settings > Connectors; members then select Connect. The Free plan allows one custom connector, so remove another one first.
- Claude cannot sign in to BaTimo after adding it: check the OAuth client choice. BaTimo needs Register automatically (leave client ID and secret empty) and does not support Use Claude's published identity. Authentication settings cannot be edited, so remove BaTimo and add it again.
- Claude Code says it needs authentication: type
/mcp, choose BaTimo and sign in in your browser. - Cursor does not show BaTimo: check that the file is saved as
~/.cursor/mcp.jsonor.cursor/mcp.json. If you copied BaTimo into a file you already had, make sure the file still has only one list of servers and no missing commas or brackets. - "Server not found" or 404 on the BaTimo address: AI Connections are unavailable right now (the AI Connections page says so), or the address is wrong. Copy it again with Copy URL in Settings > AI Connections, and contact BaTimo support if it persists.
- Sign-in loops or "not authorized": sign in to the correct BaTimo account. The connector requires choosing a company on the consent screen.
- "Missing or invalid connection request" or "request not found or expired": the approval link is valid for about 10 minutes. Start the connection again from the AI app.
Something is missing or out of date
Ask your AI app to refresh or reconnect BaTimo. After a refresh, everything BaTimo offers should appear. A connection added before October 2026 may still show the old name BaTimo Business Workspace; it keeps working.
Error messages from BaTimo
Your AI app may pass on these messages from BaTimo:
| Message | Meaning and fix |
|---|---|
| "This connection only has read access; management scope is required" | The connection can only read. Reconnect and approve Management access. |
| "The granting user does not have access to the "conversations" module" (or another area) | The person who approved the connection lacks that permission. Ask an owner to grant it, or connect as an owner. |
| "This connection has no active company grant" | The connection was revoked or never completed. Reconnect. |
| "The granting user no longer has access to this company" | The person who approved it was removed from the company. Reconnect with a current team member. |
| Plan limit errors (for example the automation limit) | Same limits as the Console. See Plans. |
| "Confirmation required" | BaTimo is waiting for your approval to delete something. Tell the AI to go ahead. |
| "... was not found in this company's media library" or "... cannot be used as ..." | The image belongs to another company or was added for a different use (for example a product image used as a website chat logo). Ask the AI to add the image again for the right use. |
| "This URL is not allowed" | Images can only be copied from public web addresses that start with https://. Use a public link to the image. |
| "Unsupported file type" or "larger than the ... limit" | Only JPEG, PNG, GIF and WebP images within the size limit are accepted (launcher icon: PNG or GIF, 1 MB). |
| "Too many media uploads" | Up to 30 images per hour and 100 per day per company. Wait, or ask the AI to reuse an image it already added. |
| "The BaTimo Help Center is temporarily unavailable" | The AI couldn't reach this Help Center. Try again later or open it in your browser. |
WhatsApp messaging problems
| Message or reason | Meaning and fix |
|---|---|
| "Outreach is limited to non-promotional messages" | Tell the AI one of the allowed purposes: appointment reminder, requested follow-up, service notification or order update. |
| Consent missing | BaTimo couldn't verify that the person agreed. Confirm they agreed and tell the AI how and when. |
| Opted out | The person replied STOP. They can't be contacted again unless they reply START. |
| Contacted recently, or 30-day limit reached | The number was contacted in the last 7 days, or 3 times in 30 days. |
| "Daily outreach limit reached" or "campaign limit reached" | Company limits: 50 people per 24 hours, 150 per week, 5 batches per day. |
| "Too many outreach requests" | More than 10 send or schedule requests in an hour. Wait for the time shown. |
| "A campaign can have at most 25 recipients" | Split the list into several batches and days. |
| "Outreach on this WhatsApp channel is halted" | BaTimo stopped sending after repeated failures, many numbers not on WhatsApp, or the WhatsApp connection ending. Check the number, then ask the AI to resume and confirm you checked. |
| The AI isn't sure whether the request went through | Ask it to check the batch status before trying again. |
| Uncertain | Check the conversation before sending again; BaTimo doesn't resend by itself. |
More detail: Send WhatsApp follow-ups with your AI.
A channel does not connect
The AI can't sign in to Instagram or WhatsApp for you. Open the link it gives you, finish signing in on that Console page, then ask the AI to check again. If the channel is on but not connected, it receives no messages; BaTimo's setup check reports this when you ask the AI to check your setup.
Revoke and start over
Open Settings > AI Connections > Connected Apps, choose Revoke, remove the connector in the AI app, then add it again.
Still stuck?
Open Settings > Support in the sidebar and include the connector name, time of the error and the message you saw.
Last updated on
WhatsApp outreach: consent, restrictions and safeguards
What WhatsApp's rules require, which safeguards BaTimo enforces, what you must still do yourself, and why the risk cannot be removed.
Connect Google Calendar or Microsoft Outlook
Connect your calendar to sync appointments and prevent double bookings, and manage or disconnect connections.