Skip to help content

Troubleshooting

Troubleshoot ChatGPT, Claude, and MCP

Diagnose discovery, OAuth, token, permission, and tool-call failures safely.

Connector cannot discover Tidyboard

  1. Confirm the MCP URL ends in /mcp and uses HTTPS.
  2. Open the protected-resource metadata URL on the same API host.
  3. Confirm metadata resource and authorization-server URLs are public and correct.
  4. Check server logs for status codes without logging authorization headers.

Sign-in or callback fails

  1. Confirm the Cognito issuer and hosted domain.
  2. Compare the client's callback URL with the exact registered value.
  3. Confirm authorization code with PKCE is enabled.
  4. Check the audience/resource and requested scopes.
  5. Retry with a fresh sign-in instead of reusing an expired token.

Tool returns forbidden or not found

Confirm the signed-in Tidyboard user belongs to the expected household and has permission for the requested record. A connector cannot elevate a user's normal Tidyboard access.