How to Connect to RudderStack AI

Use RudderStack’s AI-powered pipeline debugging capabilities by connecting your RudderStack workspace to Claude Desktop.

  •   3 minute read  

This guide will help you connect RudderStack to Claude Desktop and start exploring the new AI-powered pipeline debugging capabilities through Claude’s MCP connectors.

info
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
  • Claude Pro or Team account (paid Cloud account required - this won’t work with free Claude accounts)

Setup

This section guides you through configuring a RudderStack MCP connector in Claude Desktop.

1. Access Claude connectors

  1. Go to Claude Settings > Connectors.
  2. Click Add custom connector.
warning
This option is currently in beta and available only in paid plans.
Add custom connector option in Claude

2. Configure RudderStack connector

  1. Add the following details to configure the RudderStack connector:
SettingValue
TitleRudderStack (or any other name you prefer)
URLhttps://mcp.rudderstack.com/mcp
  1. Click Add.
Configure RudderStack connector in Claude

3. Authorize your RudderStack account

  1. Once you click Add, you’ll be redirected to app.rudderstack.com.

  2. Log in using your existing credentials:

    • Google SSO
    • Email and password
    • SSO authentication

  3. Complete the authorization process.

Authorize RudderStack account in Claude

4. Verify the connection

  1. Return to Claude.
  2. You should see RudderStack listed in your available tools
  3. The tool list includes options like:
    • audit_logs
    • get_destination_errors
    • list_connections
    • get_warehouse_uploads
    • source_live_events, and more
Verify connection in Claude

5. 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.

RudderStack AI prompt with the initial response
RudderStack AI prompt with pipeline details

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 lists the common issues you may encounter while setting up RudderStack AI and their solutions.

IssueSolution
Connectors tab not visible in ClaudeMake sure you have a paid Claude account (Pro or Team) — MCP connectors are not available on free accounts.
Connection not appearingRefresh the Claude connectors and verify that you have saved the connector correctly.
Authorization failuresMake sure you’re logged into the correct RudderStack workspace. You can also ask Claude to switch to the desired workspace.
Tools not loadingYou might need to re-establish the connection. Try disconnecting and reconnecting.

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