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

Por qué usarlo

Características clave

De primera parte — publicado por Sentry, sigue su modelo de autenticación
Filtra problemas por versión, entorno, impacto en el usuario, antigüedad
Stacktrace completo + rastros para cualquier evento
Solo lectura por defecto — no resolverá problemas accidentalmente

Demo en vivo

Cómo se ve en la práctica

sentry.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": {
      "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": {
      "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": {
      "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": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sentry",
      "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": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

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

claude mcp add sentry -- 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

Clasifica un incidente reciente en producción en 5 minutos

👤 Ingenieros de guardia ⏱ ~5 min intermediate

Cuándo usarlo: PagerDuty acaba de despertarte. Sentry dice que los errores están aumentando. Necesitas saber qué pasó, por qué, y si debes revertir — rápido.

Requisitos previos

Slug de organización de Sentry + slug de proyecto — Mira cualquier URL de Sentry: sentry.io/organizations/<ORG>/issues/?project=<ID>
Token de autenticación de usuario de Sentry con event:read y project:read — sentry.io/settings/account/api/auth-tokens/

Flujo

Encuentra el problema NUEVO principal en la última hora

¿Cuál es el problema nuevo principal en nuestro proyecto web-prod en la última hora, ordenado por conteo de eventos?✓ Copiado

→ Problema único con título, conteo de eventos, usuarios afectados, marca de tiempo de primer visto
Extrae el evento más reciente con stacktrace completo + rastros

Obtén el evento más reciente para ese problema. Muéstrame el stacktrace, la versión, y los últimos 5 rastros antes del fallo.✓ Copiado

→ Archivo:línea de la función que lanza la excepción + secuencia de acciones del usuario antes del error
Identifica la versión que la introdujo

¿Fue este problema visto por primera vez en la misma versión en que apareció, o continuó de una anterior? Compara la etiqueta de versión.✓ Copiado

→ Sí/no con confianza — impulsa la decisión de revertir

Resultado: Resumen de incidente de 3 líneas que puedas pegar en Slack: qué está roto, quién está afectado, qué versión lo causó, acción recomendada.

Errores comunes

Si tus etiquetas de versión no están configuradas, no puedes saber qué despliegue introdujo el error — Configura sentry-cli releases en tu CI antes de confiar en esto — sin ello, estás adivinando
El stacktrace está en JS minificado e ilegible — Verifica que los sourcemaps se hayan subido — sentry-cli sourcemaps upload debe estar en tu pipeline de construcción

Combinar con: github · linear

Realiza referencias cruzadas de errores de Sentry con los commits de GitHub que los causaron

👤 Ingenieros senior depurando problemas recurrentes ⏱ ~30 min advanced

Cuándo usarlo: Un error sigue reapareciendo después de cada versión. Sospechas de una ruta de código específica pero quieres confirmarlo.

Requisitos previos

Tanto MCP de Sentry como MCP de GitHub instalados — Consulta la guía de github para la configuración
Versiones etiquetadas con SHA de git en Sentry — Usa sentry-cli releases new $SHA en CI

Flujo

Lista el historial del problema en todas las versiones

Para el problema de Sentry WEB-3a91, lista cada versión donde apareció y el conteo de eventos por versión.✓ Copiado

→ Tabla mostrando el problema aumentando después de despliegues específicos
Para cada pico, obtén el diff

Para las 3 versiones con el mayor conteo de eventos, usa el MCP de GitHub para obtener el diff de commits. ¿Qué archivos cambió cada versión?✓ Copiado

→ Archivos comunes en los picos — la evidencia definitiva
Forma una hipótesis de causa raíz

Basándote en esos diffs, ¿cuál es la causa raíz más probable? Sé específico — apunta a la(s) línea(s).✓ Copiado

→ Teoría a nivel de línea que puedas validar revisando el código

Resultado: Una hipótesis específica a nivel de código respaldada por evidencia de eventos de Sentry y diffs de GitHub.

Errores comunes

Múltiples commits en una versión — difícil aislar cuál es responsable — Usa un estilo git bisect: despliega una construcción con solo la mitad de los commits y verifica si la tasa de errores baja

Combinar con: github

Genera un informe semanal de calidad de ingeniería a partir de datos de Sentry

👤 Gerentes de ingeniería ⏱ ~20 min intermediate

Cuándo usarlo: Viernes por la tarde, antes de la planificación de la próxima semana. Quieres saber si la calidad está mejorando o empeorando.

Requisitos previos

Acceso de lectura a todos tus proyectos en Sentry — Token con alcance a org:read + project:read + event:read

Flujo

Extrae conteos de errores y sesiones sin fallo de la semana

Para nuestra organización, dame el % de sesiones sin fallo por proyecto para esta semana vs la semana pasada. Marca cualquier proyecto donde bajó.✓ Copiado

→ Comparación por proyecto con deltas
Identifica los principales contribuyentes al volumen de errores

¿Cuáles son los 5 problemas responsables de la mayoría de eventos esta semana, en todos los proyectos?✓ Copiado

→ Lista de problemas concretos con conteos de eventos y enlaces
Sugiere el enfoque para la próxima semana

Basándote en estos datos, ¿qué debería priorizar el equipo para arreglar la próxima semana? Considera tanto el volumen como el impacto en el usuario.✓ Copiado

→ 3 recomendaciones priorizadas con razonamiento

Resultado: Informe de 1 página que puedas compartir en tu revisión semanal de ingeniería con prioridades concretas.

Errores comunes

Las métricas de volumen están dominadas por un problema ruidoso, enmascarando todo lo demás — Filtra ese problema y re-ordena — a veces el más ruidoso no es el más importante

Combinar con: linear · notion

Cuantifica el impacto en el usuario de un error conocido antes de decidir si arreglarlo

👤 Gerentes de producto, líderes técnicos triando el backlog de errores ⏱ ~15 min beginner

Cuándo usarlo: Hay un error conocido y el equipo está debatiendo la prioridad. Necesitas datos, no opiniones.

Flujo

Extrae las estadísticas de impacto en el usuario del problema

Para el problema de Sentry WEB-3a91, ¿cuántos usuarios únicos lo han experimentado en los últimos 30 días, y qué % de usuarios activos totales es eso?✓ Copiado

→ Conteo absoluto + porcentaje
Segmenta los usuarios afectados

Entre los usuarios afectados, ¿cuál es la distribución por navegador, sistema operativo, y nivel de cuenta (pagado vs gratuito)?✓ Copiado

→ Desglose que revela si es un problema de caso extremo o de flujo principal
Compara con otros problemas abiertos

Ordena nuestros 10 principales errores abiertos por usuarios-afectados este mes. ¿Dónde se sitúa éste?✓ Copiado

→ Contexto para la priorización

Resultado: Recomendación de prioridad impulsada por datos: arregla ahora, arregla esta semana, o difiere.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

sentry + github

Sentry → identifica versión problemática → GitHub → encuentra el commit que la introdujo → redacta PR de reversión

El problema WEB-3a91 aumentó después de la versión [email protected]. Encuentra los commits en esa versión en GitHub, identifica el culpable más probable, y redacta una PR de reversión.✓ Copiado

sentry + linear

Crea automáticamente problemas de Linear a partir de problemas nuevos de Sentry que excedan un umbral de eventos

Encuentra cualquier problema nuevo de Sentry de las últimas 24h con >100 eventos. Para cada uno, crea un ticket de error de Linear asignado al ingeniero de guardia.✓ Copiado

sentry + notion

Informe semanal de calidad de ingeniería publicado en Notion

Extrae las estadísticas de Sentry de esta semana y crea una página en Notion en la base de datos Ingeniería / Informes Semanales.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_issues	organization, project, query?, sort?, limit?	Busca en el flujo de problemas por estado/versión/entorno/antigüedad	1 API call
get_issue	issue_id	Obtén metadatos completos para un problema específico incluyendo rango de versión	1 API call
get_event	issue_id, event_id?	Extrae el stacktrace y rastros reales para depuración	1 API call
list_releases	organization, project	Ve la línea de tiempo de despliegue y qué versión introdujo qué	1 API call
list_projects	organization	Descubre qué proyectos existen en tu organización	1 API call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Sentry: 40 req/seg por token (muy generoso). Sin límite diario en la API misma.
Tokens por llamada: 200–1000 tokens por respuesta de problema/evento; los stacktraces grandes pueden alcanzar 5k
Monetario: Nivel gratuito: 5k errores/mes. Los planes pagos se facturan por volumen de eventos, no por uso de API.
Consejo: La API es gratuita; lo que realmente pagas es la ingesta de eventos. Usa reglas de muestreo en Sentry mismo para mantener los costos de ingesta predecibles.

Seguridad

Permisos, secretos, alcance

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

Almacenamiento de credenciales: Token de autenticación de usuario de Sentry en la variable de entorno SENTRY_AUTH_TOKEN

Salida de datos: Todas las llamadas a tu instancia de Sentry (sentry.io o autohospedada)

No conceder nunca: org:write project:admin member:write

Resolución de problemas

Errores comunes y soluciones

401 Token inválido

El token expiró o no tiene los alcances solicitados. Recrea en sentry.io/settings/account/api/auth-tokens/

Verificar: curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" https://sentry.io/api/0/organizations/

404 Proyecto no encontrado

El slug del proyecto distingue entre mayúsculas y minúsculas y debe coincidir exactamente con la URL. Comprueba sentry.io/settings/projects/

Stacktrace vacío

Los sourcemaps no se subieron. Ejecuta sentry-cli sourcemaps upload como parte de tu pipeline de construcción.

Alternativas

Sentry vs otros

Alternativa	Cuándo usarla	Contrapartida
Datadog APM MCP	Ya estás en Datadog y quieres APM + errores unificados	Más caro, menos enfocado en errores específicamente
Rollbar / Bugsnag MCP	Ya pagas por ellos	Ecosistema MCP construido por la comunidad más pequeño

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills