Claude Desktop - RevyOps

Before you start

Claude Desktop installed
Node.js installed, so Claude Desktop can run npx
A RevyOps API key from the Keys tab on the Developer page. See Authentication.

Setup

Open the config file

In Claude Desktop, go to Settings → Developer → Edit Config, which opens claude_desktop_config.json.

Add the RevyOps server

Paste the following. If the file already lists other MCP servers, add revyops inside the existing mcpServers block.

{
  "mcpServers": {
    "revyops": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.revyops.com/mcp",
        "--header",
        "X-API-KEY: RO-your-key-here"
      ]
    }
  }
}

Replace RO-your-key-here with your API key.

Restart Claude Desktop

Save the file, then fully quit and reopen Claude Desktop. On macOS, right-click the Dock icon and choose Quit. Closing the window isn’t enough.

Check the connection

In a new conversation, ask:

“List my RevyOps workspaces”

Claude should reply with the workspaces your key can access.

Managing multiple workspaces

Each workspace has its own API key. To use several in one Claude Desktop, comma-separate the keys in the header:

"--header",
"X-API-KEY: RO-key1, RO-key2, RO-key3"

Ask Claude to “list my workspaces” to see which workspaces it can reach. If fewer workspaces come back than keys you pasted, RevyOps didn’t recognize one of them, most often because it’s a master key or was copied wrong. Then refer to a workspace by name in each question. A question that names no workspace goes to the workspace of the first key in the header.

Troubleshooting

Server disconnected on startup

Double-check your API key is copied correctly with no extra spaces, and that Node.js is installed.

"Workspace not found" error

Ask Claude to “list my workspaces” first, which confirms which workspaces your key has access to.

RevyOps tools don't appear

Make sure you fully quit Claude Desktop and reopened it after saving the config.

Need a new API key

Go to Developer → Keys → Generate key. Workspace keys start with RV- (read-write) or RO- (read-only), and only these work with the MCP server. An agency master key, starting with ML-, is skipped without an error.

​Before you start

​Setup

​Managing multiple workspaces

​Troubleshooting

Before you start

Setup

Managing multiple workspaces

Troubleshooting