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 doesn’t see verxion after I restarted”

  • Open claude_desktop_config.json and check the JSON parses (trailing commas, missing closing braces, mixed quotes are the usual culprits)
  • Confirm you placed the snippet inside mcpServers, not at the top level
  • Restart Claude Desktop again — the config is only re-read on launch

”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
  • Re-copy the config from the setup page — tokens are bound to the session that issued them and expire if you’ve signed out elsewhere

”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.