Connect a client

Before you start

You need a Rilla account with the Admin or Team Manager role. Pick your client below; every client uses the same server URL, and there is no API key to create.

https://customer.rillavoice.com/mcp

Each client opens Rilla’s login page in your browser the first time it connects. Sign in as you do in the Rilla web app, including single sign-on. You see the same data you see there; see Sign-in and access.

Claude

On Pro and Max plans, open Customize → Connectors, select + Add, then Add custom connector. Enter Rilla as the name and the server URL, then select Continue on each screen, keeping the detected sign-in. Under OAuth client, keep Use Claude’s published identity, leave request headers empty, and select Add. Sign in to Rilla when Claude asks.

On Team and Enterprise plans, an owner first adds the connector in Organization settings → Connectors (Add → Custom → Web) with the same URL. Each member then selects Connect on it under Customize → Connectors and signs in with their own Rilla account.

Claude Desktop

Claude Desktop uses the connectors on your Claude account. Add Rilla once as described for Claude and it is available in the desktop app too. You don’t need to edit claude_desktop_config.json; that file is for servers that run on your computer.

Claude Code

Add the server from a terminal:

claude mcp add --transport http rilla https://customer.rillavoice.com/mcp

Then run /mcp in Claude Code, select rilla and sign in to Rilla in your browser. By default the server is available only to you in the current project; add --scope user to use it in every project.

Cursor

With Cursor installed, select Add to Cursor and confirm in Cursor:

Or add Rilla by hand to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project:

{
  "mcpServers": {
    "rilla": {
      "url": "https://customer.rillavoice.com/mcp"
    }
  }
}

Cursor lists rilla among your MCP servers. When it asks you to authenticate, sign in to Rilla in your browser.

ChatGPT

Open Plugins, select +, then Add custom MCP server. Enter Rilla and the server URL, choose OAuth, confirm the warning about custom servers, and select Create as a plugin. Sign in to Rilla when ChatGPT asks. In a workspace, your admin’s permission settings decide whether you can add custom MCP servers.

Check the connection

Ask something only Rilla can answer, such as “List my conversations from last week in Rilla.” If the assistant answers from Rilla, you’re connected. For login loops and permission errors, see Troubleshooting.