Sentry

Interactuar con la API de Sentry para monitorear errores y rendimiento de aplicaciones.

GitHub
21
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Sentry

Un servidor de Model Context Protocol (MCP) para interactuar con Sentry. Este servidor MCP proporciona herramientas para interactuar con la API de Sentry, permitiendo a los asistentes de IA recuperar y analizar datos de errores, gestionar proyectos y monitorear el rendimiento de aplicaciones.

Requisitos

  • Node.js (v14 o superior)
  • npm o yarn
  • Cuenta de Sentry con acceso a la API
  • Token de autenticación de Sentry con los permisos adecuados

Configuración

  1. Instalar dependencias: 
    npm install

Uso dentro de un IDE

Este MCP ha sido verificado para funcionar con Codeium Windsurf.

Cursor actualmente tiene problemas con su implementación de MCP; y esta herramienta aún no es completamente funcional.

Uso con Claude

Para usar este servidor MCP con Claude, añade la siguiente configuración a tu configuración de Claude:

{
    "mcpServers": {
        "sentry": {
            "command": "npx",
            "args": ["ts-node", "/Users/<your-user-directory>/mcp-sentry-ts/index.ts"],
            "env": {
                "SENTRY_AUTH": "<YOUR_AUTH_TOKEN>"
            }
        }
    }
}
  • Actualiza con la ruta de tu directorio en el campo args.
  • Reemplaza <YOUR_AUTH_TOKEN> con tu token de autenticación de Sentry.

Herramientas Disponibles

list_projects

Lista todos los proyectos de Sentry accesibles para una organización determinada.

Parámetros:

  • organization_slug (string, obligatorio): El slug de la organización de la que listar proyectos
  • view (string, opcional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

resolve_short_id

Recupera detalles sobre un issue usando su ID corto.

Parámetros:

  • organization_slug (string, obligatorio): El slug de la organización a la que pertenece el issue
  • short_id (string, obligatorio): El ID corto del issue a resolver (ej., PROJECT-123)
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

get_sentry_event

Recupera y analiza un evento específico de Sentry de un issue.

Parámetros:

  • issue_id_or_url (string, obligatorio): Ya sea una URL completa del issue de Sentry o solo el ID numérico del issue
  • event_id (string, obligatorio): El ID del evento específico a recuperar
  • view (string, opcional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

list_error_events_in_project

Lista eventos de error de un proyecto específico de Sentry.

Parámetros:

  • organization_slug (string, obligatorio): El slug de la organización a la que pertenece el proyecto
  • project_slug (string, obligatorio): El slug del proyecto del que listar eventos
  • view (string, opcional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

create_project

Crea un nuevo proyecto en Sentry y recupera sus claves de cliente.

Parámetros:

  • organization_slug (string, obligatorio): El slug de la organización en la que crear el proyecto
  • team_slug (string, obligatorio): El slug del equipo al que asignar el proyecto
  • name (string, obligatorio): El nombre del nuevo proyecto
  • platform (string, opcional): La plataforma para el nuevo proyecto
  • view (string, opcional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

list_project_issues

Lista issues de un proyecto específico de Sentry.

Parámetros:

  • organization_slug (string, obligatorio): El slug de la organización a la que pertenece el proyecto
  • project_slug (string, obligatorio): El slug del proyecto del que listar issues
  • view (string, opcional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

list_issue_events

Lista eventos de un issue específico de Sentry.

Parámetros:

  • organization_slug (string, obligatorio): El slug de la organización a la que pertenece el issue
  • issue_id (string, obligatorio): El ID del issue del que listar eventos
  • view (string, opcional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

get_sentry_issue

Recupera y analiza un issue de Sentry.

Parámetros:

  • issue_id_or_url (string, obligatorio): Ya sea una URL completa del issue de Sentry o solo el ID numérico del issue
  • view (string, opcional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

list_organization_replays

Lista replays de una organización específica de Sentry.

Parámetros:

  • organization_slug (string, obligatorio): El slug de la organización de la que listar replays
  • project_ids (string[], opcional): Lista de IDs de proyectos para filtrar replays
  • environment (string, opcional): Entorno para filtrar replays
  • stats_period (string, opcional): Período de tiempo para estadísticas (ej., "24h", "7d")
  • start (string, opcional): Fecha de inicio para filtrar replays
  • end (string, opcional): Fecha de fin para filtrar replays
  • sort (string, opcional): Campo por el que ordenar replays
  • query (string, opcional): Consulta de búsqueda para filtrar replays
  • per_page (number, opcional): Número de replays por página
  • cursor (string, opcional): Cursor para paginación
  • view (string, opcional): Tipo de vista, ya sea "summary" o "detailed" (por defecto: "detailed")
  • format (string, opcional): Formato de salida, ya sea "plain" o "markdown" (por defecto: "markdown")

Ejecutar el Servidor

npx ts-node index.ts

Autenticación

Esta herramienta requiere un token de autenticación de Sentry con los permisos adecuados para acceder a la API de Sentry. Puedes generar un token en la configuración de tu cuenta de Sentry bajo "API Keys".

Manejo de Errores

El servidor incluye un manejo integral de errores para:

  • Token de autenticación faltante
  • Fallos en solicitudes a la API
  • Parámetros inválidos
  • Errores de red

Todos los errores se registran en la consola para depuración.