Skip to content

Troubleshooting

Common errors when setting up or running verxion, with the fix.

If something isn’t working, start here. Most issues fall into one of the patterns below.

Setup and connection

“Claude Desktop doesn’t see verxion”

  • Open Settings → Connectors and confirm the verxion remote connector is present
  • Select Connect again and complete OAuth in the browser
  • Enable verxion from Search and tools in a new conversation
  • Do not configure this remote connector in claude_desktop_config.json

“ChatGPT loads my App but the tools never run”

  • Open a fresh conversation; tools picked up only at conversation start
  • If you see a permission prompt and dismiss it, the tools stay blocked for that conversation
  • Remove and recreate the custom app with the URL from the setup page

“OAuth login bounces in a loop”

  • Sign out from the setup page, close the tab, and start over with a fresh snippet
  • Check that your browser isn’t blocking third-party cookies for the verxion domain — OAuth needs them
  • Try a different browser or an incognito window to rule out an extension

During use

“Every call returns 401”

  • Token expired. Regenerate the snippet from the setup page.
  • If you signed out from another device/tab, your token was invalidated globally.

“My tool call returns 403 — permission denied”

  • The action requires a scope your token doesn’t carry. See OAuth scopes.
  • The default token covers all five resource groups at the write tier but not destructive. Deleting requires upgrading the scope.

“The agent says a tool doesn’t exist”

  • You’re probably on Code Mode (the default). The agent only sees execute_code. It will write code that internally calls the operation you asked for. See MCP Profiles.
  • If you’re on Full mode and a specific operation is missing, contact support — we may have moved it.

“ChatGPT says: this app is at the tool limit”

  • You’re on an old config snippet from before Code Mode. Re-copy the snippet from the setup page; the new one uses Code Mode UI which is well under the limit.

Data and state

“I logged a set but it doesn’t show up”

  • The session has to be started before set logs attach to it. Ask the agent “is my session active?” — if no, “start today’s workout” first.
  • If the agent confirmed the set but you can’t find it, ask “show me my last 5 set logs” — sometimes the listing UI in your client is stale and a direct query resolves it.

“I deleted something by accident”

  • Deletes are permanent in production. Contact support immediately with the approximate time and what was deleted — we may be able to restore from backups depending on how long ago.

“Account deletion left me stuck signed in”

  • Sign out from your client. Your old session cookie is invalidated server-side but your client still holds it.
  • Clear cookies for the verxion domain in your browser if you signed in via web.

Reporting an issue

If none of the above match, send what you have to [email protected]:

  1. Which client (ChatGPT / Claude Desktop / Claude Code) and version
  2. What you asked the agent to do
  3. The error message or unexpected behavior
  4. Approximate time, so we can correlate with logs

We don’t need (and don’t want) your prompt history or PII — just the failure shape.