Troubleshooting¶
Six pages for the most common things that go sideways.
- Error codes reference - Error codes, messages, and fixes organized by type (auth, rate limit, timeout, vendor). Start here if you see an error.
- MCP connection errors - "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 authentication failed - "I tried to connect Shopify and it failed."
- Connector shows no data - "It says connected, but the answers come back empty."
- Claude can't see CorpusIQ - "I added CorpusIQ to Claude Desktop and nothing happens."
- ChatGPT can't see CorpusIQ - "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.