Rollbar

Accede a los datos del proyecto de Rollbar para monitoreo y depuración de errores.

GitHub
28
Prueba este MCPPatrocinado

Documentación

rollbar-mcp-server

Un servidor de Protocolo de Contexto de Modelo (MCP) para Rollbar.

Características

Este servidor MCP implementa el tipo de servidor stdio, lo que significa que tu herramienta de IA (por ejemplo, Claude, Cursor) lo ejecutará directamente; no ejecutas un proceso separado ni te conectas a través de http.

Configuración

Token de acceso de cuenta

Configura un único Token de Acceso de Cuenta de Rollbar y permite que cada herramienta funcione en todos los proyectos de esa cuenta:

  • ROLLBAR_ACCOUNT_ACCESS_TOKEN (variable de entorno), o
  • accountToken (una clave de nivel superior en .rollbar-mcp.json, junto con projects/token/apiBase)

Para crear uno: en Rollbar, ve a configuración de cuenta → Tokens de Acceso de Cuenta, crea un nuevo token con nombre, habilitado, y elige el alcance de lectura (o lectura y escritura, si planeas usar update-item). Copia el secreto completo generado de inmediato; Rollbar solo lo muestra una vez, y guárdalo de forma segura (un administrador de secretos o la configuración de entorno de tu shell, no lo comprometas en el control de código fuente).

{
  "accountToken": "acct_tok_abc123"
}

Si deseas controles más estrictos en algunos proyectos, otorga al token de cuenta el alcance de lectura para que puedas leer todos los proyectos, luego lista explícitamente los pocos proyectos que necesitan update-item con sus propios tokens de proyecto de lectura+escritura. Estos anulan el token de cuenta solo para ese proyecto, según la regla de precedencia a continuación (el token de proyecto explícito siempre gana).

{
  "accountToken": "acct_tok_abc123",
  "projects": [
    { "name": "backend", "token": "tok_backend_readwrite" }
  ]
}

Las configuraciones de token de proyecto no cambian en absoluto con esta característica: si no configuras un token de cuenta, nada sobre las configuraciones existentes de uno o múltiples proyectos se comporta de manera diferente. Los dos modos también pueden coexistir: si un nombre de project coincide con un proyecto configurado explícitamente que tiene su propio token, el token propio de ese proyecto siempre se usa para ese proyecto, incluso cuando también está presente un token de cuenta.

Configuración por proyecto para acceso más seguro

Proyecto único: Variable de entorno

  • ROLLBAR_ACCESS_TOKEN: token de acceso para tu proyecto de Rollbar.
  • ROLLBAR_API_BASE (opcional): anula la URL base de la API (por defecto https://api.rollbar.com/api/1).

Múltiples proyectos: Archivo de configuración

Crea .rollbar-mcp.json en tu directorio de trabajo o directorio de inicio, o establece ROLLBAR_CONFIG_FILE para apuntar a una ruta personalizada. Hay una plantilla incluida disponible en rollbar-mcp-example.json; cópiala a .rollbar-mcp.json y completa tus tokens reales.

Taquigrafía de proyecto único:

{ "token": "tok_abc123" }

Múltiples proyectos:

{
  "projects": [
    { "name": "backend",  "token": "tok_abc123" },
    { "name": "frontend", "token": "tok_xyz789" }
  ]
}

Orden de búsqueda del archivo de configuración:

  1. Variable de entorno ROLLBAR_CONFIG_FILE
  2. .rollbar-mcp.json en el directorio de trabajo actual
  3. ~/.rollbar-mcp.json en el directorio de inicio
  4. Variable de entorno ROLLBAR_ACCESS_TOKEN o ROLLBAR_ACCOUNT_ACCESS_TOKEN (proyecto único o de toda la cuenta, compatible con versiones anteriores)

Si existe un archivo de configuración pero es inválido, el servidor sale con un error en lugar de recurrir a una fuente de configuración de menor prioridad.

Alcances requeridos:

  • Las herramientas de solo lectura (get-item-details, get-deployments, get-version, get-top-items, list-items, get-replay, list-projects, list-occurrences) funcionan con un token de cuenta de alcance de lectura.
  • update-item requiere un token de cuenta con alcance de lectura y escritura: cada llamada de token de cuenta resuelve el proyecto de destino a través de GET /projects primero (lectura), luego realiza la solicitud de PATCH (escritura). Un token de solo escritura fallará en el paso de resolución del proyecto antes de llegar a la actualización.
  • Al igual que con los tokens de proyecto, prefiere un token de alcance de lectura a menos que necesites específicamente update-item.

Si el servidor detecta que solo está configurado ROLLBAR_ACCESS_TOKEN (sin token de cuenta explícito), realiza una verificación única y almacenada en caché contra GET /projects para ver si ese token es realmente un token de cuenta; si es así, el modo de cuenta se activa automáticamente. Un token de proyecto único continúa funcionando exactamente como antes.

Herramientas

list-projects(): Ve con qué proyectos de Rollbar puede hablar este servidor. Si usas un token de proyecto único, esto solo confirma el único proyecto que has configurado. Si usas un token de cuenta que puede alcanzar múltiples proyectos, así es como encuentras el nombre o id del proyecto para pasarlo al parámetro project de las otras herramientas.

get-item-details(counter, max_tokens?, project?): Obtén la imagen completa de un solo elemento de Rollbar: sus detalles más su ocurrencia más reciente, para que no tengas que buscar el elemento y luego obtener por separado el error más reciente. Dale el contador del elemento (el número que ves en la interfaz de Rollbar).

max_tokens (por defecto 20000) limita cuán grande puede llegar a ser la data de ocurrencia en la respuesta. Algunas ocurrencias llevan muchos detalles (trazas de pila largas, datos de solicitud), por lo que esto evita que una búsqueda de un solo elemento infle la respuesta. El project opcional selecciona qué proyecto usar, por nombre configurado o por nombre/id real del proyecto en modo de token de cuenta. Ejemplo de prompt: Diagnose the root cause of Rollbar item #123456

get-deployments(limit, project?): Lista los despliegues recientes de un proyecto, para que puedas alinear cuándo se realizó un despliegue con cuándo comenzaron o dejaron de ocurrir errores. project opcional cuando hay múltiples proyectos configurados o en modo de token de cuenta. Ejemplo de prompt: List the last 5 deployments o Are there any failed deployments?

get-version(version, environment, project?): Consulta cómo se ha desempeñado una versión específica (como un SHA de git) en un entorno, incluyendo cuándo apareció por primera y última vez en las ocurrencias. Útil para verificar si una versión particular introdujo o corrigió un problema. project opcional cuando hay múltiples proyectos configurados o en modo de token de cuenta.

get-top-items(environment, project?): Ve qué está fallando realmente ahora mismo. Devuelve los elementos con más ocurrencias en las últimas 24 horas para el entorno dado, para que puedas priorizar qué revisar primero en lugar de escanear la lista completa de elementos. project opcional cuando hay múltiples proyectos configurados o en modo de token de cuenta.

list-items(status?, level?, environment?, page?, limit?, query?, project?): Busca y filtra elementos de Rollbar en lugar de traer toda la lista. Filtra por status (por defecto active, para que los elementos resueltos y silenciados no estorben), level y environment, o busca por texto de query. Usa page y limit para controlar cuánto se devuelve a la vez. project opcional cuando hay múltiples proyectos configurados o en modo de token de cuenta.

list-occurrences(counter, limit?, page?, last_id?, max_tokens?, project?): Consulta las ocurrencias reales detrás de un elemento de Rollbar, no solo el resumen del elemento. Dale el contador del elemento y devuelve las instancias individuales, cada una con su propia marca de tiempo, entorno y detalle de error.

Usa limit para controlar cuántas ocurrencias se devuelven (por defecto 3, máximo 100), y page o last_id para avanzar a través de más de ellas. last_id es paginación basada en cursor: pasa el id de la última ocurrencia que recibiste y obtendrás el siguiente lote después de ella. Agregamos esto porque los números de página simples pueden omitir o repetir resultados si las ocurrencias cambian entre llamadas, y last_id no tiene ese problema, así que úsalo cuando estés paginando a través de muchas ocurrencias. Si pasas ambos, last_id gana. Las ocurrencias dentro de una página siempre están ordenadas por marca de tiempo (más recientes primero), por lo que la última que ves es confiablemente la correcta para devolver como last_id.

Los datos de ocurrencia pueden crecer rápidamente, especialmente para errores con trazas de pila grandes o cargas útiles de solicitud. max_tokens (por defecto 20000, mínimo 100) limita aproximadamente cuán grande puede llegar a ser toda la respuesta, en alrededor de max_tokens * 4 caracteres. Construimos esto porque sin un límite, un puñado de ocurrencias podría superar con creces lo que cabe en una conversación. Cada ocurrencia que solicitaste aún aparece en la respuesta, sin embargo. En lugar de descartar alguna para mantenerse dentro del presupuesto, la herramienta reduce las más grandes paso a paso, manteniendo los campos más útiles (nivel, entorno, mensaje de excepción y similares) el mayor tiempo posible antes de caer a solo un id y marca de tiempo. Un campo de nivel superior _truncation te indica cuándo sucedió esto. Si tu limit y max_tokens genuinamente no pueden caber ni siquiera una versión mínima de cada ocurrencia, recibirás un error claro que te dice que bajes limit o subas max_tokens, en lugar de una página incompleta silenciosamente.

Algunos elementos de Rollbar son en realidad grupos de varios elementos agrupados. La API pública de Rollbar aún no puede listar correctamente las ocurrencias de estos, por lo que llamar a esta herramienta en un elemento de grupo devuelve un mensaje explícito de group_item_not_supported diciéndolo, en lugar de mostrarte silenciosamente una lista vacía que parece que el elemento no tiene ocurrencias en absoluto.

project opcional cuando hay múltiples proyectos configurados. Ejemplo de prompt: Show me the last 3 occurrences of item #24265

get-replay(environment, sessionId, replayId, delivery?, project?): Obtén los metadatos y la carga útil de una repetición de sesión para una sesión específica, para que puedas ver lo que un usuario realmente hizo antes de un error.

Por defecto (delivery="file"), el JSON de la repetición se escribe en un archivo temporal en disco y la herramienta devuelve la ruta del archivo. Esto funciona en todas partes, pero el archivo permanece hasta que lo limpies tú mismo. Establece delivery="resource" en su lugar para obtener un enlace rollbar:// que los clientes compatibles con MCP pueden leer directamente, sin dejar archivo, pero esto solo funciona cuando el servidor solo habla con un único proyecto (ya sea modo de token de proyecto único, o modo de token de cuenta con exactamente un proyecto). Si estás configurado para múltiples proyectos, quédate con delivery="file" y pasa project explícitamente.

project opcional cuando hay múltiples proyectos configurados o en modo de token de cuenta. Ejemplo de prompt: Fetch the replay 789 from session abc in staging.

update-item(itemId, status?, level?, title?, assignedUserId?, resolvedInVersion?, snoozed?, teamId?, project?): Cambia el estado, nivel, título, asignado, versión resuelta, estado de silencio o equipo propietario de un elemento, para que puedas actuar sobre un elemento directamente en lugar de cambiar a la interfaz de Rollbar.

Esto necesita acceso de escritura: un token de proyecto con alcance write, o un token de cuenta con alcance tanto read como write. Un token de solo lectura fallará aquí aunque funcione bien para todas las demás herramientas. project opcional cuando hay múltiples proyectos configurados o en modo de token de cuenta. Ejemplo de prompt: Mark Rollbar item #123456 as resolved o Assign item #123456 to user ID 789.

Cómo Usar

Claude Code

Configura tu .mcp.json de la siguiente manera.

Usando una variable de entorno (proyecto único):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      }
    }
  }
}

