FAQ & troubleshooting

Connection issues

The server connects but every tool fails with a 401 error. Your API key is missing or wrong. Check that the header is exactly Authorization: Bearer YOUR_API_KEY (note the space after Bearer), and that the key matches Settings → API & Webhooks. If you recently rotated the key, update every client config that uses it.

The Docsumo tools don't show up in my client. Most clients need a restart (or an explicit refresh/start of the MCP server) after a config change. Check the client's MCP logs for the docsumo entry; a JSON syntax error in the config file is the most common cause.

"No Docsumo API key found on this request." Your client connected without the auth header. Re-check the header configuration in your setup guide — in Claude Desktop specifically, make sure the key is set via the mcp-remote bridge as shown in the guide, since custom connectors can't attach headers.

Requests fail with a 429 error. You hit the account-wide rate limit of 10 requests/second (shared with your other API integrations). Agents occasionally burst when iterating over many documents — ask the agent to slow down or batch, then retry.

Uploads time out. Large multi-page documents can take a while to process. The document usually still lands in your account — check with list_documents (or in the web app) before re-uploading to avoid duplicates.

Questions

Is my data safe? The MCP server forwards your requests to the same Docsumo API used by the web app, over TLS. It stores no documents, extracted data, or API keys — every request is authenticated independently with the key your client sends.

Does MCP usage consume my plan credits? Yes. Documents uploaded via MCP count toward your plan exactly like web or API uploads. Read-only tools (listing documents, fetching extracted data) don't consume document credits.

Which Docsumo plans can use MCP? Any account with API access — you need an API key from Settings → API & Webhooks. If you don't see API settings, contact [email protected].

Can my agent delete documents or cases? No. Destructive operations are deliberately excluded from the MCP toolset. The agent can change review status and update cases, but it can't permanently delete anything.

Can several people share one connection? Each user should connect with their own API key. Sharing one key across many end users breaks auditability and is against the terms of use.

Something else? Email [email protected] with the tool name, the prompt you used, and the error message.