Troubleshooting
What the common errors mean and what to do about them.
The client never asks me to sign in, or loops on sign-in
Check the URL. It must be the exact value from the dashboard's MCP settings, ending in the workspace id. A bare /v1/mcp answers 404. Some clients cache a failed registration; remove the connector and add it again.
401 Authentication required
The client sent no token, or one the server does not recognize. An API key or a CLI session in the token field causes this too; the connector takes OAuth only. Sign in again from the client.
403 This account has no active membership in the requested workspace
The account you signed in with is not a member of the workspace in the URL, or the membership was deactivated. Ask for an invite, or fix the URL.
403 No active workspace for this account
The account exists but belongs to no workspace at all. Create or join one in General Input first.
503 Authentication service temporarily unavailable
The server could not reach the service that resolves your token. Retry in a moment; nothing about the connector's configuration is wrong.
A tool fails with "The workspace sandbox is unavailable right now"
The sandbox pool could not provision or adopt a pod. This arrives as a failed tool call rather than an HTTP error, so the assistant sees it and can retry. Nothing is lost, since work/ is checkpointed after every call that changed it.
Browser login does not finish
Open the link returned by browser_request_login, complete sign-in, and tell the assistant you are done. It must call browser_finish_login with the token from browser_request_login to save the login and turn the browser off, then reopen the session to use it. If the handoff expired, request a new link. Only the owner can reconnect a shared browser. Browser tools appear only when browser automation is configured.
Browser variables disappeared
The browser runtime can be lost when a sandbox is recycled. Follow the tool's reset instruction with empty code to inspect the page before rebuilding variables. Actions may already have completed, so inspect before repeating them. Close browser sessions when finished; idle sessions are released after five minutes.
The agent keeps asking me to confirm every step
Your host is gating write tools on their annotations. Set the connector's tool permissions to always allow; see the client page for where that setting lives.
Files I asked for do not open
Download links expire after seven days. Ask the agent to send the file again.
Getting help
Include the workspace id from the URL and the client you are using. Nothing in the URL or a connector name is secret.