Opcionalmente incluye ROLLBAR_API_BASE en el bloque env para apuntar a un endpoint de API que no sea de producción.

Usando un token de acceso de cuenta (todos los proyectos de la cuenta, sin necesidad de tokens por proyecto):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCOUNT_ACCESS_TOKEN": "<account access token>"
      }
    }
  }
}

Usando un archivo de configuración (proyecto único o múltiples):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_CONFIG_FILE": "/path/to/.rollbar-mcp.json"
      }
    }
  }
}

Codex CLI

Agrega a tu ~/.codex/config.toml:

[mcp_servers.rollbar]
command = "npx"
args = ["-y", "@rollbar/mcp-server@latest"]
env = { "ROLLBAR_ACCESS_TOKEN" = "<project read/write access token>" }

O con un archivo de configuración:

[mcp_servers.rollbar]
command = "npx"
args = ["-y", "@rollbar/mcp-server@latest"]
env = { "ROLLBAR_CONFIG_FILE" = "/path/to/.rollbar-mcp.json" }

Junie

Configura tu .junie/mcp/mcp.json de la siguiente manera (variable de entorno o ROLLBAR_CONFIG_FILE para archivo de configuración):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      }
    }
  }
}

Cursor

Configura los servidores MCP de Cursor (Configuración de Cursor → Características → MCP, o busca "MCP" en la configuración). Usa una variable de entorno o un archivo de configuración.

