Triaje de errores de Sentry hecho por un empleado de IA con Claude Code o Codex

Qué hace el empleado

• Lee las issues de Sentry sin resolver que son nuevas o han vuelto a aparecer desde su última ejecución.
• Elimina duplicados contrastando con tu tablero, así un error ruidoso recibe un comentario y no diez issues nuevas.
• Registra una issue útil: impacto, primera y última aparición, la versión en la que empezó, los primeros frames del stack y una causa probable, claramente marcada como hipótesis.
• Asigna una prioridad según reglas que escribes tú, por ejemplo que todo lo que bloquee el registro o los pagos es urgente.
• Arregla los obvios: una comprobación de null, una clave de traducción que falta, una redirección mal hecha. Abre una pull request con un test y espera la revisión.

Cómo configurar el triaje de Sentry con Claude Code o Codex

1. Conecta el servidor MCP de Sentry

   Sentry aloja un servidor MCP en mcp.sentry.dev con OAuth, así que no hay nada que instalar ni ningún token que pegar. Añádelo, arranca el agente e inicia sesión en Sentry cuando te lo pida. Le da al agente las issues, los errores, los proyectos y el análisis de Seer de Sentry.

   # Claude Code: añade el servidor MCP alojado de Sentry y luego inicia sesión con OAuth
   claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
   
   # Codex: a través del puente mcp-remote
   codex mcp add sentry -- npx -y mcp-remote@latest https://mcp.sentry.dev/mcp

2. Copia el brief del rol

   En CLAUDE.md para Claude Code o en AGENTS.md para Codex, en el repositorio del que vienen los errores, para que pueda leer el código que hay detrás de cada frame del stack.

   # Rol: triaje de errores
   Se ejecuta desde la issue recurrente "Triaje de Sentry", los días laborables a las 9:00 y a las 14:00.
   
   1. En Sentry, lista las issues sin resolver vistas por primera vez o que han
      vuelto a aparecer desde la última ejecución, en el entorno de producción.
   2. Para cada una: busca en el tablero si ya hay una issue (busca el ID
      de la issue de Sentry). Si la hay, añade el nuevo recuento como comentario.
   3. Si no, abre una issue: título a partir del error, usuarios y eventos
      afectados, primera y última aparición, los primeros frames del stack, la versión
      en la que empezó y tu mejor hipótesis sobre la causa, marcada como hipótesis.
   4. Prioridad: Urgent si bloquea el registro, los pagos o los datos; High si
      afecta a más del 1% de las sesiones; si no, Medium.
   5. Si el arreglo es pequeño y obvio, tómalo como tu siguiente issue y
      abre una pull request con un test. No hagas merge.
   6. Nunca resuelvas, ignores ni borres nada en Sentry por tu cuenta.

3. Ponlo en un horario

   Convierte el triaje en una issue recurrente, por ejemplo --repeat "weekdays at 9:00", y añade otra por la tarde si tu volumen de errores lo pide.

4. Revisa los arreglos

   Las pull requests con arreglos pasan por tu revisión habitual. Cuando el empleado no está seguro del impacto o de a quién le corresponde, marca la issue como Requiere acción y pregunta.

Fuente: documentación del servidor MCP de Sentry

Reglas que lo mantienen seguro

• Lee Sentry, escribe en el tablero. Resolver, ignorar o borrar en Sentry queda en manos de personas.
• Solo producción: apúntalo a tu entorno de producción para que no registre el ruido de staging.
• Una hipótesis es una hipótesis: la causa de cada issue se marca como hipótesis hasta que alguien la confirme.
• Nada de merges: los arreglos son pull requests con un test, nunca pushes directos.
• Datos personales: los eventos de Sentry pueden incluir datos de usuarios; limita la issue a recuentos e IDs, sin emails ni IPs.

Paso a paso con Claude Code y Codex

Los comandos integrados, las herramientas que conectar y el horario de cada agente: Sentry con Claude Code y Sentry con Codex.

Un ingeniero que empieza el día con tus errores

El triaje es una issue recurrente natural para un ingeniero de software de IA. Crewmark convierte tu Claude Code o Codex en ese empleado, con horario laboral y un heartbeat.

1. Empieza por el rol

   El ingeniero de software de IA toma issues de un tablero y abre pull requests.

2. Añade el triaje como issue recurrente

   Hace el triaje cuando toca y después avanza con las issues que ha registrado.

3. Más trabajos de ingeniería

   Consulta Claude Code para ingeniería y revisión de código con IA en cada pull request.

Preguntas frecuentes