Pular para o conteúdo

Um servidor MCP de bug report para o seu agente de código ler o report

Atualizado em

O Midge tem um servidor MCP de bug report. Com ele, agentes de código como o Claude Code e o Cursor leem um report do Midge diretamente: os erros de console, as requisições e respostas de rede, os cliques e as mudanças de página do usuário, e os detalhes do navegador. Em vez de você copiar um stack trace para um chat, você cola o link do report e o agente busca as partes de que precisa.

Como configurar

No Claude Code, é um comando só:

claude mcp add --transport http midge https://midge.dev/mcp

Na primeira vez que o Claude Code usa o servidor, o seu navegador abre o midge.dev: faça login, clique em Allow e pronto, você está de volta ao terminal. O Cursor e outros clientes que suportam servidores MCP remotos funcionam do mesmo jeito, com o endereço https://midge.dev/mcp.

Um agente que não consegue fazer login pelo navegador usa um token: no midge.dev, abra Settings › Account › AI assistants, escolha o agente e clique em Create token, depois envie o token como Authorization: Bearer <token>.

Nos dois casos, o agente aparece em Connected devices como "Claude Code (MCP)" ou algo parecido; desconecte ele por lá e ele não consegue ler mais nada. A página da documentação tem os detalhes de cada cliente.

As ferramentas

  • get_recording: o ponto de partida quando você tem um link. Título, descrição, página, dispositivo e duração, as páginas visitadas e os primeiros erros de console e requisições com falha.
  • get_console: mensagens em ordem, por nível (só erros, warnings e erros, ou tudo), com stack traces e busca por texto.
  • get_network: requisições com método, status, tipo e tempo. Peça só as requisições com falha ou um único endpoint, e os headers e bodies quando o agente precisar deles, para que ele leia o que importa em vez de um log de 4 MB.
  • get_user_actions: cliques, digitação (nunca o texto), rolagens e mudanças de página em ordem, prontos para virar passos para reproduzir.
  • list_recordings: os seus reports recentes, com busca, para quando você não colou um link.

Uma sessão típica: você cola o link de um report no Claude Code e pede para ele encontrar a causa. O agente lê o resumo, pede as requisições com falha com os bodies, encontra um 500 em POST /api/orders com um erro de validação, lê o erro correspondente no console do lado do cliente e abre o handler no seu repositório.

O que é MCP

O Model Context Protocol é um padrão aberto que permite que aplicações de IA se conectem a ferramentas e dados externos. Um servidor expõe um conjunto de ferramentas, como "pegar o log de console do report X", e um cliente como o Claude Code ou o Cursor as chama enquanto trabalha numa tarefa. Você conecta um servidor uma vez, e o agente decide quando usá-lo.

Na hora de corrigir bugs, isso faz diferença porque as evidências úteis estão no bug report, não no código. Um agente que consegue ler a requisição que falhou e o erro exato vai direto ao arquivo certo.

Acesso e privacidade

O servidor usa as mesmas checagens de acesso que o resto do Midge. Um agente com o seu token abre o que você consegue abrir, e nada além disso: um report definido como "Only me" continua sendo só seu, e um report do workspace fica com os membros dele. O report de qualquer pessoa compartilhado como "Anyone with the link" abre para qualquer agente logado que tenha o link, do mesmo jeito que num navegador. O servidor só lê; ele não consegue alterar, apagar nem compartilhar nada.

Os reports são ocultados antes mesmo de chegar ao Midge. Senhas, números de cartão, tokens e cookies são removidos no seu dispositivo antes que qualquer coisa saia dele. O agente recebe os mesmos dados ocultados que um colega de time veria. As regras estão listadas na página de ocultação.

Sem MCP

Se o seu agente não fala MCP, você ainda pode levar um report para um chat manualmente:

  • Copiar como cURL: abra a requisição que falhou no painel de logs de rede e copie. O header Authorization e os cookies chegam como [REDACTED], que é exatamente o que você quer numa transcrição de chat.
  • Baixar o HAR ocultado: anexe o log de rede do report como arquivo HAR. Os agentes lidam bem com ele; para dar uma olhada antes, abra no visualizador de HAR gratuito.
  • Colar o console: copie o erro e o stack trace dele, e o warning logo antes, se houver um.

Por que MCP

Poderíamos ter feito um plugin para um único editor. O MCP é suportado por muitos agentes e editores, então um único servidor atende o Claude Code, o Cursor e o que quer que o seu time use depois. Ele também deixa o agente no controle do que lê: ele pede exatamente as requisições de que precisa.

As integrações com Jira, Linear, GitHub Issues e Slack são o próximo passo.

O Midge é grátis: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água.

Perguntas frequentes

O servidor MCP do Midge já está disponível?
Sim, e é grátis. Adicione https://midge.dev/mcp ao seu agente (no Claude Code: claude mcp add --transport http midge https://midge.dev/mcp) e entre no Midge pelo navegador quando ele pedir. Agentes que não conseguem fazer login usam um token de Settings › Account › AI assistants.
Com quais agentes ele funciona?
Com qualquer cliente que suporte servidores MCP remotos via Streamable HTTP com um header, incluindo Claude Code e Cursor.
O que o agente consegue ler?
O resumo de um report (título, descrição, página, dispositivo, páginas visitadas), as mensagens de console, as requisições de rede com filtros e bodies, e os passos do usuário. Ele só lê, e só os reports que a pessoa que criou o token consegue abrir.
O agente vai ver os meus segredos?
Não. Os reports são ocultados antes do upload, no navegador ou no seu Mac, então o Midge nunca guarda os valores originais. O servidor MCP só devolve o que o Midge tem, ou seja, os dados já ocultados.