MCP Troubleshooting
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 see | Why | What to do |
|---|---|---|
| The sign-in page doesn’t open, or the client says it can’t connect | The URL is wrong (a trailing slash, http, a typo) or the client isn’t supported | Use 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_token | Your sign-in expired or was for another server | Reconnect the connector and sign in again |
list_organizations is empty | You aren’t a member of any organization | Create one in the web app, or ask to be invited |
grant_required | No 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 actions | Ask an Owner or Manager to grant your client, to add the project, or to allow actions |
forbidden | The organization turned AI client access off or blocked this client, or Apptonomy has paused programmatic access | The 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_role | Your role in the organization doesn’t permit what the tool reads | Ask an Owner or Manager |
not_found | The organization or project doesn’t exist, you aren’t a member, or the record belongs to another project | Check the id with list_organizations / list_projects |
insufficient_scope | The grant doesn’t include what the tool reads | Ask for the grant to include it |
rate_limited, quota_exceeded | Too many calls, too many operations running, or an audit already started through the API within the plan’s cadence | Wait retryAfterSeconds |
conflict | The 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 it | Follow the running audit, accept the recommendation, or have the client read the draft or recommendation again |
result_too_large | The page is over the result cap | Ask for fewer items |
service_unavailable, internal_error | A temporary failure on our side | Retry; 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 type | Usually 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.
Related
- 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