Troubleshooting
Look up the error or message you got, a Google code or AdCopilot's own words, and get the one-line fix, who does it and the full steps. Support is here too.
Sent here by your assistant? Find the words it quoted under Find your error, or what is going wrong under Find your symptom. Each row gives the fix in one line and who does it; the link has the full steps. Rows marked Assistant need nothing from you. AI assistants: read For AI assistants as well.
Who: Assistant, the AI fixes its own call; You, the person using AdCopilot; Owner, the workspace owner; Wait, Google is busy or a limit was reached. "Owner, then You": the owner first. "You, or Owner": either.
Find your error
Search this page for the code in capitals or the message's first words.
Google's errors come in Google's words, for example
Google Ads rejected the query: query_error UNRECOGNIZED_FIELD: …. Below, …
stands for a name or a number.
Google access and accounts
| What you see | Who | Fix |
|---|---|---|
USER_PERMISSION_DENIED (Google may mention a login-customer-id header) | You | The Google login your assistant uses (the Google Ads card on Google products names it) can't open that account. Give that login access in Google Ads, or connect the login that has it. Refresh accounts alone won't help. |
CUSTOMER_NOT_ENABLED | You, or Owner | The account isn't active yet, or was cancelled. Finish setting it up in Google Ads, or an owner switches it Off under Ad accounts. Reconnecting won't help. |
NOT_ADS_USER | You | That Google login has no Google Ads account. Connect the login that has one. |
REQUESTED_METRICS_FOR_MANAGER | Owner | A manager (MCC) account is switched on. Switch on a client account under it, and the manager off. |
| "AdCopilot hasn't found account …" | You, then Owner | Give one of the workspace's Google logins access to it in Google Ads; then the owner presses Refresh accounts. |
| "… switched on for this workspace but not shared with you" | Owner | Ask the workspace owner to have it shared with you. Nothing changes in Google Ads. |
| "AdCopilot could not read the account just now" | Assistant | A first read failed. Never guess numbers; follow the fallback reads and look up any read's error here. |
| Search Console: "User does not have sufficient permission for site" | Assistant, then You | Use the site exactly as gsc_list_sites lists it. Not listed: the connected login has no access to it. |
Analytics or Tag Manager: HttpError 403 PERMISSION_DENIED | Assistant, then You | Use the ids the list tools return. Missing: the connected login has no access in that product. |
| "Google is no longer accepting this connector's sign-in" | You | Open the reconnect link in the message or the email, and sign in to Google again. |
"Google would not renew AdCopilot's access to …" (Google said: invalid_scope …) | You | Open the link in the message, or press Reconnect … on that product's card in Google products. |
| "Google's sign-in service could not renew AdCopilot's access to … just now" | Wait | Google's side. Ask again in a few minutes; reconnecting won't help. |
| "… isn't connected to this workspace yet" | You | Open the link in the message, or press that product's Connect … button. Nothing to do in your AI app. |
| "… is connected in this workspace through a teammate's Google login, not yours" | You | Connect it with your own Google login on Google products. |
| "… is connected read-only, so I can't make changes there" | You | Open the link in the message, or press Enable editing on its card. |
| "… is not available through this connector's current authorisation" | You | Connect your AI → Revoke the app, or remove and re-add AdCopilot in your AI app. |
| "Account … is switched off for this workspace" | Owner | Switch it On under Ad accounts, or swap it with the one that is on. |
| "… is not recorded as having access to it" or "… had access to no Google Ads account" | You | Your login can't open it; nothing was sent. Get it access in Google Ads, then ask again in ten minutes, or the owner presses Refresh accounts. |
| "… AdCopilot has not yet checked which Google Ads accounts …" | Owner, then You | Nothing was sent. The owner presses Refresh accounts; still refused, your login needs access in Google Ads. |
Connecting and signing in
| What you see | Who | Fix |
|---|---|---|
| Approve on "Let Cursor use your AdCopilot?" does nothing | You | Fixed: remove AdCopilot in Cursor, add it again, and press Approve once. |
| "That connection request isn't valid" | You | Start the connection again from inside your AI app, and finish in the browser it opens. |
| "Finish in the browser you started in" | You | Go back to the browser your assistant opened, or start connecting again from the assistant. |
| "Sign in again in this browser" | You | Press Sign in again. |
| Every product "isn't connected", though the dashboard shows it connected | You | The assistant was approved for another workspace. Revoke it and approve the right one. |
| Email "AdCopilot disconnected … as a precaution" | You | Reconnect AdCopilot in that assistant. |
unauthorized, or "refresh token is invalid or already used" | You | Reconnect AdCopilot in your AI app and approve it again. |
| "invalid or inactive access URL" | Owner | You were paused or removed, or the workspace was switched off. Ask the owner: a seat added, or a paid plan that holds everyone, brings a paused person back. |
| "this trial connector has expired" | Owner | Choose a plan on the Billing page. |
| "This connector URL has been retired" | You | Add AdCopilot again with https://mcp.adcopilot.cloud/mcp. |
invalid_redirect_uri, invalid_request or access_denied while signing in | You | access_denied: you pressed Cancel; start again. The others: the client can't use AdCopilot's sign-in. |
| The client asks for an API key | You | There is none. Choose the client's OAuth sign-in. |
| "… available but not in this connection's tool list" | You | Reconnect AdCopilot in your AI app with the steps in the message. |
| "… tool descriptions changed after this connection's tool list was loaded" | Assistant | Call get_org_context with tools=[…] for the current text. |
Limits, busy and slow
Budget checks and refused changes
| What you see | Who | Fix |
|---|---|---|
| "Nothing about this business is saved for this workspace yet, so I won't build …" | You | Say what you sell, where your customers are and the daily amount you're comfortable with. |
| "No comfortable daily budget is saved …" | You | Say your daily number. AdCopilot saves it; ask again. |
| "… above the comfortable daily budget on file … a heads-up, not a block" | You | A warning: the change went through. |
| "… above the monthly cap of … on file" | You | Raise the cap, pick a smaller daily budget, or pause another campaign. |
| "I can't read the monthly cap on file …" | You | Say the monthly cap you want. |
| "I couldn't read this campaign's daily budget from Google Ads just now" | Wait | Nothing changed. Try again in a minute. |
| "Maximize Clicks with no per-click cap …" | You | Say the most you'll pay for one click. |
| "I can't read the daily budget on this request as a plain number" (or "the per-click cap") | You | Say the amount again as a plain number. |
| "This is the campaign we built together — switching it on is yours to do in Google Ads" | You | By design. Switch it on yourself in Google Ads. |
POLICY_ERROR or a policy finding | You | Google refused the text under the policy it names. Reword it; AdCopilot can't ask Google for an exception. |
RESOURCE_LIMIT | You | The account is at a Google limit for that kind of item. Reuse one, or remove one in Google Ads (AdCopilot can't); pausing often doesn't make room. |
| "Tool '…' is not enabled for this subscription tier." | Owner | A viewer, or a read-only workspace, can't make changes. |
| "Your subscription is inactive" | Owner | Reactivate on the Billing page. |
Errors your assistant fixes
| What you see | Who | Fix |
|---|---|---|
UNRECOGNIZED_FIELD | Assistant | A field name is wrong. Call get_resource_metadata for that resource, use a listed field, run once more. |
EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE | Assistant | A field in orderings, or a segment (other than the date) in conditions, must also be in fields. Add it, run once more. |
PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE, other PROHIBITED_… | Assistant | That metric or segment can't be read with that resource. Drop it, or query a resource that has it. |
METRIC_ACCESS_DENIED | Assistant | This account can't read that metric. Drop it, run once more. |
START_DATE_TOO_OLD | Assistant | Change history goes back 30 days (change_event) or 90 (change_status). Use a later start_date. |
| "… does not take the parameter …, so nothing was run" | Assistant | Call again with the parameter names the message lists. Never add a manager account ID. |
| "image_source must be an http:// or https:// address …" | Assistant | Pass the image's web address, or the image itself as a data: URI. |
| Analytics: "Selected dimensions and metrics cannot be queried together" | Assistant | Change the dimension and metric mix (ga4_get_metadata lists them), run once more. |
TOO_LONG | Assistant | A text is over Google's length limit. Shorten the field Google names and show the user the new text. |
CONCURRENT_MODIFICATION | Assistant | Something changed the same item at the same moment. Read it again, then try once more. |
| "Setting status to REMOVED …" | Assistant | AdCopilot cannot delete. Pause it instead. |
Any other "Google Ads rejected the query", or a raw GoogleAdsException | Assistant | Read Google's code and message, fix the call, run once more. Fails again: tell the user Google's message. |
Reasons in the Tool calls list
A refused call in the dashboard's Tool calls list, on Usage, shows a short reason:
| Reason | What it means |
|---|---|
cap_daily | Daily operations used. |
cap_accounts | More accounts switched on than the plan includes. |
trial_paused | A trial paused at 1,000 operations, its Free day used. |
build gate, budget fence, first campaign | A budget check refused a change. Normal while you set up. |
product not connected, product read-only, token scope | A Google product is not connected, is read-only, or is not covered by the assistant's approval. |
account out of scope, account not on your login | Switched off, never found in this workspace, or not on your own Google login. |
account out of scope: switched off | Switched off. |
account out of scope: not discovered | Never found through the workspace's Google logins. |
account out of scope: not shared | Not shared with that person. |
unknown argument, unknown argument: …, image_source not a URL, status sent to update_campaign, retired field name | The assistant used a wrong parameter, tool or field name. Nothing for you to do. |
build status not PAUSED | The assistant asked to build a campaign switched on. Every campaign is built paused; switch it on in Google Ads. |
scheduled run | A scheduled run asked for a change; it makes none. Ask for it in a new chat. |
google grant rejected | Google stopped accepting the sign-in. |
tier | A viewer or a read-only workspace tried a change. |
suspended | The subscription is inactive. |
google ops ceiling, GoogleOpsRefused, GoogleAdsBusy, ResourceExhausted, InternalServerError, ServiceUnavailable, KeywordPlanning… | Google is busy or failing, or a shared limit was reached. Nothing to fix in your account. |
ToolError: RefreshError …, google sign-in renewal failed | Google would not renew access to that product. |
ToolError: and a Google code or HttpError … | Google refused the call. Look the code up above. |
Find your symptom
- Connecting fails.
- Claude: the plugin is added but Claude can't reach AdCopilot, no AdCopilot page to approve, it asks permission before every report, Chrome's autofill covers the URL box, no Customize in the sidebar, a Team or Enterprise organisation.
- ChatGPT: you can't find or install the plugin, "Disabled by admin", the sign-in was interrupted, it searches the web instead, it asks for approval before every report, it reads but will not change anything.
- Cursor, VS Code, Copilot Studio, Antigravity, Claude Code, Gemini CLI and other clients: Connecting Cursor and other clients.
- An error on AdCopilot's approval page: Approval page and connection errors.
- Approve does nothing. See Approve does nothing.
- Tools are missing or out of date. See A tool is missing or out of date.
- An account is missing, or Google refuses it. See Account not showing up and Google refused access.
- A limit was reached. Your plan's: Plan caps and limits. Google's, or AdCopilot's shared one: Busy, slow or rate-limited.
- A change was refused. See Budget refusals and warnings, It can never delete, Query and change errors, or a teammate who cannot make changes.
- Slow, or timing out. See An audit returned partial results and Busy, slow or rate-limited.
- Teammate problems. See Teammate problems, including calls to one account that fail for one person.
- Billing state. A failed payment, a plan change, a read-only or inactive workspace: Billing and payment issues.
- Your account. Whether a card is on file, a plan on the wrong workspace, stopping emails, deleting your account.
- Google stopped accepting the sign-in. See Reconnect troubleshooting.
For AI assistants
- Fix your own call first. A wrong field or parameter name, a field
missing from
fields, a text over Google's length limit: correct the call yourself and run it once more.get_resource_metadatalists a resource's fields and does not count against the daily operations. Don't ask the user to fix a query. - Retry once, not in a loop. After fixing a call, run it once more. If
Google says it is busy, wait as long as the message says, then try once.
Don't retry an access refusal (
USER_PERMISSION_DENIED,CUSTOMER_NOT_ENABLED, not connected, switched off): only the user's step changes it. Don't retry the plan's daily limit or a Google Ads pause before the time it gives. - Tell the user plainly. When the fix is theirs, quote the error, give the one step from the row above with its dashboard label, and stop.
- Never ask for credentials. No password, Google sign-in code, token, developer token or API key. There is no API key: sign-in is OAuth in the browser. Never send a manager account ID on a call; AdCopilot reaches an account through its manager by itself.
- Read before you repeat a change. A call can stop partway, or Google may not say whether a change was applied, so read the item back first.
- This page as plain text: troubleshooting.md.
Common questions
Is there an API key? No. Sign-in is OAuth in your browser, and the connector URL holds no secret. See There is no API key.
Does it work with Cursor, VS Code or another assistant? Yes, with any assistant that can add a remote MCP server by its URL and sign in through your browser. See Which assistants work.
Can AdCopilot set a Search campaign's language? No. Google removed it from Search campaigns in late September 2026 and goes by the ads' own language, so write them in your customers' language and block other-language searches with negative keywords. Performance Max, Display and Video still have one; see Campaign tools.
Contact support
Still stuck? Write to support@adcopilot.cloud with:
- your workspace's name;
- the assistant you used (Claude, ChatGPT, Cursor, …);
- roughly when it happened, with your time zone;
- the exact error text, copied, and what you asked for;
- the Google Ads account's name, if it is about one account.
Never send a password, a sign-in code, a token, or a screenshot that shows one.
Settings and targeting
The 16 scored AdCopilot checks and 8 observations in the settings and targeting category, with what each looks at, its rule and how to fix it.
Connecting Claude
Fixes for connecting AdCopilot to Claude. A plugin added but not connected, no page to approve, a prompt before every report, and Team or Enterprise limits.