ON THIS PAGE

Is this page helpful? YesNo

Thank you!

We're sorry to hear that!

Help us improve – share your feedback

How to Connect to RudderStack MCPBeta

Set up your AI assistant to connect to RudderStack MCP for pipeline debugging and management.

---

This guide covers 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

Claude Code

Run the following command:

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

To make this available across all projects, add --scope user:

claude mcp add --transport http --scope user rudderstack https://mcp.rudderstack.com/mcp

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

Claude Desktop

1. Navigate to 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"

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

codex mcp login rudderstack

Cursor

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

{
  "mcpServers": {
    "rudderstack": {
      "url": "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": {
      "url": "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

Issue	Solution
OAuth login window doesn’t open	Make sure you have completed the OAuth authorization flow for your client
Tools not showing up	Restart your MCP client after adding the configVerify the JSON syntax
“Workspace not found” error	Ask “Show me my available workspaces” and switch to the correct workspace
Connection drops or session errors	Restart the MCP client to establish a fresh session

Questions? We're here to help.

Join the RudderStack Slack community or email us for support

Slack Join now → Email Reach out →

• Previous
• Next

Privacy Overview

This site uses cookies to improve your experience while you navigate through the website. Out of these cookies, the cookies that are categorized as necessary are stored on your browser as they are as essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may have an effect on your browsing experience.

Always Enabled

Necessary cookies are absolutely essential for the website to function properly. This category only includes cookies that ensures basic functionalities and security features of the website. These cookies do not store any personal information.

This site uses cookies to improve your experience. If you want to learn more about cookies and why we use them, visit our cookie policy. We'll assume you're ok with this, but you can opt-out if you wish