Servidor Sentry MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con Sentry. Este servidor MCP proporciona herramientas para interactuar con la API de Sentry, lo que permite a los asistentes de IA recuperar y analizar datos de errores, gestionar proyectos y supervisar el rendimiento de las aplicaciones.

Requisitos

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

Configuración

1. Instalar dependencias:
   npm install

Usando esto dentro de un IDE

Se ha verificado que este MCP funciona contra Codeium Windsurf.

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

Usando con Claude

Para utilizar este servidor MCP con Claude, agregue la siguiente configuración a la configuración de Claude:

• Actualice con su ruta de directorio en el campo args .
• Reemplace <YOUR_AUTH_TOKEN> con su token de autenticación Sentry.

Herramientas disponibles

lista_proyectos

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

Parámetros:

• organization_slug (cadena, obligatoria): El slug de la organización de la que se listarán los proyectos
• view (cadena, opcional): tipo de vista, ya sea "resumen" o "detallada" (predeterminado: "detallada")
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

resolver_id_corto

Recupera detalles sobre un problema utilizando su ID corta.

Parámetros:

• organization_slug (cadena, obligatoria): El slug de la organización a la que pertenece el problema
• short_id (cadena, obligatoria): el ID corto del problema a resolver (por ejemplo, PROYECTO-123)
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

obtener_evento_centinela

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

Parámetros:

• issue_id_or_url (cadena, obligatoria): una URL de problema de Sentry completa o solo el ID de problema numérico
• event_id (cadena, obligatoria): el ID de evento específico que se recuperará
• view (cadena, opcional): tipo de vista, ya sea "resumen" o "detallada" (predeterminado: "detallada")
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

lista_de_eventos_de_error_en_proyecto

Enumera los eventos de error de un proyecto Sentry específico.

Parámetros:

• organization_slug (cadena, obligatoria): El slug de la organización a la que pertenece el proyecto
• project_slug (cadena, obligatoria): El slug del proyecto del que se listarán los eventos
• view (cadena, opcional): tipo de vista, ya sea "resumen" o "detallada" (predeterminado: "detallada")
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

crear_proyecto

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

Parámetros:

• organization_slug (cadena, obligatoria): El slug de la organización en la que se creará el proyecto
• team_slug (cadena, obligatoria): El slug del equipo al que se asignará el proyecto
• name (cadena, obligatorio): el nombre del nuevo proyecto
• platform (cadena, opcional): La plataforma para el nuevo proyecto
• view (cadena, opcional): tipo de vista, ya sea "resumen" o "detallada" (predeterminado: "detallada")
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

lista_de_problemas_del_proyecto

Enumera los problemas de un proyecto Sentry específico.

Parámetros:

• organization_slug (cadena, obligatoria): El slug de la organización a la que pertenece el proyecto
• project_slug (cadena, obligatoria): El slug del proyecto del que se listarán los problemas
• view (cadena, opcional): tipo de vista, ya sea "resumen" o "detallada" (predeterminado: "detallada")
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

lista_de_eventos_de_problemas

Enumera eventos para un problema específico de Sentry.

Parámetros:

• organization_slug (cadena, obligatoria): El slug de la organización a la que pertenece el problema
• issue_id (cadena, obligatoria): El ID del problema del que se listarán los eventos
• view (cadena, opcional): tipo de vista, ya sea "resumen" o "detallada" (predeterminado: "detallada")
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

obtener_problema_de_sentry

Recupera y analiza un problema de Sentry.

Parámetros:

• issue_id_or_url (cadena, obligatoria): una URL de problema de Sentry completa o solo el ID de problema numérico
• view (cadena, opcional): tipo de vista, ya sea "resumen" o "detallada" (predeterminado: "detallada")
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

lista_organización_repeticiones

Enumera las repeticiones de una organización Sentry específica.

Parámetros:

• organization_slug (cadena, obligatoria): El slug de la organización desde la que se listarán las repeticiones
• project_ids (string[], opcional): Lista de ID de proyectos para filtrar repeticiones
• environment (cadena, opcional): entorno por el cual filtrar las repeticiones
• stats_period (cadena, opcional): período de tiempo para las estadísticas (por ejemplo, "24 h", "7 d")
• start (cadena, opcional): fecha de inicio para filtrar repeticiones
• end (cadena, opcional): fecha de finalización para filtrar repeticiones
• sort (cadena, opcional): Campo para ordenar las repeticiones por
• query (cadena, opcional): consulta de búsqueda para filtrar repeticiones
• per_page (número, opcional): Número de repeticiones por página
• cursor (cadena, opcional): Cursor para paginación
• view (cadena, opcional): tipo de vista, ya sea "resumen" o "detallada" (predeterminado: "detallada")
• format (cadena, opcional): formato de salida, ya sea "simple" o "markdown" (predeterminado: "markdown")

Ejecución del servidor

Autenticación

Esta herramienta requiere un token de autenticación de Sentry con los permisos adecuados para acceder a la API de Sentry. Puede generar un token en la configuración de su cuenta de Sentry, en "Claves API".

Manejo de errores

El servidor incluye un manejo integral de errores para:

• Token de autenticación faltante
• Errores en las solicitudes de API
• Parámetros no válidos
• Errores de red

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