# Do report à correção com um agente

URL: /guias/report-a-correcao

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 [#pré-requisitos]

- Um report **A fazer** num projeto de que você é membro, com a [triagem](/triar/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](/guias/reports-no-github) conectada antes. O agente cita a issue vinculada no commit e no PR.

## Passos [#passos]

<Steps>
<Step>

### Criar o token de agente [#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](/desenvolvedores/mcp#criar-o-token-de-agente).

<Figure src="/images/agents-token.png" alt="Diálogo Conectar agente com o comando do Claude Code e o token já preenchido" caption="O token aparece uma vez só, junto do comando para o agente." />

</Step>
<Step>

### Configurar o agente [#configurar-o-agente]

No Claude Code:

```bash
claude mcp add --transport http --scope user mira https://app.miraqa.org/mcp --header "Authorization: Bearer mira_pat_..."
```

Resultado: `claude mcp list` mostra `mira` conectado. No Codex, o comando está em [MCP](/desenvolvedores/mcp#configurar-o-agente).

</Step>
<Step>

### Pedir a implementação [#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](/desenvolvedores/mcp#prompt-implement_report).

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.

</Step>
<Step>

### Acompanhar a implementação [#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.

</Step>
<Step>

### Registrar o resultado no report [#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**.

</Step>
<Step>

### Verificar e resolver [#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](/triar/status).

</Step>
</Steps>

## Conferir que deu certo [#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 [#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 [#próximos-passos]

- [Mandar reports para o GitHub](/guias/reports-no-github), para o PR citar a issue.
- [Tokens](/desenvolvedores/tokens), para revogar e rotacionar o token de agente.