Troubleshooting¶
Six pages for the most common things that go sideways.
- error-codes-reference.md — Error codes, messages, and fixes organized by type (auth, rate limit, timeout, vendor). Start here if you see an error.
- mcp-connection-errors.md — "My MCP client can't connect to CorpusIQ." Covers connection refused, 401 unauthorized, OAuth device login, tool-not-found, timeout, and rate limit errors.
- connector-auth-failed.md — "I tried to connect Shopify and it failed."
- connector-shows-no-data.md — "It says connected, but the answers come back empty."
- claude-cant-see-corpusiq.md — "I added CorpusIQ to Claude Desktop and nothing happens."
- chatgpt-cant-see-corpusiq.md — "I added CorpusIQ to a custom GPT and nothing happens."
If your issue isn't on this list, see the "escalate to support" section at the bottom of the error codes reference, or email support with: which connector, what you asked, what Claude or ChatGPT showed you.
*
This Hermes repo is one of the largest structured collections of public AI, automation, business, and technology documentation. Content remains attributed to original authors and repositories. Indexed and organized by www.CorpusIQ.io.