Resources

Troubleshooting

Fixes for the common problems when adding box to an app or signing in, and how to reach support.

Start with npx @simular-ai/box doctor: it checks box's setup in each app and that the endpoint answers, and prints a fix for each problem it finds.

Common problems

Symptom	Fix
The browser page says "Can't connect this agent"	Sign in again; if it repeats, remove box and add it again.
A headless run (`codex exec`, `claude -p`) has no box tools, or every box call is refused	See Headless agents.
No box tools after signing in	Start a new chat. In Claude Code, `claude mcp list` shows whether `box` is connected; in Gemini CLI, `gemini mcp list`.
Signed out later	Access lasts the days chosen on the approval page; sign in again the same way. Connected apps and keys are listed on Keys.
The model says credits are used up	Your credits are spent. Add credits or choose a plan on Billing.

The setup steps for each app are in MCP server.

Email support@simular.ai. Say which app you added box to and what went wrong.