Troubleshooting
Where to find fixes for connection, sign-in, site audit, rank tracking, Google, credit and self-hosting problems.
Connecting an agent
- ChatGPT: the plugin isn't available, no Developer mode, OAuth errors, or tools that don't show up in a chat.
- Claude: plugin skills that don't appear,
/reload-pluginsoutput, the plugin cache, and sign-in. - Codex: the server isn't found after install, sign-in errors, and CLI commands that changed between versions.
- Any MCP client: the server URL, failed authorization, and projects your agent can't find.
Site audits
- When an audit looks wrong: blocked, rate-limited or partial crawls, and audits that find no issues.
- OpenSEO-Audit crawler: how the crawler identifies itself, and how to allow it through robots.txt or a firewall.
Rank tracking
- Keywords marked "Not checked": why a keyword has no new position, and how to tell it apart from a ranking loss.
Search Console and Analytics
- If your site isn't listed: missing sites, properties you can't select, missing permissions and expired connections.
Credits and teammates
- When you run out: what stops when credits run out, and how to get more.
- Invite a teammate: invitations that don't arrive, and how to resend them.
Self-hosting
Still stuck?
Email support@openseo.so with what you tried, the step that failed, and the error message. Don't include passwords, API keys, or sign-in codes.