Troubleshooting

The connector doesn't show up in the chat

• Claude: start a new chat, click +, open Connectors and turn the connector on.
• ChatGPT: in each new chat, choose Developer mode from the + menu and select the app.
• Claude Code: type /mcp, select the server and click Authenticate.
• Gemini CLI: run /mcp auth <server-name>, for example /mcp auth google-ads-mcp.
• Check that you pasted the exact URL from MCP Servers, for example https://google-ads.insightfulmcp.com/.

Authorization problems

• If the authorization page says "You need access to at least one account to authorize this application", connect an account for that platform first, or ask a workspace admin to grant you access to one.
• If sign-in fails or never finishes, remove the server from your client, add it again, and click Authorize access in the browser.

A connection stopped working

The Connectors page shows a status such as Expired or Reconnect required, for example after a password change or revoked access on the platform. Click Reconnect now and sign in to the platform again.

Error messages from the agent

"This action is disabled for this connected account. An owner or admin must enable it for the account."

An owner, administrator or operator can turn the action on with Configure actions for this account on that connection. Destructive actions are off by default.

"This account is connected read-only, so this action cannot be enabled for it. An owner or admin must reconnect it with Read & Write permissions."

Reconnect the account and choose Read + Write under Permissions.

"Your role does not have permission to execute write actions. Only operators, admins, and owners can execute write operations."

Members with the User role can only run read actions. Ask a workspace admin to change your role if you need writes.

"You do not have access to this account. Contact your workspace admin to grant access."

Members with the User role only see accounts granted to them. An owner or administrator can grant access on the member's Manage Account Access page.

"You do not have permission to run this action on this account. Contact your workspace admin."

Members with the User role can run the enabled read actions on accounts granted to them, but not writes.

Wrong or missing account

• The agent only sees accounts connected in the current workspace. If you manage several accounts on one platform, ask the agent to list your accounts first, then name the one you mean.
• To reassign a connection, use Move to brand on the Connectors page instead of reconnecting.

Rate limits

Platform APIs limit how many requests you can make. When a limit is hit, wait and retry, or ask for fewer rows or a shorter date range. Google Ads quota errors include a suggested wait time.

Trial ended

When a trial ends without an active subscription, agent requests return an error until the workspace owner subscribes. See Trial and Plans.

Still stuck?

Email [email protected] with your AI client, the server URL and the exact error text. See also First Connection.