Raygun

✨ Características principales

• 🐛 Gestión de errores - Investiga, resuelve y rastrea errores y fallos de aplicaciones con trazas de pila completas y contexto
• 🚀 Seguimiento de despliegues - Supervisa versiones y correlaciona errores con despliegues para identificar cambios problemáticos
• ⚡ Información de rendimiento - Analiza tiempos de carga de páginas, métricas de usuarios y tendencias de rendimiento a lo largo del tiempo
• 🔬 Investigación de APM - Encuentra puntos críticos del backend, problemas de rendimiento recurrentes y trazas lentas
• 👥 Monitoreo de usuarios - Rastrea sesiones de clientes, patrones de comportamiento e identifica usuarios afectados
• 🤝 Colaboración en equipo - Gestiona invitaciones y coordina la resolución de errores en tu equipo
• 📊 Métricas y análisis - Análisis de series temporales e histogramas de distribución para errores y rendimiento

📋 Requisitos

• Una cuenta de Raygun con una suscripción activa
• Un cliente MCP con soporte OAuth, o un Token de Acceso Personal de Raygun

🚀 Primeros pasos

El servidor MCP de Raygun está alojado en:

https://api.raygun.com/v3/mcp

Raygun aloja y actualiza el servicio, por lo que no hay paquete ni servidor local que instalar.

OAuth (recomendado)

Añade la URL como un servidor HTTP Streamable sin un encabezado Authorization. En la primera conexión, tu cliente MCP abrirá Raygun en tu navegador para que puedas iniciar sesión, seleccionar un plan, revisar los permisos solicitados y autorizar el acceso.

No necesitas proporcionar un ID de cliente OAuth ni un secreto de cliente. Raygun admite el registro automático de clientes.

codex mcp add raygun --url https://api.raygun.com/v3/mcp
codex mcp login raygun

claude mcp add --transport http raygun https://api.raygun.com/v3/mcp

{
  "mcpServers": {
    "raygun": {
      "url": "https://api.raygun.com/v3/mcp"
    }
  }
}

{
  "servers": {
    "raygun": {
      "type": "http",
      "url": "https://api.raygun.com/v3/mcp"
    }
  }
}

Token de Acceso Personal

La autenticación con PAT sigue siendo compatible para clientes sin soporte MCP OAuth y para automatización. El siguiente ejemplo utiliza el formato de configuración de Cursor; otros clientes usan el mismo encabezado Authorization en su configuración de servidor HTTP:

{
  "mcpServers": {
    "raygun": {
      "url": "https://api.raygun.com/v3/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PAT_TOKEN"
      }
    }
  }
}

💬 Tu primer mensaje

Después de la configuración, intenta preguntar a tu asistente de IA:

• "Encuentra los errores que aparecieron por primera vez después del último despliegue de mi aplicación de pago."
• "Investiga el error de producción más frecuente y muéstrame una traza de pila representativa."
• "¿Qué métodos del backend o consultas de base de datos consumieron más tiempo en las últimas 24 horas?"
• "Muéstrame la última sesión del cliente user@example.com y explica dónde falló su experiencia."
• "Compara el rendimiento de página p95 durante los últimos siete días e identifica la mayor regresión."

🛠️ Herramientas

El servidor MCP de Raygun proporciona las siguientes categorías de herramientas:

Para documentación detallada sobre cada herramienta, consulta la Referencia de herramientas.

🔐 Autenticación

OAuth

Raygun implementa el flujo de autorización MCP para clientes HTTP. El servidor anuncia su servidor de autorización a través de Metadatos de Recursos Protegidos OAuth, y los clientes compatibles se registran automáticamente mediante Documentos de Metadatos de ID de Cliente o Registro Dinámico de Clientes.

El acceso está vinculado al usuario de Raygun, al plan y a los alcances aprobados en la pantalla de consentimiento. Los clientes compatibles almacenan y actualizan sus propios tokens de forma segura.

Cada conexión OAuth otorga acceso a un plan de Raygun. Añade otra configuración MCP de Raygun y autorízala por separado cuando necesites trabajar con un plan diferente.

Seguridad y acceso

• OAuth nunca otorga al cliente más acceso del que ya tiene el usuario de Raygun con sesión iniciada.
• El acceso de lectura y escritura está controlado por los alcances aprobados durante OAuth o asignados al PAT.
• Algunas herramientas pueden cambiar datos de Raygun, incluidos estados de errores, despliegues, invitaciones, comentarios y claves de API de ingesta. Revisa las acciones de escritura antes de aprobarlas en tu cliente MCP.
• Las herramientas de aplicaciones pueden devolver o rotar claves de API de ingesta. Trata las claves devueltas como credenciales; rotar una clave invalida inmediatamente la anterior.
• Los resultados de las herramientas pueden incluirse en conversaciones procesadas por tu cliente de IA o proveedor de modelos elegido. Sigue las políticas de tu organización para compartir datos de diagnóstico y de clientes.

Obtención de un Token de Acceso Personal

Los PAT siguen disponibles cuando OAuth no es adecuado:

1. Navega a Tokens de Acceso Personal de Raygun
2. Haz clic en Crear nuevo token
3. Dale a tu token un nombre descriptivo (por ejemplo, "Acceso al servidor MCP")
4. Selecciona los permisos adecuados para tu caso de uso
5. Copia el token generado y envíalo como Authorization: Bearer YOUR_PAT_TOKEN

Mantén los PAT seguros y nunca los confirmes en el control de versiones.

Para más detalles, consulta la documentación de la API de Raygun.

📖 Acerca de

El servidor MCP de Raygun permite a los asistentes de IA investigar datos de Crash Reporting, RUM y APM; rastrear despliegues; analizar rendimiento; y gestionar el monitoreo de aplicaciones mediante conversaciones en lenguaje natural.

🔗 Recursos

• 📚 Documentación de Raygun
• 📘 Guía de configuración de Raygun MCP
• 🔌 Referencia de la API de Raygun
• 🤖 Protocolo de Contexto de Modelo
• 🐛 Reportar problemas