Con una variable de entorno (proyecto único):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      }
    }
  }
}

Con un archivo de configuración (proyecto único o múltiples):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_CONFIG_FILE": "/path/to/.rollbar-mcp.json"
      }
    }
  }
}

Reinicia Cursor (o recarga la ventana) después de cambiar la configuración de MCP. Para usar una compilación local en lugar de npx, consulta CONTRIBUTING.md.

VS Code (incluyendo GitHub Copilot)

Configura tu .vscode/mcp.json de la siguiente manera (variable de entorno o ROLLBAR_CONFIG_FILE para archivo de configuración):

{
  "servers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      }
    }
  }
}

O usando una instalación de desarrollo local, consulta CONTRIBUTING.md.

Este es el mismo archivo que el modo de agente de GitHub Copilot lee en VS Code. Ponlo en .vscode/mcp.json para compartir el servidor con todos en el repositorio, o en tu mcp.json de perfil de usuario (Paleta de Comandos → MCP: Abrir Configuración de Usuario) para mantener tu token fuera del repositorio. Después de guardar, inicia el servidor con MCP: Listar Servidores → rollbar → Iniciar, luego elige las herramientas a través del ícono 🛠️ en la barra de herramientas del modo agente de Copilot Chat.

GitHub Copilot CLI

Agrega a ~/.copilot/mcp-config.json. Ten en cuenta que Copilot CLI usa mcpServers (no el servers de VS Code) y escribe el transporte stdio como "type": "local":

{
  "mcpServers": {
    "rollbar": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      },
      "tools": ["*"]
    }
  }
}

O con un archivo de configuración, intercambia el bloque env por ROLLBAR_CONFIG_FILE:

{
  "mcpServers": {
    "rollbar": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_CONFIG_FILE": "/path/to/.rollbar-mcp.json"
      },
      "tools": ["*"]
    }
  }
}

tools: ["*"] habilita todas las herramientas de Rollbar; puedes limitarlo a nombres de herramientas específicos si prefieres optar explícitamente. Para limitar el servidor a un solo repositorio en lugar de toda tu cuenta, coloca el mismo JSON en .mcp.json o .github/mcp.json en la raíz del repositorio — el CLI de Copilot carga la configuración a nivel de proyecto solo después de que confirmes la confianza en la carpeta en el primer lanzamiento, y las definiciones de proyecto tienen prioridad sobre ~/.copilot/mcp-config.json.

Ejecuta /mcp dentro de una sesión interactiva (o copilot mcp list desde tu shell) para confirmar que el servidor está conectado.