Why can't my app connect to Rypl?
Updated
Usually one of four things: your plan doesn't include the API, the key was cut off when you copied it, the app hasn't been restarted since you added Rypl, or the connection doesn't allow what you asked for. The error code tells you which.
Check these first
- The plan. The API is on Pro and Ultra, the free trial included. On Simple, MCP and API Keys says "Part of the Pro and Ultra plans."
- The whole key. A Rypl key is
rypl_followed by 48 characters. Copy it from the window in one go. - A new session. Claude Code sessions and a Gemini CLI that were already open don't see Rypl: start a new one.
claude mcp listorgemini mcp listchecks the connection. In Cursor and VS Code, confirm the install. - The command ran where the app lives. Run it in a terminal where
claudeorgeminiworks. Added Rypl before? Remove the old entry first withclaude mcp remove ryplorgemini mcp remove rypl. Gemini CLI turns servers off in folders it doesn't trust, so run it from a folder you trust. - The app itself. Rypl's MCP server speaks Streamable HTTP. A client that knows only the older SSE transport can't connect. claude.ai and ChatGPT connectors aren't supported yet.
If the Connect an AI app window still says it is waiting, the app hasn't made its first request.
What the error code means
| Code | What it means | What to do |
|---|---|---|
401 invalid_key | No key, a wrong one, or one that was disconnected | Copy the key again, or connect the app anew |
401 expired_key | The connection's Access ends date has passed | Connect the app again |
403 plan_required | Your plan has no API | Move to Pro or Ultra |
403 forbidden | The connection wasn't given this: direct messages, settings, moderating or changing rules | Connect again with that switched on |
404 not_found | No such comment, or one this connection may not touch | Check the comment's id and the connection's channels |
409 | The change can't be made: a comment with nothing to review (no_rule_task), a rule change that would delete (deletes_comments), rules kept as text (rules_as_text), a full list (limit_reached), or rules changing at the same moment (conflict, send it again) | Read message |
424 platform_error | Facebook, Instagram or TikTok refused | Read message, which carries their words |
429 rate_limited | More than 120 requests a minute, or 30 changes | Wait for the seconds in Retry-After |
429 platform_rate_limited | The platform itself is limiting requests | Wait for the seconds in Retry-After |
503 busy | Rypl is busy | Try again after Retry-After |
Every error comes as { "error": { "code", "message", "parameter" } }; for a wrong parameter, parameter names it and message says what it takes.