Casos de uso · Engenharia

Triagem de erros do Sentry por um funcionário de IA no Claude Code ou no Codex

Erros novos se acumulam no Sentry mais rápido do que alguém consegue ler. Um funcionário de IA no seu próprio Claude Code ou Codex pode conferir o Sentry com agendamento, pular o que já está no quadro, registrar cada erro novo como issue com a stack trace, os usuários afetados e uma causa provável, e pegar as correções pequenas ele mesmo, abrindo um pull request para revisão. Veja como conectar o servidor MCP do Sentry, o brief para copiar e as regras que mantêm tudo seguro.

O que o funcionário faz

  • Lê as issues não resolvidas do Sentry que são novas ou voltaram desde a última execução.
  • Elimina duplicatas com base no seu quadro, então um erro barulhento ganha um comentário, não dez issues novas.
  • Registra uma issue útil: impacto, primeira e última ocorrência, a versão em que começou, os frames do topo da stack e uma causa provável, claramente marcada como palpite.
  • Define a prioridade a partir de regras que você escreve, como: tudo o que bloqueia cadastro ou pagamento é urgente.
  • Corrige os óbvios: uma checagem de null, uma chave de tradução faltando, um redirecionamento errado. Ele abre um pull request com um teste e espera a revisão.

Como configurar a triagem do Sentry no Claude Code ou no Codex

  1. Conecte o servidor MCP do Sentry

    O Sentry hospeda um servidor MCP em mcp.sentry.dev com OAuth, então não há nada para instalar nem token para colar. Adicione-o, inicie o agente e entre no Sentry quando ele pedir. Isso dá ao agente as issues, erros, projetos e a análise do Seer do Sentry.

    # Claude Code: adicione o servidor MCP hospedado do Sentry e depois entre com OAuth
    claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
    
    # Codex: pela ponte mcp-remote
    codex mcp add sentry -- npx -y mcp-remote@latest https://mcp.sentry.dev/mcp
  2. Copie o brief do cargo

    No CLAUDE.md para o Claude Code ou no AGENTS.md para o Codex, no repositório de onde vêm os erros, para que ele possa ler o código por trás de cada frame da stack.

    # Cargo: triagem de erros
    Roda a partir da issue recorrente "Sentry triage", nos dias úteis às 9:00 e às 14:00.
    
    1. No Sentry, liste as issues não resolvidas vistas pela primeira vez ou que voltaram
       desde a última execução, no ambiente de produção.
    2. Para cada uma: procure no quadro uma issue existente (busque o ID da issue
       no Sentry). Se houver, adicione a nova contagem como comentário.
    3. Senão, abra uma issue: título a partir do erro, usuários e eventos
       afetados, primeira e última ocorrência, os frames do topo da stack, a versão
       em que começou e o seu melhor palpite sobre a causa, marcado como palpite.
    4. Prioridade: Urgent se bloqueia cadastro, pagamento ou dados; High se
       afeta mais de 1% das sessões; senão Medium.
    5. Se a correção for pequena e óbvia, pegue-a como a sua próxima issue e
       abra um pull request com um teste. Não faça merge.
    6. Nunca resolva, ignore ou exclua nada no Sentry por conta própria.
  3. Coloque em um agendamento

    Transforme a triagem em uma issue recorrente, por exemplo --repeat "weekdays at 9:00", e uma segunda à tarde se o seu volume de erros pedir.

  4. Revise as correções

    Os pull requests de correção passam pela sua revisão normal. Quando o funcionário não tem certeza sobre o impacto ou o responsável, ele marca a issue como Needs action e pergunta.

Fonte: documentação do servidor MCP do Sentry

Regras que mantêm tudo seguro

  • Ler o Sentry, escrever no quadro. Resolver, ignorar ou excluir no Sentry fica com as pessoas.
  • Só produção: aponte-o para o ambiente de produção, para ele não registrar o barulho do staging.
  • Palpite é palpite: a causa em cada issue fica marcada como hipótese até alguém confirmar.
  • Sem merges: correções são pull requests com teste, nunca pushes diretos.
  • Dados pessoais: eventos do Sentry podem incluir dados de usuários; mantenha a issue em contagens e IDs, não em e-mails ou IPs.

Passo a passo para o Claude Code e o Codex

Os comandos nativos, as ferramentas para conectar e o agendamento de cada agente: Sentry com o Claude Code e Sentry com o Codex.

Com o Crewmark

Um engenheiro que começa o dia pelos seus erros

A triagem é uma issue recorrente natural para um engenheiro de software com IA. O Crewmark transforma o seu Claude Code ou Codex nesse funcionário, com horário de trabalho e um heartbeat.

  1. Comece pelo cargo

    O engenheiro de software com IA pega issues de um quadro e abre pull requests.

  2. Adicione a triagem como issue recorrente

    Ele faz a triagem quando chega a hora e depois trabalha nas issues que registrou.

  3. Mais trabalhos de engenharia

    Veja Claude Code para engenharia e revisão de código com IA em todo pull request.

Perguntas frequentes

Como conecto o Sentry ao Claude Code?

Rode claude mcp add --transport http sentry https://mcp.sentry.dev/mcp, inicie o Claude Code e entre no Sentry com OAuth quando ele pedir. O Sentry hospeda o servidor, então não há nada para instalar.

O servidor MCP do Sentry funciona com o Codex?

Sim, pela ponte mcp-remote: codex mcp add sentry -- npx -y mcp-remote@latest https://mcp.sentry.dev/mcp.

O agente pode resolver issues no Sentry?

Dá para permitir, mas recomendamos que não: deixe-o registrar e corrigir, e mantenha resolver e ignorar com as pessoas, para nada ser escondido por engano.

Com que frequência a triagem deve rodar?

Duas vezes nos dias úteis bastam para a maioria das equipes; acrescente uma execução por hora durante um lançamento. Cada execução consome o uso do plano do seu agente, então não rode a cada poucos minutos.

Para onde vão as issues?

Para onde a sua equipe acompanha o trabalho. Com o Crewmark, elas vão para o mesmo quadro de onde o funcionário trabalha; caso contrário, use o servidor MCP ou a CLI do seu gerenciador, como os do Linear ou do GitHub.

Conferido na documentação do servidor MCP do Sentry em 10 de novembro de 2026.

Erros registrados e os pequenos corrigidos antes do seu café.

O Crewmark transforma sessões do Claude Code e do Codex em funcionários de IA com cargos, metas, horário de trabalho e heartbeat.