How to Connect to RudderStack AI

This guide will help you connect your AI assistant or development tools to RudderStack’s MCP (Model Context Protocol) server. The RudderStack MCP server provides a standardized interface that allows any compatible AI model or agent to access your RudderStack data securely.

This is an early access feature. If you encounter any issues or have suggestions for improvement, reach out to RudderStack Support.

Prerequisites

• Active RudderStack account with workspace access
• Compatible MCP client (Claude, VS Code, Cursor, Windsurf, or custom integration)

Setup

Choose the setup method that matches your preferred platform or tool.

Claude (Team/Enterprise)

1. Visit https://claude.ai/settings/connectors.

2. Click Add Custom Connection and enter the following details:

   • Integration name: RudderStack
   • Integration URL: https://mcp.rudderstack.com/mcp

3. Click Add.

4. Authorize your RudderStack by logging in with your existing RudderStack credentials and completing the authorization process.
5. Verify and test your connection.

Claude (Individual Paid)

1. Visit claude.ai/settings/connectors on web or navigate to Settings > Connections on desktop.

2. Click Add Custom Connection andnter the following details:

   • Integration name: RudderStack
   • Integration URL: https://mcp.rudderstack.com/mcp

3. Save and enable the connection.

Claude (Free)

1. Open your Claude Desktop configuration file:

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

2. Add the RudderStack MCP server to the configuration:

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

3. Restart Claude Desktop for the changes to take effect.

VS Code

For VS Code integration, add the following to your settings:

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

Cursor

Install the MCP server in Cursor

Alternatively, you can manually update your Cursor configuration:

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

Windsurf

In Windsurf, navigate to Settings > MCP Servers. Then, add the following configuration:

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

Direct connection

For testing or using custom integrations, run the following command:

npx mcp-remote "https://mcp.rudderstack.com/mcp"

OAuth authentication flow

When you first connect to the RudderStack MCP server through any of the above methods, you will go through a secure OAuth authentication process. Here’s what happens during the setup:

1. Initial connection: When you first use any MCP tool to connect to https://mcp.rudderstack.com/mcp, the server identifies that you need authentication.
2. Browser redirect: Your default browser will automatically open and redirect you to RudderStack’s login page.
3. RudderStack login: Sign in with your existing RudderStack credentials (email and password).
4. Authorization: Review and approve the MCP integration’s requested permissions to access your RudderStack data.
5. Automatic return: Once authorized, you’re redirected back and the MCP connection is established.
6. Tool integration: Your MCP client (Claude, VS Code, etc.) will now have access to RudderStack tools and data.

Verify your connection

After successful setup, you should see RudderStack listed in your available tools. The tool list includes options like:

• audit_logs
• get_destination_errors
• list_connections
• get_warehouse_uploads
• source_live_events, and many more

You can use these tools to get comprehensive data access and help you debug your pipeline issues.

Test your connection

Try the following prompt to confirm that the setup works as expected:

How are my RudderStack pipelines?

This prompt responds with all your sources, destinations, and connections, confirming that RudderStack AI can access your workspace data.

Use prompt templates

For effective debugging with RudderStack AI, you can use the RudderStack MCP Prompt Templates designed to help you troubleshoot common pipeline issues and get insights into your data flow.

Troubleshooting

This section contains some troubleshooting tips for the common issues you may encounter while setting up RudderStack AI.

Connection issues

If you’re having trouble connecting:

• Verify the server is accessible at https://mcp.rudderstack.com.
• Update to the latest version of npx and your MCP client.
• Try clearing stored authentication and reconnecting.

Authentication errors

• Ensure you have an active RudderStack account.
• Verify your account has the necessary permissions.
• Clear browser cookies and try again.

Common setup issues

Known limitations

The RudderStack MCP server is in active development. Currently, it has the following limitations:

• Some RudderStack features may not be available
• Connection stability may vary during updates

Next steps

After setting up the connector successfully, you can:

• Ask questions about your RudderStack pipeline health and configuration
• Debug data flow issues with AI assistance
• Get insights into warehouse uploads and transformations
• Explore live events from your sources

Support and feedback

This is an early access feature — if you encounter any issues, reach out to RudderStack Support.

We’d love your feedback. As you explore these AI debugging capabilities, feel free to share your experience and suggestions for improvement with the RudderStack team.

Questions? Contact us by Email or on Slack