Troubleshooting

An entry is pending or failed

Pending preparation can take a little time. Refresh later. For a failure, check the source type and size, then retry with pasted text or a local file.

A file or URL is unsupported

Use PDF, TXT, JPG, JPEG, PNG, GIF, or WebP up to 20 MB locally. Remote PDFs, paywalls, sign-in pages, and JavaScript-only pages need a permitted local copy or pasted text.

A transcript is unavailable

Some YouTube videos do not expose a transcript. Paste notes or use a video with an available transcript.

A connection or OAuth flow fails

Confirm the client is using https://mcp.atode.dev/mcp over Streamable HTTP, then restart the OAuth 2.1/PKCE sign-in and finish the browser consent screen. If the client does not support this flow, there is no verified direct setup for that surface yet.

The MCP tool does not appear

Restart or reload the provider client after saving its MCP server. Ask it to list tools. Check the provider guide for current support; unsupported surfaces cannot be repaired with speculative configuration.

A shared link returns 404

The session may be unfinished or its share link revoked. Finish the session or create a new link from the completed session detail.

Search returns ordinary results

That is the privacy-preserving fallback when no model key, lexical match, or valid model answer is available. The links still point to the relevant docs.