MCP in Claude

Claude can reach your SurrealDB Cloud account through the SurrealDB MCP Server. Setup takes a minute, and you sign in with your Surreal ID in the browser, so there are no credentials to paste.

Claude Code

Add the server:

claude mcp add --transport http surrealdb https://mcp.surrealdb.com

Run /mcp inside Claude Code, choose surrealdb, and authenticate. A browser window opens for you to sign in and approve the connection.

Check it worked:

claude mcp list

surrealdb should be listed as connected. Ask Claude which SurrealDB organisations it can see, and it should answer with yours.

To connect it for one project rather than everywhere, add --scope project. The entry is written to .mcp.json in the repository, which you can commit for your team. Everyone still signs in as themselves.

Claude Desktop and the Claude app

Open Settings → Connectors → Add custom connector and fill in:

Claude opens a browser window for you to sign in. Once it closes, start a new conversation and open the tools menu in the composer. The SurrealDB tools appear there.

Using a personal access token instead

If you would rather not sign in through the browser, or you are running Claude somewhere without one, create a token in the account portal and pass it as a header:

claude mcp add --transport http surrealdb https://mcp.surrealdb.com \
  --header "Authorization: Bearer <your-token>"

Tick only the permissions the work needs. Signing in lists what each one allows.

Try it

Show me the SurrealDB instances in my organisation, and tell me which of them are paused.

Claude lists your organisations, picks the one you meant, and reports each instance with its state. Example usages has more to try, including deploying an instance and querying its data.

Removing it

claude mcp remove surrealdb

In Claude Desktop and the Claude app, open Settings → Connectors and remove the SurrealDB connector.

Troubleshooting