Errors and troubleshooting
Every message your assistant can receive from Pilot MCP, its cause, and the step that fixes it.
An error reaches your assistant in two forms. A tool refusal is a tool result marked as an error, whose text says what to do (scope and ad platform refusals start with Error:): your assistant relays it. A connection refusal is an HTTP response (401, 403, 429, 503) with a short message in English, which your MCP client handles itself, for example by restarting the sign-in.
The messages below are the server's, word for word. Tool refusals are written in French: your assistant relays them in your language. Names and identifiers are examples.
Tool refusals
Account, property or site outside the scope
Error: Le compte publicitaire Google Ads 9999999999 n'est pas rattaché à cet espace Pilot. Comptes publicitaires Google Ads utilisables :
- Boutique FR (123-456-7890)Cause: the tool names an account the workspace has not attached. Fix: ask the assistant to use an account from the list, or attach the account in Connectors. The other scope refusals, with their messages, are on Account scope.
Several accounts, none named
Error: Cet outil agit sur un compte publicitaire Google Ads et cet espace Pilot en a plusieurs de rattachés : Pilot ne choisit pas le compte à votre place. Précisez le compte visé avec l'argument customer_id. Comptes publicitaires Google Ads utilisables :
- Boutique FR (123-456-7890)
- Boutique BE (222-222-2222)Cause: the tool acts on one account and the workspace has several. Fix: tell the assistant which account to target.
Unknown tool
MCP error -32602: Tool google_update_campaign not foundCause: the assistant calls a tool Pilot does not serve it: a write tool, a tool removed for a security reason, a full Pilot analysis, or a tool of a platform that is not connected or not included in your plan. Fix: Pilot MCP serves no write tool. If you just connected a platform, have your client reload the tool list (new conversation, or reconnecting the server). See Ad platforms and their tools.
Invalid parameters
MCP error -32602: Input validation error: Invalid arguments for tool google_get_campaign_performance: …Cause: an argument outside the allowed list, out of bounds, or an incomplete object. The call does not reach the platform and does not count. Fix: the assistant corrects its arguments, from the tool's schema.
Ad platform briefly unavailable
Error: Le service google est temporairement indisponible. Réessayez dans quelques instants.Cause: the platform failed several times in a row; Pilot pauses calls for a short while so as not to overload it. Fix: retry a few minutes later. A variant says the service temporarily refuses Pilot's configuration: the Pilot team is alerted, no action is needed on your side.
Monthly call limit reached
Le forfait <forfait> de Pilot comprend <n> appels d'outils par mois, et ce compte les a tous utilisés. Les appels reprennent le 1er du mois prochain. Ce n'est pas une panne : c'est une limite du forfait <forfait>. Pour la lever, passez à un forfait supérieur : <lien vers l'abonnement>Cause: the plan's call limit is reached. Fix: wait for the 1st of the month, or change plans from the link in the message. See Limits and plans.
Subscription to settle
L'abonnement de cet espace est à régulariser. L'historique, les tableaux de bord et les documents restent consultables ; l'agent, la voix, les automatisations et la collecte reprendront dès la régularisation, depuis Paramètres > Abonnement.Cause: an invoice is still unpaid after Stripe's retries (see Failed payment). The assistant's connection holds, but its tool calls are refused. The text is the same for full Pilot and Pilot MCP. Fix: pay the invoice from Settings, Subscription tab, Manage subscription: everything reopens at once.
Archived workspace
Cet espace est archivé. Il est conservé 12 mois, puis supprimé définitivement ; son propriétaire peut le restaurer d'ici là depuis la liste des espaces.Fix: the workspace owner restores it from the list of workspaces.
Truncated response
[Réponse tronquée par Pilot : 412000 caractères au total, 100000 rendus. Le JSON qui suit est incomplet. Réduisez la période, filtrez, ou utilisez les paramètres limit et page de l'outil.]Cause: an ad platform tool response exceeds 100,000 characters. Pilot keeps the beginning and puts this notice at the start and the end, so that no total is computed on a partial response without knowing it. Fix: ask for a shorter period, a filter, or pagination.
In the application
This message shows in Pilot, not in your assistant.
Full Pilot feature
Cette fonction fait partie de Pilot complet. Cet espace est sur l'offre Pilot MCP, qui donne accès à vos régies depuis Claude, ChatGPT ou Cursor ; pour l'utiliser, passez à Pilot complet depuis Paramètres > Abonnement.Cause: a full Pilot feature (chat, dashboards, automations…) was opened from a Pilot MCP workspace, in the application or through its API. Your assistant does not receive this message: Pilot MCP only serves it the offer's tools. Fix: see Move to full Pilot.
Connection refusals
| Code | Message | Cause | Fix |
|---|---|---|---|
401 | Missing Authorization header | The client has no token yet. | Normal on the first call: the client starts the OAuth sign-in. |
401 | Token expired, Token revoked, Token not recognized, Invalid or expired token | The token expired, was removed in the console, or does not exist. | Reconnect the assistant (in Claude Code: /mcp). |
401 | Invalid or expired API key | The access key is wrong or removed. | Create a new key in the console. |
401 | API key revoked: its creator is no longer a member of this workspace | The person who created the key left the workspace. | An admin creates a new key. |
403 | User is not a member of this workspace | You are no longer a member of the workspace. | Ask an admin to add you. |
403 | Token bound to a different workspace, Token resource mismatch | The token was granted for another workspace than the address's. | Use the authorized workspace's address, or reconnect the assistant. |
403 | API key does not match this workspace | The key belongs to another workspace. | Use the address of the key's workspace. |
404 | No workspace available for this user. Sign in to app.pilot.braike.com and create one. | Your account has no workspace yet. | Create a workspace in Pilot. |
429 | Rate limit exceeded. Please try again later. | The per-minute rate is exceeded. | The client retries a little later. |
503 | Token check unavailable. Please retry later., Membership check unavailable. Please retry later., API key check unavailable. Please retry later. | Pilot could not check the access, during an outage. | Retry: do not undo your connection. |
Troubleshooting
Still stuck? Write to contact@braike.com with the message received and the time of the call.