RudderStack MCP

Servidor MCP hospedado que permite que assistentes de IA depurem pipelines da RudderStack: erros de entrega, cargas de warehouse, violações de plano de rastreamento e transformações.

Ver em rudderstack.comExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://mcp.rudderstack.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Este guia cobre as etapas para conectar seu assistente de IA ao RudderStack MCP para depuração e gerenciamento de pipelines.

Pré-requisitos

Você deve ter uma conta ativa no RudderStack
Cliente compatível com MCP (Claude, Codex, Cursor, VS Code com GitHub Copilot, etc.)

Configuração do cliente

Todas as configurações abaixo são globais (disponíveis em todos os projetos), salvo indicação em contrário. Consulte a documentação do seu cliente MCP para alterar o escopo.

Claude.ai

Navegue até claude.ai/settings > Connectors > Add custom connector.
Insira a URL: https://mcp.rudderstack.com/mcp

Claude Code

Execute o seguinte comando:

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

Para disponibilizar isso em todos os projetos, adicione --scope user:

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

Autentique-se executando /mcp em uma sessão ativa do Claude Code e seguindo o fluxo OAuth.

Claude Desktop

Navegue até Settings > Connectors > Add custom connector.
Insira a URL: https://mcp.rudderstack.com/mcp

Codex

Adicione o seguinte ao seu arquivo ~/.codex/config.toml:

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

Autentique-se usando o seguinte comando — isso o leva pelo fluxo OAuth.

codex mcp login rudderstack

Cursor

Abra Cursor Settings > MCP > New MCP Server.
Adicione o seguinte a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rudderstack": {
      "url": "https://mcp.rudderstack.com/mcp"
    }
  }
}

Visual Studio Code (GitHub Copilot)

Adicione o seguinte a .vscode/mcp.json na raiz do seu projeto. Observe que isso é limitado ao projeto — você precisará adicioná-lo a cada projeto onde deseja usar o RudderStack MCP.

{
  "servers": {
    "rudderstack": {
      "url": "https://mcp.rudderstack.com/mcp"
    }
  }
}

Autenticação

Na primeira conexão, uma janela do navegador abre para o login OAuth do RudderStack. Autorize o acesso ao seu workspace e seu cliente receberá o acesso automaticamente.

Os tokens são renovados automaticamente, sem necessidade de reautenticação manual.

Verifique sua conexão

Pergunte ao seu assistente de IA:

"Dê-me uma visão geral do meu workspace do RudderStack."

Você deve ver suas fontes, destinos e conexões listados.

Solução de problemas

Problema	Solução
A janela de login OAuth não abre	Certifique-se de ter concluído o fluxo de autorização OAuth para o seu cliente
As ferramentas não aparecem
Erro "Workspace not found"	Pergunte "Mostre-me meus workspaces disponíveis" e alterne para o workspace correto
Queda de conexão ou erros de sessão	Reinicie o cliente MCP para estabelecer uma nova sessão