MCP Troubleshooting

3 min readLast updated View as MarkdownAgent setup

Disconnect and revoke

  • A member disconnects by removing the connector in their AI client.
  • An Owner or Manager revokes one grant under AI client access › Revoke. The client’s next call into that organization is refused, even if it is still signed in; the member’s other organizations keep working. To restore it, grant again.
  • Block one AI client for everyone under Emergency access controls › Blocked AI clients. Other clients keep working.
  • Turn off all AI client access, or all programmatic access including API keys, under Emergency access controls. Nothing is deleted; turning it back on restores what was in place.
  • Removing a member from the organization ends their AI client access on their next request. Their grant doesn’t come back if they’re invited again.

Every one of these takes effect on the next request, wherever the client is.

Troubleshooting

What you seeWhyWhat to do
The sign-in page doesn’t open, or the client says it can’t connectThe URL is wrong (a trailing slash, http, a typo) or the client isn’t supportedUse exactly https://api.apptonomy.ai/v1/mcp from a supported client
Sign-in fails, or “account_unavailable”Your Apptonomy account can’t be used (signed out, deleted or suspended)Sign in to the Apptonomy web app with the same account, then reconnect
The client keeps asking you to sign in, or reports invalid_tokenYour sign-in expired or was for another serverReconnect the connector and sign in again
list_organizations is emptyYou aren’t a member of any organizationCreate one in the web app, or ask to be invited
grant_requiredNo Owner or Manager has granted this client in that organization, the grant was revoked or expired, it doesn’t include that project, or an action was called on a grant that doesn’t allow actionsAsk an Owner or Manager to grant your client, to add the project, or to allow actions
forbiddenThe organization turned AI client access off or blocked this client, or Apptonomy has paused programmatic accessThe message says which; an Owner or Manager can turn the organization’s switches back on, and access paused on our side resumes when Apptonomy restores it — retry later, and contact support if it persists
insufficient_roleYour role in the organization doesn’t permit what the tool readsAsk an Owner or Manager
not_foundThe organization or project doesn’t exist, you aren’t a member, or the record belongs to another projectCheck the id with list_organizations / list_projects
insufficient_scopeThe grant doesn’t include what the tool readsAsk for the grant to include it
rate_limited, quota_exceededToo many calls, too many operations running, or an audit already started through the API within the plan’s cadenceWait retryAfterSeconds
conflictThe project already has an audit running, the recommendation named isn’t accepted or can’t move to the state asked for, or the draft or recommendation changed since the client read itFollow the running audit, accept the recommendation, or have the client read the draft or recommendation again
result_too_largeThe page is over the result capAsk for fewer items
service_unavailable, internal_errorA temporary failure on our sideRetry; if it persists, contact support with the requestId
A message starting “Input validation error:”The client sent an argument the tool doesn’t take, or the wrong typeUsually a client issue; try rephrasing the request

Still stuck? Contact the in-app Support Center or support@apptonomy.ai with the client you use, the time and the requestId from the failing result. Report a security issue to security@apptonomy.ai. For service status and incidents, see Support and incidents.

  • Public API — the same data for your own code, with API keys
  • API Keys — keys, emergency access controls and access history
  • Members & Roles — who is an Owner or Manager