Common issues
The Raff page says "This request has expired"
The Raff page says "This request has expired"
What’s happening: the sign-in request from your app is older than 10 minutes.Fix: go back to the app and connect Raff again. Finish the Raff page within 10 minutes.
The app says it cannot connect or sign in to Raff
The app says it cannot connect or sign in to Raff
What’s happening: the app could not reach the server or finish sign-in.Fix:
- Check the URL is exactly
https://mcp.rafftechnologies.com/mcp, with/mcpat the end. - Remove the Raff connector and add it again, then sign in.
- With an API key, check the header is
Authorization: Bearer raff_...and the key has not been deleted.
The assistant works in the wrong account
The assistant works in the wrong account
What’s happening: an app signed in with Raff works in the account you chose on the Raff page. When you switch accounts in the Raff dashboard, the app follows within 5 minutes.Fix: switch to the right account in the dashboard, or remove the connector and connect again, choosing the account on the Raff page. An API key always works in the account it was created in.
A paid create or upgrade asks for a card
A paid create or upgrade asks for a card
What’s happening: paid databases are monthly subscriptions and need a card that can be charged automatically.Fix: add a card under Billing in the Raff dashboard (the quote links there), then ask the assistant again.
The free database cannot be created
The free database cannot be created
What’s happening: each account has one free database, and it is already in use.Fix: use the existing free database, delete it, or choose a paid plan.
The assistant says it is not allowed to do something
The assistant says it is not allowed to do something
What’s happening: either your Raff role does not allow it (for example a member without permission to delete databases), or the app was connected in read-only mode.Fix: ask an account owner to change your role, or connect without
read_only=true. See Sign-in and access.The assistant will not delete a database
The assistant will not delete a database
What’s happening: some assistants refuse to delete data by their own rules, whatever the server allows. Raff also requires the database’s exact name to delete it.Fix: tell the assistant the database name and that you want it deleted, or delete it in the Raff dashboard.
A query stops with a timeout
A query stops with a timeout
What’s happening: statements run through the MCP server stop after 15 seconds.Fix: add a
LIMIT, filter on an indexed column, or run long jobs (large imports, index builds on big tables) from your own client with the connection string.My client rejects the database certificate
My client rejects the database certificate
What’s happening: each database has its own certificate authority, which your computer does not trust by default. Clients that verify the certificate (
sslmode=verify-full, --cacert) need it.Fix: download the database’s CA certificate (Connect tab, Download CA certificate, or ca_cert from the connection endpoint) and point your client at it, for example sslmode=verify-full&sslrootcert=ca.crt. Or use sslmode=require, as in the connection string Raff gives you: still encrypted, without the certificate check. See Networking and security.Still stuck?
Contact support@rafftechnologies.com with:- The AI app you use (Claude, ChatGPT, Cursor, …)
- The database ID, if a database is involved
- The exact error message and the time it happened