Do report à correção com um agente
Um agente lê um report triado pelo MCP, implementa a correção e comenta o PR no report.
Ao fim, um agente de IA leu um report triado, abriu o PR da correção e registrou o andamento no report. O status Resolvido continua sendo decisão sua.
Pré-requisitos
- Um report A fazer num projeto de que você é membro, com a triagem feita.
- O Claude Code ou o Codex instalado, aberto no repositório da app.
- O repositório da app listado nos repositórios de código do projeto, em Configurações do projeto, Agentes de IA. O agente avisa quando o diretório atual não é um deles.
- Se o report deve virar issue no GitHub, a integração conectada antes. O agente cita a issue vinculada no commit e no PR.
Passos
Criar o token de agente
No menu do perfil, clique em Conectar agente. Informe o nome, a validade e o que o agente lê e pode fazer, e clique em Gerar comando. Para este guia, deixe marcados comentar e alterar reports.
Resultado: o diálogo troca o formulário pelos comandos de configuração, com o token mira_pat_... dentro. O token aparece só ali. Veja as opções em MCP.
Configurar o agente
No Claude Code:
claude mcp add --transport http --scope user mira https://mira.example.com/mcp --header "Authorization: Bearer mira_pat_..."Resultado: claude mcp list mostra mira conectado. No Codex, o comando está em MCP.
Pedir a implementação
No repositório da app, abra o Claude Code e rode /mcp__mira__implement_report. Informe o id do report, ou deixe em branco para o agente listar os reports A fazer e você escolher um. No Codex, que não usa prompts MCP, cole o texto de pedido de MCP.
Resultado: o agente lê o report e as evidências que o token permite, confere o diretório e marca o report como Em andamento. O cliente pede sua confirmação antes de cada escrita.
Acompanhar a implementação
O agente implementa seguindo as regras do repositório e roda os testes. Revise o diff como em qualquer PR.
Resultado: um commit e um PR com Fixes owner/repo#123 no texto, quando o report tem issue vinculada.
Registrar o resultado no report
O agente comenta no report o que mudou, com o link do PR.
Resultado: o comentário aparece no report com o selo via agente, se o token permite o selo, e a atividade mostra o rótulo agente.
Verificar e resolver
Depois do merge e da conferência do QA, marque o report como Resolvido no badge de status. O agente nunca faz isso sozinho. Veja os status em Status do report.
Conferir que deu certo
Abra o report no dashboard. Ele deve estar Em andamento, com o responsável igual ao dono do token e um comentário com o link do PR. A atividade registra cada escrita do agente com a origem mcp.
Problemas comuns
| Sintoma | Causa provável |
|---|---|
401 na chamada do agente | O token foi revogado, expirou ou é um token pessoal. O /mcp só aceita tokens de agente |
list_reports não traz o report | Sem filtro de status, a tool lista só triaged. Peça o report pelo id |
| O agente não lê console ou rede | O token ou o teto do projeto desativou esses eixos. Um admin ou Mantenedor ajusta o teto em Configurações do projeto → Agentes de IA |
| A marcação Em andamento é recusada | O report tem outra pessoa como responsável |
| O agente avisa que o diretório não é do projeto | Adicione o repositório em repositórios de código do projeto |
Próximos passos
- Mandar reports para o GitHub, para o PR citar a issue.
- Tokens, para revogar e rotacionar o token de agente.