MCP 2025-06-18

Errors and recovery

Recover from invalid input, access changes and temporary service failures.

Guides

Access denied

Check that the credential is current, belongs to the intended workspace, has not expired or been revoked, and grants the requested scope. Use verify_access to inspect the effective result. A human sign-in session cannot replace an agent credential.

Unknown tool or invalid input

Refresh tools/list and compare the exact name and inputSchema. Required fields, allowed values and resource scope are validated by the server. Do not add arbitrary fields or silently substitute another operation.

Temporary failure or interrupted request

Keep the request’s correlation ID for support and the original idempotency key for a safe retry. Inspect the latest server result before repeating an action whose response was lost.

Share the operation name, time and correlation ID with support. Remove credentials, private content, provider tokens, signed URLs and file contents from any diagnostic evidence.