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
- Navega a claude.ai/settings > Connectors > Add custom connector.
- 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
- Navega a Settings > Connectors > Add custom connector.
- Ingresa la URL:
https://mcp.rudderstack.com/mcp
Codex
- Agrega lo siguiente a tu archivo
~/.codex/config.toml:
[mcp_servers.rudderstack]
url = "https://mcp.rudderstack.com/mcp"
- Autentícate usando el siguiente comando — esto te lleva a través del flujo OAuth.
codex mcp login rudderstack
Cursor
- Abre Cursor Settings > MCP > New MCP Server.
- 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
| Problema | Solución |
|---|---|
| La ventana de inicio de sesión OAuth no se abre | Asegú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ón | Reinicia el cliente MCP para establecer una sesión nueva |