Fix AI assistant connection problems

What to do when ChatGPT, Claude or another AI assistant can't connect to Woosool or can't use an app.

Web
On this page
  1. "Not found" when you open mcp.woosool.com
  2. The Woosool page says redirect_uri is not registered
  3. The Woosool page says 'mcp' is not permitted (invalid_scope)
  4. The assistant connects but can't use any app
  5. It works for some apps but not others
  6. "Your organisation requires 2-Step Verification"
  7. It stopped working after a while
  8. "Sign in again" when creating a token

"Not found" when you open mcp.woosool.com

That's normal in a browser. The server address for assistants is https://mcp.woosool.com/mcp, and only AI assistants can use it. Check that the address ends with /mcp.

The Woosool page says redirect_uri is not registered

The callback URL in your OAuth app doesn't match the assistant's. In OAuth apps, open the app and paste the assistant's callback URL into Redirect URIs (one per line) exactly, with no extra space or slash.

The Woosool page says 'mcp' is not permitted (invalid_scope)

The OAuth app doesn't have the mcp scope. Open it in OAuth apps, tick mcp under Scopes, save, and connect again.

The assistant connects but can't use any app

  • The assistant may have signed in without the mcp scope. Disconnect it, make sure it asks for mcp, and connect again.
  • If you use a token, check that it has the apps you need under App access (AI assistants / MCP). Tokens without app access only work for the developer API.

It works for some apps but not others

  • Token: create a new one with the missing apps ticked, or All apps.
  • Organisation account: your organisation may not give you that app. Ask your administrator.

"Your organisation requires 2-Step Verification"

Turn on 2-Step Verification, then try again.

It stopped working after a while

  • The connection was removed, the token was revoked or expired, or you changed your password. Connect again or create a new token.
  • An assistant that signed in without offline_access must sign in again every hour.

"Sign in again" when creating a token

Tokens with app access need a recent sign-in. Sign out, sign back in, and create the token within 15 minutes.