RudderStack MCP

Servidor MCP alojado que permite a los asistentes de IA depurar pipelines de RudderStack: errores de entrega, cargas de almacén, violaciones del plan de seguimiento y transformaciones.

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación


Esta guía cubre los pasos para conectar tu asistente de IA a RudderStack MCP para la depuración y gestión de pipelines.

Requisitos previos

  • Debes tener una cuenta activa de RudderStack
  • Cliente compatible con MCP (Claude, Codex, Cursor, VS Code con GitHub Copilot, etc.)

Configuración del cliente

Todas las configuraciones a continuación son globales (disponibles en todos los proyectos) salvo que se indique lo contrario. Consulta la documentación de tu cliente MCP para cambiar el ámbito.

Claude.ai

  1. Navega a claude.ai/settings > Connectors > Add custom connector.
  2. Ingresa la URL: https://mcp.rudderstack.com/mcp

Claude Code

Ejecuta el siguiente comando:

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

Para que esté disponible en todos los proyectos, agrega --scope user:

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

Autentícate ejecutando /mcp en una sesión activa de Claude Code y siguiendo el flujo OAuth.

Claude Desktop

  1. Navega a Settings > Connectors > Add custom connector.
  2. Ingresa la URL: https://mcp.rudderstack.com/mcp

Codex

  1. Agrega lo siguiente a tu archivo ~/.codex/config.toml:
[mcp_servers.rudderstack]
url = "https://mcp.rudderstack.com/mcp"
  1. Autentícate usando el siguiente comando — esto te lleva a través del flujo OAuth.
codex mcp login rudderstack

Cursor

  1. Abre Cursor Settings > MCP > New MCP Server.
  2. Agrega lo siguiente a ~/.cursor/mcp.json:
{
  "mcpServers": {
    "rudderstack": {
      "url": "https://mcp.rudderstack.com/mcp"
    }
  }
}

Visual Studio Code (GitHub Copilot)

Agrega lo siguiente a .vscode/mcp.json en la raíz de tu proyecto. Ten en cuenta que esto tiene ámbito de proyecto — deberás agregarlo a cada proyecto donde quieras usar RudderStack MCP.

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

Autenticación

En la primera conexión, se abre una ventana del navegador para el inicio de sesión OAuth de RudderStack. Autoriza el acceso a tu espacio de trabajo y tu cliente recibirá automáticamente el acceso.

Los tokens se renuevan automáticamente sin necesidad de reautenticación manual.

Verifica tu conexión

Pregunta a tu asistente de IA:

"Dame una descripción general de mi espacio de trabajo de RudderStack."

Deberías ver tus fuentes, destinos y conexiones listadas.

Solución de problemas

ProblemaSolución
La ventana de inicio de sesión OAuth no se abreAsegúrate de haber completado el flujo de autorización OAuth para tu cliente
Las herramientas no aparecen
Error de "Workspace not found"Pregunta "Muéstrame mis espacios de trabajo disponibles" y cambia al espacio de trabajo correcto
La conexión se interrumpe o hay errores de sesiónReinicia el cliente MCP para establecer una sesión nueva