How to Connect to RudderStack MCP Beta

This guide details the steps to connect your AI assistant to RudderStack MCP for pipeline debugging and management.

Prerequisites

• You must have an active RudderStack account
• MCP-compatible client (Claude, Codex, Cursor, VS Code with GitHub Copilot, etc.)

Client setup

All configurations below are global (available across all projects) unless noted otherwise. Refer to your MCP client’s documentation to change the scope.

Claude.ai

1. Navigate to claude.ai/settings > Connectors > Add custom connector.
2. Enter the URL: https://mcp.rudderstack.com/mcp

Codex

1. Add the following to your ~/.codex/config.toml file:

[mcp_servers.rudderstack]
url = "https://mcp.rudderstack.com/mcp"

2. Authenticate using the following command — this takes you through the OAuth flow.

codex mcp login rudderstack

Clients using mcp-remote

These MCP clients use npx mcp-remote as a transport layer and require Node.js 18+.

Claude Desktop

Add the following to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rudderstack": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.rudderstack.com/mcp"]
    }
  }
}

Claude Code

1. Run the following command:

claude mcp add rudderstack -- npx mcp-remote https://mcp.rudderstack.com/mcp

2. Authenticate by running /mcp in an active Claude Code session and following the OAuth flow.

To make this available across all projects, use --scope user in the above command.

Cursor

1. Open Cursor Settings > MCP > New MCP Server.
2. Add the following to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rudderstack": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.rudderstack.com/mcp"]
    }
  }
}

Visual Studio Code (GitHub Copilot)

Add the following to .vscode/mcp.json in your project root. Note that this is project-scoped — you will need to add it to each project where you want to use RudderStack MCP.

{
  "servers": {
    "rudderstack": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.rudderstack.com/mcp"]
    }
  }
}

Authentication

On first connection, a browser window opens for RudderStack OAuth login. Authorize access to your workspace and your client automatically receives access.

Tokens refresh automatically without requiring manual re-authentication.

Verify your connection

Ask your AI assistant:

“Give me an overview of my RudderStack workspace.”

You should see your sources, destinations, and connections listed.

Troubleshooting