Sentry MCP | MCPBro

¿Qué es Sentry MCP?

Sentry MCP es un servidor MCP de código abierto diseñado para proporcionar acceso seguro y estructurado a tus datos y acciones de Sentry a través del Protocolo de Contexto de Modelo estandarizado. Permite a las aplicaciones anfitrionas, como Claude Desktop o IDEs, interactuar programáticamente con Sentry a través de herramientas y puntos finales compatibles con MCP. Soporta transportes remotos y locales (stdio), lo que lo hace flexible para instalaciones de Sentry en la nube y autogestionadas.

Cómo Configurar

Uso en Producción:
Simplemente accede al servicio desplegado en https://mcp.sentry.dev.
Sentry Autohospedado (Transporte Stdio):
- Crea un token de autenticación de usuario de Sentry con los alcances adecuados:
```
org:read
project:read
project:write
team:read
team:write
event:write
```
- Inicia el servidor MCP:
```
npx @sentry/mcp-server@latest --access-token=sentry-user-token --host=sentry.example.com
```
- Alternativamente, configura con variables de entorno:
```
SENTRY_ACCESS_TOKEN=
SENTRY_HOST=
```
Desarrollo Local:
- Crea una aplicación OAuth en Sentry con http://localhost:5173 como la URL de inicio y URI de redireccionamiento.
- Agrega tus credenciales a .dev.vars en packages/mcp-cloudflare/:
```
SENTRY_CLIENT_ID=your_client_id
SENTRY_CLIENT_SECRET=your_client_secret
COOKIE_SECRET=my-super-secret-cookie
```
- Ejecuta el servidor localmente:
```
pnpm dev
```

Cómo Usar

Visita https://mcp.sentry.dev para el servidor alojado, o ejecuta tu instancia local/stdio como se describió anteriormente.
Usa el Inspector de MCP:
- Ingresa tu URL del servidor (por ejemplo, http://localhost:5173) y conéctate.
- Autentícate según se indique (OAuth o token de acceso).
- Descubre las herramientas disponibles a través de la función "Listar Herramientas".
- Invoca los puntos finales de herramientas deseadas (por ejemplo, obtener problemas, listar proyectos) directamente desde el Inspector o a través de un cliente compatible con LLM.
Para Sentry autohospedado, ejecuta con los tokens relevantes y conéctate en modo "stdio".
Ejecuta pruebas con pnpm test y evaluación respaldada por LLM con pnpm eval (después de establecer OPENAI_API_KEY).

Características Clave

Integración con Sentry a través de un protocolo compatible con MCP, permitiendo acceso LLM/agente a datos de errores y operaciones
Soporta transportes remotos HTTP(S) y locales stdio para flexibilidad en tipos de despliegue
Autenticación basada en OAuth y tokens para acceso seguro a los recursos de Sentry
Conjunto preconstruido de herramientas ejecutables y descubribles (acciones/puntos finales) para automatización y recuperación de datos
Extensible y abierto para desarrollo local y contribuciones
Incluye una herramienta Inspector integrada para exploración y pruebas interactivas

Casos de Uso

Permitir que agentes o copilotos basados en LLM monitoreen, obtengan o clasifiquen incidentes de Sentry en IDEs o entornos de escritorio unificados
Automatizar acciones rutinarias en Sentry como asignación de problemas, cambios de estado o notificaciones, activadas por flujos de trabajo de IA
Integrar datos de observabilidad de Sentry en paneles personalizados o herramientas de informes impulsadas por modelos de lenguaje
Permitir administración o clasificación de Sentry sin intervención a través de una API segura y estandarizada sin scripting manual

Preguntas Frecuentes

Q1: ¿Puedo usar Sentry MCP con instancias de Sentry autohospedadas?
Sí, Sentry MCP soporta instancias autohospedadas a través del modo de transporte stdio. Necesitarás proporcionar un token de autenticación de usuario con los permisos necesarios y configurar el host apropiadamente.

Q2: ¿Necesito crear una aplicación OAuth para probar Sentry MCP localmente?
Para desarrollo y pruebas locales, necesitarás registrar una aplicación OAuth en tu cuenta de Sentry y proporcionar sus credenciales en los archivos de configuración del proyecto.

Q3: ¿Pueden los LLM modificar mis datos de Sentry a través de herramientas MCP?
Sí, las herramientas expuestas a través de MCP pueden leer y modificar datos en Sentry, dependiendo de la herramienta y los permisos de tu token. Siempre restringe los tokens proporcionados a solo los alcances requeridos.

Q4: ¿Cómo puedo probar mis integraciones de servidor MCP?
Usa la herramienta Inspector integrada conectándote a la URL de tu servidor MCP. Esto permite autenticar, descubrir e invocar herramientas de forma interactiva para una verificación fácil.

Q5: ¿Qué métodos de autenticación son compatibles?
Sentry MCP soporta tanto OAuth (para servidor remoto) como flujos de autenticación basados en tokens de acceso (para local/stdio).

Nombre del Protocolo	Descripción
listProjects	Lista todos los proyectos de Sentry accesibles para el usuario autenticado, permitiendo a los LLM o clientes obtener metadatos del proyecto y seleccionar objetivos para acciones posteriores.
fetchIssues	Recupera problemas recientes o activos (errores, excepciones) de los proyectos de Sentry del usuario, opcionalmente filtrados por parámetros de consulta como rango de tiempo o estado.
assignIssue	Asigna un problema específico de Sentry a un usuario o equipo, permitiendo la clasificación automática o la asignación impulsada por flujos de trabajo de IA.
listTeams	Lista todos los equipos disponibles dentro de la organización Sentry autenticada, apoyando la colaboración o flujos de trabajo de equipo.
updateIssueStatus	Actualiza el estado de un problema específico de Sentry (por ejemplo, resolver, ignorar, no resolver) como parte de la remediación impulsada por agentes o flujos de automatización.