Casos de uso · Claude Code

Sentry e Claude Code: conecte o servidor MCP e faça a triagem de erros todo dia

O servidor MCP hospedado do Sentry dá ao Claude Code as issues, os eventos, as stack traces e as versões da sua organização no Sentry. Um comando o adiciona e um login no navegador o conecta; a partir daí, o Claude Code consegue ler os erros novos, encontrar a causa no seu código e abrir uma correção. Esta página mostra a configuração, as regras de triagem para o CLAUDE.md e como rodar a triagem duas vezes por dia sem abrir uma sessão.

O que o Claude Code faz em triagem de erros do Sentry

  • Lê as issues não resolvidas do Sentry que são novas ou voltaram desde a última execução.
  • Confere o seu quadro primeiro, então um erro barulhento ganha um comentário, não dez issues novas.
  • Registra cada erro novo com o impacto, a primeira e a última ocorrência, a versão em que começou, os frames do topo da stack e uma causa provável, marcada como palpite.
  • Corrige os pequenos e óbvios em um pull request com um teste e espera a revisão.

Recursos do Claude Code para triagem de erros do Sentry

RecursoO que fazComo começar
Servidor MCP do SentryIssues, eventos, stack traces e versões da sua organização no Sentryclaude mcp add --transport http sentry https://mcp.sentry.dev/mcp
/mcpMostra os servidores conectados e inicia o login com OAuthRode em uma sessão depois de adicionar o servidor
claude -pRoda uma rodada de triagem e encerra, para o cron ou o CI--allowedTools "mcp__sentry" permite que ele use as ferramentas do Sentry
Tarefas agendadasRodam a triagem em horários definidos sem abrir uma sessão/schedule, ou uma tarefa agendada no desktop

Como configurar o Claude Code para triagem de erros do Sentry

  1. Conecte as ferramentas

    Adicione o servidor hospedado do Sentry, depois rode /mcp e entre com a sua conta do Sentry no navegador. Ele usa OAuth, então não há token para copiar.

    # Adicione o servidor MCP hospedado do Sentry
    claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
    
    # Depois, em uma sessão, entre com OAuth
    /mcp
  2. Escreva as regras no CLAUDE.md

    O Claude Code lê o CLAUDE.md no início de toda sessão, inclusive nas execuções com claude -p. Coloque ali as regras do trabalho, ou em uma skill em .claude/skills/ se forem longas. Veja o guia do CLAUDE.md.

    ## Regras de triagem do Sentry
    1. Liste as issues de produção não resolvidas vistas pela primeira
       vez ou que voltaram desde a última execução.
    2. Busque o ID da issue do Sentry no quadro antes de registrar.
    3. Registre as novas com usuários e eventos afetados, primeira e
       última ocorrência, a versão, os frames do topo da stack e uma
       causa provável, marcada como palpite.
    4. Urgent se bloqueia cadastro, pagamento ou dados; High acima de
       1% das sessões; senão Medium.
    5. Correção pequena e óbvia: abra um pull request com um teste. Não faça merge.
    6. Nunca resolva, ignore ou exclua nada no Sentry.
  3. Rode sem a interface interativa

    claude -p roda uma tarefa e encerra, então o cron, o CI ou outra ferramenta pode iniciá-lo. Escolha o que ele pode fazer sem pedir com --allowedTools ou --permission-mode; --output-format json devolve o resultado com o custo.

    # Uma rodada de triagem pelo cron, nos dias úteis às 9:00 e às 14:00
    claude -p "Faça a triagem dos erros novos do Sentry com as regras do CLAUDE.md" \
      --allowedTools "mcp__sentry" --output-format json
  4. Coloque em um agendamento

    Transforme-o em uma tarefa agendada na nuvem com /schedule (Pro, Max, Ultra, Team e Enterprise) ou em uma tarefa agendada no desktop, ou use /loop enquanto uma sessão fica aberta. Veja como deixar o Claude Code proativo.

Fonte: documentação do Claude Code

Limites e segurança

  • Ele precisa ler as issues do Sentry, não alterá-las. Deixe resolver e ignorar com as pessoas.
  • A causa que ele aponta é um palpite a partir da stack trace. Uma pessoa a confirma antes de uma correção ir ao ar.
  • Erros podem carregar dados de usuários. Mantenha as issues que ele registra em um quadro ou repositório privado.
  • Desde o Claude Code v2.1.302, claude -p começa no modo Manual: uma ação que precisa de aprovação é negada, a menos que uma regra a permita. Permita só as ferramentas de que o trabalho precisa.

Claude Code ou Codex para triagem de erros do Sentry?

As regras valem para os dois. Escreva-as uma vez no AGENTS.md e coloque @AGENTS.md no CLAUDE.md, e os dois agentes leem o mesmo arquivo.

Passo a passo para o outro agente: triagem de erros do Sentry com o Codex.

Claude CodeCodex
Arquivo de regrasCLAUDE.mdAGENTS.md
Conectar ferramentasclaude mcp addcodex mcp add ou config.toml
Rodar sem vocêclaude -pcodex exec
Agendamento/schedule, tarefas agendadas no desktop, /loopTarefas agendadas no app do ChatGPT, cron
Recursos nativos para triagem de erros do SentryMCP do Sentry por HTTP, login com /mcpMCP por HTTP nativo, codex mcp login
Com o Crewmark

Coloque alguém responsável por triagem de erros do Sentry

Comandos rodam quando alguém lembra de rodá-los. O Crewmark transforma o seu próprio Claude Code em um funcionário de IA com um cargo, uma meta em números, horário de trabalho e um heartbeat, então o trabalho acontece no horário e aparece em um quadro.

  1. Comece pelo cargo

    O engenheiro de software com IA, com estas regras no brief.

  2. Leve o trabalho para o quadro dele

    Adicione o trabalho como issue recorrente. O funcionário acorda com o heartbeat, faz o trabalho e relata em um comentário.

  3. Veja também

    A página de triagem de erros do Sentry tem o brief completo e as regras de prioridade.

Perguntas frequentes

Como conecto o Sentry ao Claude Code?

Rode claude mcp add --transport http sentry https://mcp.sentry.dev/mcp e depois /mcp em uma sessão para entrar com OAuth.

O que o Claude Code consegue fazer com o Sentry?

Ler issues, eventos, stack traces e versões, encontrar o código por trás de um erro, registrar issues no seu quadro e abrir pull requests de correção. Deixe resolver e ignorar issues no Sentry com as pessoas.

O Claude Code consegue fazer a triagem de erros do Sentry automaticamente?

Sim, com agendamento: rode claude -p pelo cron ou pelo CI, crie uma tarefa agendada ou transforme a triagem em uma issue recorrente para um funcionário do Crewmark.

Conferido na documentação do Claude Code e na documentação do Codex da OpenAI em 13 de novembro de 2026.

Entregue o trabalho de triagem de erros do Sentry a um funcionário de IA no Claude Code.

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.