Casos de uso · Codex

Sentry e Codex: adicione o servidor MCP e faça a triagem de erros com agendamento

O Codex se conecta ao servidor MCP hospedado do Sentry diretamente por streamable HTTP: adicione a URL, entre uma vez com OAuth e o Codex consegue ler issues, eventos e stack traces ao lado do seu código. Esta página mostra a configuração, as regras de triagem para o AGENTS.md e como rodar a triagem com codex exec sem abrir uma sessão.

O que o Codex 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 Codex 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 Sentryurl = "https://mcp.sentry.dev/mcp" no config.toml
codex mcp loginFaz login em um servidor OAuth; --no-browser em uma máquina remotacodex mcp login sentry
required = trueFaz o codex exec parar com um erro se o Sentry não estiver conectado, para que nenhuma execução faça a triagem às cegasEm [mcp_servers.sentry]
codex execRoda uma rodada de triagem e encerra; -o salva o resumocodex exec "Triage new Sentry errors"

Como configurar o Codex para triagem de erros do Sentry

  1. Conecte as ferramentas

    Adicione o Sentry como servidor streamable HTTP e depois entre uma vez. A documentação do próprio Sentry também mostra a ponte mcp-remote, que funciona, mas o Codex não precisa dela.

    # ~/.codex/config.toml
    [mcp_servers.sentry]
    url = "https://mcp.sentry.dev/mcp"
    required = true
    
    # Depois, entre com OAuth
    codex mcp login sentry
  2. Escreva as regras no AGENTS.md

    O Codex lê o AGENTS.md antes de qualquer trabalho: ~/.codex/AGENTS.md e depois os arquivos da raiz do repositório até a pasta em que está trabalhando. Coloque ali as regras do trabalho, ou em uma skill em .agents/skills/ se forem longas. Veja o guia do AGENTS.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

    codex exec roda uma tarefa e encerra. O progresso vai para o stderr e a mensagem final para o stdout; -o também a grava em um arquivo e --json transmite os eventos. O sandbox é somente leitura, a menos que você passe --sandbox workspace-write.

    # Uma rodada de triagem pelo cron; o resumo vai para um arquivo
    codex exec --sandbox workspace-write \
      -o triage.md "Faça a triagem dos erros novos do Sentry com as regras do AGENTS.md"
  4. Coloque em um agendamento

    Crie uma tarefa agendada no app desktop do ChatGPT ou na web (a CLI não as gerencia), ou rode codex exec pelo cron. Veja como deixar o Codex proativo.

Fonte: documentação do Codex

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.
  • O Codex roda os comandos em sandbox por padrão: as escritas ficam no workspace e a rede fica desligada. Deixe danger-full-access para um runner ou contêiner isolado.

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 Claude Code.

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 Codex 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 adiciono o servidor MCP do Sentry ao Codex?

Adicione uma tabela [mcp_servers.sentry] com url = "https://mcp.sentry.dev/mcp" ao ~/.codex/config.toml e depois rode codex mcp login sentry para entrar.

O Codex precisa do mcp-remote para o Sentry?

Não. O Codex aceita servidores streamable HTTP, então a URL basta. A ponte mcp-remote da documentação do Sentry também funciona.

O Codex consegue corrigir erros do Sentry?

Ele consegue encontrar o código por trás de um erro e abrir um pull request com uma correção e um teste. Deixe o merge, e a resolução de issues no Sentry, com as pessoas.

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 Codex.

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.