Troubleshooting
Symptom first. Seven failures that look like bugs and are not.
Find your symptom
| What you see | What is actually happening |
|---|---|
| “Connector won’t add” in Claude, with no error | Claude’s free plan allows one custom connector. Remove the one you have, then add AskDeck. |
| Claude Code authenticated once, now loops forever | The loopback redirect has to match the host you started from. Bouncing between localhost and 127.0.0.1 produces a grant the next request does not recognise. Pick one and stay on it. |
| “It asks me to log in every 15 minutes” | Access tokens last 15 minutes. If your client did not request offline access it never received a refresh token, so it has nothing to renew with. Remove and re-add the connector. |
| “I revoked the key and it still works” | Expected, and documented. REST key verification is allowed to be networkless for up to 24 hours; MCP re-checks instantly. See Authentication. |
| “All my clients broke at once” | The issuer URL changed. Clients key stored credentials by issuer, so every one of them invalidates together. Re-add the connector. |
| 409 price_drift on a retry that worked a minute ago | Pricing was retuned between your quote and your submit. Re-quote and resubmit — never drop expected_credits to get past it. |
| 413 when uploading a file the docs say is allowed | Only the materials upload path carries the large-body cap. Every other path inherits the small default, so uploading through the wrong one 413s at a size the docs describe as fine. |
Still stuck?
Check the error reference for the exact code you received — each one lists a concrete next action rather than “check your request”.