Sentry MCP — Casos de uso, Instalar & Demo en vivo

Name: Sentry MCP MCP Server
Author: getsentry

Por qué usarlo

Características clave

Búsqueda de incidencias con la sintaxis de consultas de Sentry
Obtener el payload completo de un evento: stack trace, breadcrumbs, solicitud, etiquetas
Estado de lanzamientos: detección de regresiones, adopción, tasa libre de crashes
Trazas de rendimiento con desglose de spans
Metadatos de proyectos y equipos para consultas entre proyectos

Demo en vivo

Cómo se ve en la práctica

sentry-mcp-getsentry.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sentry-mcp-getsentry",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "sentry-mcp-getsentry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add sentry-mcp-getsentry -- npx -y @sentry/mcp-server

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Sentry MCP

Depurar un error de producción de principio a fin sin salir de Claude

👤 Desarrolladores triando alertas de guardia ⏱ ~20 min intermediate

Cuándo usarlo: Se dispara una alerta en Sentry; necesitas la causa raíz ahora.

Requisitos previos

Token de autenticación de Sentry — Ajustes de usuario → Tokens de auth → crear con 'project:read', 'event:read', 'org:read'
Token en el entorno — Set SENTRY_AUTH_TOKEN and SENTRY_HOST (sentry.io or self-hosted)

Flujo

Encontrar la incidencia

Use sentry-mcp. Find the most-firing issue in project 'web' from the last 6 hours.✓ Copiado

→ ID de incidencia + conteo + primera/última vez vista
Obtener el contexto completo

Get the latest event for that issue — stack trace, breadcrumbs, request data.✓ Copiado

→ Payload completo del evento con frames + rastro de acciones del usuario
Correlacionar con el despliegue

What release was running when this first appeared? List the commits in that release.✓ Copiado

→ Etiqueta de lanzamiento + lista de commits
Proponer corrección

Looking at the stack and the commits — which commit likely caused this? Draft a fix in the relevant file.✓ Copiado

→ Archivo + línea específicos referenciados; parche concreto

Resultado: De la alerta a un candidato de corrección en minutos, con cadena completa de evidencia.

Errores comunes

Source maps faltantes — los frames del stack no son útiles — Verifica la carga de source maps en tus lanzamientos de Sentry; sin ellos los frames minificados no dan información a Claude

Combinar con: github

Verificación antes de promover un lanzamiento

👤 Ingenieros de lanzamientos, guardianes del despliegue ⏱ ~15 min intermediate

Cuándo usarlo: A punto de promover un lanzamiento canario al 100%.

Flujo

Comparar estado de lanzamientos

Use sentry-mcp. Compare crash-free rate of release 1.4.0 vs 1.3.9 over their respective canary windows.✓ Copiado

→ Tasa libre de crashes por lanzamiento, adopción, conteo de regresiones
Verificar nuevos errores

List any issues unique to 1.4.0 (not seen in 1.3.9 or earlier).✓ Copiado

→ Lista de nuevas incidencias con conteos
Recomendar

Given crash-free is X% and N net-new errors, recommend ship/halt with reason.✓ Copiado

→ Recomendación clara con umbrales señalados

Resultado: Decisión de promover/detener basada en datos, no en intuición.

Errores comunes

Adopción demasiado baja para ser estadísticamente significativa — Claude debe marcar las ventanas de baja adopción como no concluyentes — no fingir que sabe

Investigar una regresión de rendimiento usando trazas de transacciones

👤 Ingenieros de backend en busca de latencia ⏱ ~25 min advanced

Cuándo usarlo: La latencia p95 en /checkout subió después del último despliegue.

Flujo

Obtener una traza lenta reciente

Use sentry-mcp. Get a trace for transaction 'POST /checkout' with duration > 2s from the last hour.✓ Copiado

→ Traza con desglose de spans
Encontrar el nuevo span

Compare span list to a similar trace from last week. Which spans are new or longer?✓ Copiado

→ Diferencia: nueva consulta DB 'SELECT cart_items', promedio 1,4 s
Vincular con el código

What commit added that query? Suggest an index or a query rewrite.✓ Copiado

→ Commit + propuesta de corrección concreta

Resultado: Causa raíz de una regresión de rendimiento, con propuesta de corrección a nivel de código.

Errores comunes

Tasa de muestreo de trazas demasiado baja — no se captura ninguna traza lenta — Aumenta temporalmente la tasa de muestreo, o pide a Claude que use los endpoints de estadísticas en su lugar

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

sentry-mcp-getsentry + github

Desde un frame del stack de Sentry directamente a un borrador de PR

Pull issue X from Sentry, find the offending commit via GitHub, draft a fix as a new branch + PR.✓ Copiado

sentry-mcp-getsentry + linear

Crear tickets de ingeniería automáticamente a partir de regresiones

For each new release-blocking issue in Sentry, create a Linear ticket with the stack + suggested owner.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
search_issues	project, query, statsPeriod?	Filtrar incidencias por consulta de Sentry	1 Sentry API call
get_issue	issue_id	Vista general de una incidencia	1 API call
get_event	event_id or 'latest'	Obtener una ocurrencia específica con contexto completo	1 API call
list_releases	project, version?	Comparación entre lanzamientos	1 API call
get_trace	trace_id	Investigación de rendimiento	1 API call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Límites estándar de la API de Sentry — las ráfagas pueden generar errores 429
Tokens por llamada: El payload de un evento puede ser 5–20 k tokens — obtén selectivamente
Monetario: Gratuito para el plan developer de Sentry; planes de pago tienen límites más altos
Consejo: Usa search_issues para acotar primero; solo llama get_event en los candidatos — no en listas completas de resultados

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: project:read event:read org:read

Almacenamiento de credenciales: Variable de entorno SENTRY_AUTH_TOKEN (usa un token acotado por proyecto)

Salida de datos: Todas las llamadas a tu host de Sentry (sentry.io o auto-alojado)

No conceder nunca: project:write o org:write a un agente dirigido por chat

Los datos de eventos pueden contener datos personales (PII) (cuerpos de solicitudes, IDs de usuario) — aplica las reglas de depuración de datos de Sentry en origen

Resolución de problemas

Errores comunes y soluciones

401 Unauthorized

Token caducado o scope incorrecto — regenera con los scopes de lectura indicados

Verificar: curl -H 'Authorization: Bearer $SENTRY_AUTH_TOKEN' $SENTRY_HOST/api/0/projects/

El stack trace muestra solo frames minificados

Verifica la carga de source maps en tu pipeline de lanzamiento; sin mapas, Claude no puede razonar sobre los frames

Verificar: Sentry UI → Release → Artifacts

404 en una incidencia conocida

La incidencia está en un proyecto que el token no cubre — reacota el token a ese proyecto

Sentry auto-alojado — conexión rechazada

Define SENTRY_HOST explícitamente con la URL de tu instancia incluyendo el protocolo

Verificar: curl $SENTRY_HOST/api/0/

Alternativas

Sentry MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
Datadog MCP	Tu equipo usa Datadog APM/seguimiento de errores	Cobertura diferente; orientado a APM, menos centrado en incidencias
Honeycomb MCP	Eres un equipo que prioriza la observabilidad basada en eventos, no en stack traces	Sin agrupación de incidencias de primer nivel; centrado en trazas

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills