MCP
Conecte o Claude Code e o Codex aos reports do Mira pelo servidor MCP.
Agentes como o Claude Code e o Codex leem os reports A fazer e registram o andamento pelo MCP. Cada pessoa cria o próprio token de agente e adiciona a URL do Mira ao agente. Não há nada a instalar além do agente.
A URL do servidor é a do dashboard seguida de /mcp: https://mira.example.com/mcp.
Para scripts, ou para um agente que deve fazer tudo o que a pessoa faz na API, use a CLI.
Criar o token de agente
Abrir Conectar agente
Clique no seu nome, no rodapé da barra lateral, e escolha Conectar agente. O diálogo tem duas colunas: à esquerda, o formulário do novo token. À direita, Seus tokens lista os tokens de agente da sua conta.
Para gerenciar os tokens com mais espaço, abra Tokens de agente, em Configurações do Mira. A tela lista o que cada token pode fazer, o último uso e a validade.
Criar o token
Preencha o formulário:
- Nome do token, para reconhecer o token na lista, como
notebook - claude code. - Validade: 30, 90 (padrão) ou 365 dias, ou Sem validade.
- O agente lê: Screenshot, Console, Rede e Erros. Todas começam marcadas.
- O agente pode: Comentar, Alterar reports e usar o selo "via agente" nos comentários. Todas começam marcadas. O selo só vale quando o agente pode comentar.
Clique em Gerar comando.
Copiar o comando
O formulário dá lugar ao comando de configuração, com as abas Claude Code e Codex. O token completo (mira_pat_...) já está no comando e aparece só nessa janela. Copie e clique em Concluir. Se fechar sem copiar, revogue o token e crie outro. Para configurar outro computador, abra Configurar no cliente, na página Tokens de agente; os comandos trazem mira_pat_... no lugar do token.
Ele tem o mesmo prefixo de um token pessoal, mas a API, a extensão, o widget e a CLI o recusam. O /mcp, por sua vez, recusa tokens pessoais e credenciais de serviço.
Configurar o agente
O escopo user deixa o Mira disponível em qualquer repositório:
claude mcp add --transport http --scope user mira https://mira.example.com/mcp --header "Authorization: Bearer mira_pat_..."Confira com claude mcp list ou com /mcp dentro de uma sessão.
Permissões
O agente age com as permissões do dono do token: vê só os projetos de que a pessoa é membro, ou todos quando ela é admin. Em cada projeto, a permissão efetiva é a interseção do token com o teto do projeto. Um eixo desativado em qualquer um dos dois fica desativado.
| Eixo | O que libera |
|---|---|
| Screenshot, console, rede, erros | Ler o anexo desse tipo com get_attachment |
| Comentar | add_comment |
| Alterar reports | update_report |
| Selo "via agente" | Comentários do agente aparecem com o selo |
Replay e gravação de tela nunca chegam ao agente.
Teto do projeto
Um admin ou Mantenedor ajusta o teto em Configurações do projeto → Agentes de IA. Ele usa os mesmos eixos do token, sem o selo. Sem teto salvo, tudo fica liberado. Um projeto que testa com dados reais pode desmarcar console e rede, e nenhum agente lê essas evidências ali, qualquer que seja o token.
Na mesma seção ficam os repositórios de código do projeto, um por linha, como owner/name ou URL. O agente usa a lista para conferir se o diretório onde trabalha é o código da app.
Tools
| Tool | Uso |
|---|---|
list_projects | Projetos que o dono do token acessa |
list_reports | Reports com os filtros da listagem. Sem filtro de status, só triaged (A fazer) |
get_report | Descrição, contexto, anexos, comentários, vínculos com Jira e GitHub e repositórios de código do projeto |
get_attachment | Screenshot como imagem. Console, rede e erros como texto truncado |
add_comment | Comenta no report |
update_report | Status, prioridade, tags, responsável, título e descrição. Para duplicate, informe também duplicateOfId, o id do original |
update_report é marcada como escrita, então o cliente pede confirmação a cada chamada. Marcar in_progress atribui o report ao dono do token quando não há responsável, e é recusado quando o responsável é outra pessoa.
Prompt implement_report
O prompt recebe o id do report (reportId, opcional). Sem id, o agente lista os reports A fazer e a pessoa escolhe um. Depois, o agente:
- Lê o report e a evidência permitida.
- Confere se o diretório atual é um dos repositórios de código do projeto e avisa se não for.
- Marca o report como
in_progress. - Implementa seguindo as regras do repositório e roda os testes.
- Cita a issue vinculada no commit e no PR, como
Fixes owner/repo#123. - Comenta no report o que mudou, com o link do PR.
O agente nunca marca resolved por conta própria. Qualquer outra alteração depende de pedido ou aprovação da pessoa. É um report por vez.
No Claude Code, o prompt aparece como /mcp__mira__implement_report. O Codex ainda não usa prompts MCP, só as tools. Nele, peça o fluxo em texto:
Pelo MCP mira, implemente o report <id>: leia o report e a evidência, confira se este diretório é um dos repositórios de código do projeto, marque o report como in_progress, implemente seguindo as regras do repositório, rode os testes, cite a issue vinculada no commit e no PR e comente no report o que mudou com o link do PR. Não marque resolved e não faça outra alteração no report sem me perguntar.Auditoria e privacidade
Toda escrita pelo MCP grava a origem mcp na atividade do report, e o dashboard mostra o rótulo agente ao lado dela. O selo via agente no comentário segue a opção do token. Sem o selo, o comentário aparece como da pessoa, e a origem continua registrada.
O que o agente lê vai para o provedor do modelo, como a Anthropic ou a OpenAI. A redação da captura continua valendo, mas não remove tudo. Antes de liberar console e rede, confira se o projeto testa com dados reais. O teto do projeto corta esses tipos para todos os agentes.
Revogar
Em Tokens de agente, abra o menu … do token e escolha Revogar. O agente recebe 401 na chamada seguinte. Remova também a configuração local:
claude mcp remove mira --scope user
codex mcp remove miraDesativar o usuário ou trocar a senha dele também revoga os tokens de agente.