Connect Claude, Cursor and other agents
What an MCP client needs to use TeselaDB, with its configuration.
Configure an MCP client, such as Claude or Cursor, so its agent queries TeselaDB. Desktop clients launch it over stdio with teseladb mcp.
Requirements
- The
teseladbbinary on the client's machine. - An API key and the cluster CA.
Over stdio
Add the server to your client's MCP configuration. The mcpServers, command, args and env keys are the ones
Claude and Cursor use:
JSON
{
"mcpServers": {
"teseladb": {
"command": "teseladb",
"args": ["mcp", "--uri", "https://node-01:27080", "--tlsCAFile", "./ca.pem"],
"env": { "TESELADB_API_KEY": "tdb_…" }
}
}
}Over HTTP
A client that implements Streamable HTTP connects to https://<node>:27080/mcp with the key in Authorization: Bearer.
Check
When you ask the agent to list your databases, it calls the list-databases tool and returns the databases your key sees.
Common problems
- The client does not start the server because
teseladbis not on the client'sPATH. Use the full path incommand.