---
title: MCP Troubleshooting
description: Disconnect a client or revoke its access, and fix every error an AI client can show when it connects to Apptonomy over MCP.
---

## 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](/docs/mcp/getting-started#supported-clients) |
| 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](/docs/api/conventions#support-and-incidents).

## Related

- [Public API](/docs/api/resources) — the same data for your own code, with API keys
- [API Keys](/docs/api/keys) — keys, emergency access controls and access history
- [Members & Roles](/docs/team/members-and-roles) — who is an Owner or Manager
