Cómo conectar Rollbar a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Rollbar, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Rollbar + Gemini

La monitorización de errores de Rollbar en cualquier agente de IA: items con su historial y ocurrencias, stack traces completos, los items más activos e informes de ocurrencias, la Metrics API, despliegues, entornos y versiones de código, consultas RQL y los proyectos, usuarios y equipos de la cuenta. También resuelve, silencia, asigna y pospone items, los comenta y registra despliegues.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

ROLLBAR_ACCESS_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una cuenta de Rollbar y un access token. El tipo de token que pegues decide a qué llega el conector:

1. Un proyecto: en el proyecto abre Settings, Project Access Tokens y crea o copia un project access token. Dale el scope read para leer, write para modificar items y post_server_item para registrar despliegues. Un token de proyecto siempre trabaja con su propio proyecto, pero no puede listar proyectos, usuarios ni equipos.
2. Toda la cuenta: crea en su lugar un account access token. Un service token (Settings de la cuenta, API Access Tokens, pestaña Service) llega a todos los proyectos; un personal access token (User Settings, Personal access tokens) solo puede hacer lo que puede hacer su usuario. Sus scopes son read y write. Con un token de cuenta la IA pasa project_id (de rollbar_list_projects) en las herramientas de proyecto, y rollbar_list_items busca en todos los proyectos que el token puede leer salvo que indiques project_ids.
3. Pega el token en ROLLBAR_ACCESS_TOKEN. Se envía en la cabecera X-Rollbar-Access-Token a https://api.rollbar.com/api/1.
4. Instala el conector y ejecuta rollbar_list_items para comprobar el token.

Solo un personal access token puede comentar items, y solo un token de proyecto con post_server_item puede registrar despliegues.

Qué está fallando ahora: rollbar_get_top_active_items muestra los items con más ocurrencias en las últimas horas (de 1 a 168, por defecto 24) con sus recuentos por hora, como el Top 10 del panel del proyecto. rollbar_list_items lista y busca items (errores y mensajes agrupados) por estado, nivel, entorno, framework, persona asignada, estado de pospuesto o con el mismo texto de búsqueda que la página Items. rollbar_get_item lee un item. El número de una URL de Rollbar (#123) es el counter del proyecto, no el id del item: rollbar_get_item_by_counter obtiene el item a partir de un counter o del UUID de una ocurrencia.

Investigar: rollbar_list_item_occurrences lista los eventos de un item y rollbar_list_occurrences los últimos eventos de todo el proyecto, cada uno con hora, versión de código y payload. rollbar_get_occurrence devuelve el payload completo como la vista Raw JSON: clase y mensaje de la excepción, frames del stack trace, petición, persona, servidor, cliente, datos personalizados y telemetría. rollbar_list_item_events muestra quién comentó, cambió, asignó, pospuso o fusionó un item.

Triaje: rollbar_update_item resuelve un item (opcionalmente con resolved_in_version, por ejemplo un SHA de git), lo silencia o lo reactiva, cambia su nivel o título, lo asigna a un usuario o equipo (ids de rollbar_list_users y rollbar_list_teams) o lo pospone durante un número de segundos (posponer requiere un plan de pago). rollbar_add_item_comment añade un comentario en Markdown al historial del item. Necesitan el scope write.

Tendencias y métricas: rollbar_get_occurrence_counts da las ocurrencias por minuto, hora o día, rollbar_get_activated_item_counts los items nuevos y reactivados por día y rollbar_get_item_metrics los recuentos de ocurrencias con la primera y la última ocurrencia de una lista de items. Con el plan Advanced, rollbar_query_occurrence_metrics consulta la Metrics API con filtros, agrupaciones y agregados (por ejemplo ocurrencias por entorno y día o los navegadores más frecuentes de un item), y rollbar_get_resolution_time_metrics da el tiempo de resolución de los items (mediana, media, mínimo o máximo) por periodo.

Versiones: rollbar_list_deploys, rollbar_get_deploy y rollbar_list_environments leen despliegues y entornos. rollbar_report_deploy registra el despliegue de una revisión en un entorno, y rollbar_update_deploy cierra uno registrado como iniciado (succeeded, failed o timed_out). Para ver qué rompió una versión, rollbar_get_version cuenta los items nuevos, reactivados, repetidos y resueltos de una versión de código en un entorno, y rollbar_list_version_items con event: new lista los items vistos por primera vez en ella.

RQL: para análisis puntuales la IA lanza una consulta en el lenguaje tipo SQL de Rollbar con rollbar_create_rql_job (tablas item_occurrence y deploy), consulta rollbar_get_rql_job hasta que status es success y lee las filas con rollbar_get_rql_job_result. rollbar_list_rql_jobs y rollbar_cancel_rql_job gestionan los jobs anteriores y los que están en marcha. RQL no modifica datos.

Cuenta: con un token de cuenta, rollbar_list_projects, rollbar_get_project, rollbar_list_users, rollbar_get_user y rollbar_list_teams.

Desactivadas al instalar: rollbar_request_person_deletion, que borra a una persona rastreada (el usuario final vinculado a las ocurrencias) de todos los proyectos de la cuenta, por ejemplo para una solicitud del RGPD. No se puede deshacer, así que un administrador del workspace la activa cuando hace falta; rollbar_get_person_deletion_status sigue después el job.

Formatos de datos: cada respuesta es {"err": 0, "result": ...}; err: 1 llega con un message. rollbar_report_deploy responde {"data": {"deploy_id": ...}}. Todas las marcas de tiempo son segundos Unix en GMT y los gráficos de los informes son pares [timestamp, count]. El status de un item es active, resolved, muted o archived; el level es debug, info, warning, error o critical. Las listas de ocurrencias omiten las cabeceras de la petición, las cookies y los detalles del notifier; el payload completo de rollbar_get_occurrence puede contener datos personales de tus usuarios finales.

Paginación: los items llegan de 100 en 100; ocurrencias, despliegues, entornos y eventos de items de 20 en 20 por defecto, con limit hasta 5000 donde se ofrece. Pasa page desde 1; las listas de ocurrencias también paginan con last_id. total_count es null en proyectos con más de 100.000 items.

Límites: cada token tiene su propio límite de peticiones en Rollbar; X-Rate-Limit-Remaining muestra cuántas quedan. Las herramientas de la Metrics API requieren el plan Advanced.

Errores frecuentes: 401 significa un token ausente o mal formado. 403 significa que el token está desactivado, le falta el scope, es un token de proyecto en una herramienta de cuenta o (Requires project access) es un token de cuenta sin un project_id válido. 404 es un id desconocido o de otra cuenta, 422 parámetros no válidos y 429 el límite de peticiones del token.

El conector no envía errores a Rollbar (de eso se encarga el SDK de Rollbar en tu aplicación), no borra items y no crea proyectos, equipos, usuarios ni access tokens.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Rollbar.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuáles son los errores más frecuentes en production en las últimas 24 horas, y cuáles son nuevos?"
• "Muéstrame el stack trace completo de la última ocurrencia del item #482 de Rollbar."
• "¿Qué items aparecieron por primera vez en la versión 3f9c2ab en production? Agrúpalos por nivel."
• "Marca como resuelto el item TimeoutError en la versión 1.8.3 y asigna la NullPointerException al equipo de backend."
• "¿Cuántas ocurrencias error y critical tuvimos por día esta semana frente a la semana pasada?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot