Troubleshooting AI connections
Recover from connection, profile lease, and stale-page errors without taking over an unrelated browser profile.
No IFox9 tools in the client
Confirm IFox9 is running, the expected client is detected and configured, and the AI client has been restarted. Check any client-side server approval. Test MCP in AI Assistant (API & MCP in earlier builds). Do not enable public networking or regenerate signing certificates as a connection workaround.
Common errors
| Error | Recovery |
|---|---|
UNAUTHORIZED | Check the current local API token; replace an old token after rotation. |
INVALID_ARGUMENT | Use the tool’s current input schema and required fields. |
PROFILE_NOT_FOUND | List profiles again and select an exact profile you can access. |
SESSION_NOT_FOUND / STALE_BROWSER_SESSION | Reopen the selected profile and obtain new session and page IDs. |
PAGE_NOT_FOUND | List pages again and match the target URL and title. |
STALE_SNAPSHOT | Take a new snapshot; never reuse old element references. |
LEASE_CONFLICT | Another client controls this profile. Ask it to release control or wait; do not take over a different profile. |
BROWSER_MODE_MISMATCH | Keep the current mode or obtain approval to stop and reopen with the requested mode. |
A task waits for human input
Sign-in, CAPTCHA, passkeys, or device approval may need visible mode. Ask the user to complete the verification. Do not silently restart a profile in another mode; reopening changes the session ID and can interrupt work.
Downloads or uploads fail
Use browser_prepare_download before the download action and browser_wait_download to obtain the result. Check Downloads/IFox9 MCP, available disk space, and file permissions. Choose uploads from an allowed directory. Do not claim success until a result is actually returned.
What to include in a support request
Include IFox9 version, operating system, AI client/version, visible or headless mode, exact error code, and a short reproduction using a non-sensitive profile. Redact tokens, credentials, cookies, personal page content, and private file paths. Contact IFox9 support.