Troubleshooting
The things that go wrong most often, and what to do about them.
Common issues#
Session stuck on 'running' for too long
If a session looks stuck, open it and hit Cancel — unused credits return to your balance immediately. Sessions also have a hard time ceiling; if one runs past it, the engine fails the session automatically and reconciles credits.
A synth's response looks incomplete or stopped mid-stream
Usually a transient model-provider hiccup. Continue the session — the next round will produce fresh responses, and the cross-round summary will treat the partial response as one input among many. If the issue persists, cancel and re-run with the same configuration.
'Insufficient credits' mid-session
Your session stays open and all progress is saved. Top up credits from /profile → Billing or upgrade your plan, then continue exactly where you left off.
Tool execution says 'provider not connected'
Go to /settings/integrations and connect the provider (Gmail, Linear, etc.). Reopen the session and click Execute on the action item again — it picks up the fresh connection.
OAuth callback lands on /settings/integrations instead of returning to the session
This is the just-in-time OAuth flow — expected. The callback preserves your session context via the resumeActionId query param. If the resume did not fire, return to the session tab and click Execute again.
MCP key works in Claude Desktop but not ChatGPT
ChatGPT uses OAuth — Bearer keys do not work there. Use claude.ai or Claude Desktop for Bearer; use the OAuth connector inside ChatGPT (which auto-registers via our RFC 7591 endpoint).
Webhook deliveries not arriving
Check /mcp/console → Webhooks → subscription details. Repeated failures auto-pause the subscription — re-enable it to resume. Also verify your signature check (HMAC-SHA256 with your secret over `${timestamp}.${body}`). See /docs/webhooks for verify code in Node and Python.
Session is missing from my dashboard
Draft sessions can be deleted; active, completed, or archived sessions stay around for credit and audit reasons but can be archived. If you archived a session, flip the dashboard filter to 'Archived' to find it.