WinDbg MCP: o que é e como depurar com IA

O papel do Model Context Protocol

O Model Context Protocol, ou MCP, é um padrão aberto que define como aplicações expõem ferramentas e contexto para modelos de linguagem. Em outras palavras, ele funciona como um conector universal entre a IA e sistemas externos.

O WinDbg MCP usa esse protocolo para transformar comandos do depurador em ferramentas que a IA consegue chamar. Dessa forma, qualquer cliente compatível com MCP consegue, em tese, conversar com o WinDbg.

Se você já leu sobre o Microsoft Binlog MCP Server, vai reconhecer a ideia. A Microsoft vem aplicando o mesmo padrão às suas ferramentas de diagnóstico, primeiro nos builds e agora na depuração.

O proxy local e os named pipes

O cliente de IA não conversa diretamente com o WinDbg. Em vez disso, existe um proxy local chamado DbgX.Mcp.Proxy.exe entre os dois.

O cliente de IA se comunica com esse proxy usando MCP sobre stdio, ou seja, pela entrada e saída padrão do processo. Em seguida, o proxy se conecta ao servidor MCP do WinDbg por meio de um named pipe local.

Cada sessão do WinDbg usa um named pipe próprio, separado por processo. Portanto, a conexão com o depurador permanece sempre local na sua máquina.

Já o cliente de IA conversa com o serviço de modelo configurado nele. Nesse caso, valem as regras de configuração e de tratamento de dados do próprio cliente.

O ciclo de uma pergunta

Quando você faz uma pergunta, o cliente de IA escolhe as ferramentas do WinDbg MCP mais adequadas ao pedido. Em seguida, o WinDbg executa as ações solicitadas e devolve os resultados para o cliente analisar.

Todas essas ações ficam visíveis dentro do WinDbg. Dessa forma, você revisa exatamente o que foi executado e valida as conclusões apresentadas pela IA.

Existe também uma regra importante de exclusividade. Apenas um cliente MCP ativo pode se conectar a uma sessão do WinDbg por vez.

Ferramentas de conexão

As ferramentas de conexão servem para localizar e selecionar a sessão do WinDbg que você quer investigar. Elas são três, conforme a tabela abaixo.

Quando existe apenas uma sessão disponível, o proxy se conecta sozinho. No entanto, com várias janelas do WinDbg abertas, o cliente fica desconectado até você escolher uma sessão.

Nesse caso, peça ao chat para usar list_sessions, identifique o ID do processo e depois solicite o connect_session. Lembre que esses comandos vão no chat do cliente de IA, nunca na linha de comando do WinDbg.

Prompts prontos para fluxos guiados

Se o cliente de IA suportar prompts MCP, você também encontra quatro fluxos guiados prontos. Eles funcionam como atalhos para tarefas comuns de depuração.

Passo a passo da configuração do WinDbg MCP

A configuração acontece quase toda pela interface do WinDbg, sem editar arquivos manualmente. Siga esta sequência:

1. Abra o WinDbg e acesse File, depois Settings e então MCP service settings.
2. Marque Enable Server e escolha o cliente: VS Code ou GitHub Copilot CLI.
3. Clique em Install MCP para registrar o WinDbg como servidor MCP no cliente escolhido.
4. Clique em MCP Service, leia o aviso de privacidade e segurança e confirme com Yes.
5. Carregue ou anexe o depurador a um alvo, como um dump ou um processo.
6. Clique em Open Chat para abrir o cliente de IA e iniciar a investigação.

Note que não é preciso ter um alvo carregado para habilitar o servidor ou registrar o cliente. Por outro lado, a ordem entre iniciar o serviço e conectar o alvo afeta o Secure Mode, como veremos adiante.

Registro manual do servidor

Às vezes o botão Install MCP não consegue registrar o servidor no cliente. Nesse caso, a documentação oficial descreve um registro manual como alternativa.

Primeiro, selecione Custom nas configurações de MCP e clique em Copy to Clipboard para copiar o caminho do proxy. Depois, no Visual Studio Code, adicione o servidor ao arquivo .vscode/mcp.json do workspace:

{
  "servers": {
    "WinDbg": {
      "type": "stdio",
      "command": "C:\\path\\to\\DbgX.Mcp.Proxy.exe",
      "args": []
    }
  }
}

Já no GitHub Copilot CLI, o registro acontece com um único comando no terminal:

# substitua pelo caminho copiado do WinDbg
copilot mcp add WinDbg -- "C:\path\to\DbgX.Mcp.Proxy.exe"

Em ambos os casos, reinicie o cliente após a alteração para que ele carregue a nova configuração.

Validando a conexão

Depois de configurar, confira se a barra de status do WinDbg mostra que um cliente de IA está conectado. Em seguida, faça um teste simples no chat:

Use WinDbg MCP to report the current target type and execution state.

O cliente deve usar as ferramentas do WinDbg MCP e informar o mesmo tipo de alvo e estado de execução exibidos no depurador. Se os dados não baterem, você provavelmente está conectado à sessão errada.

Cenários suportados

Além de crash dumps, a documentação lista outros cenários em que o recurso ajuda bastante:

• Investigar um alvo em execução, verificando estado, pilha de chamadas e módulos.
• Descobrir por que símbolos ou código-fonte não estão carregando corretamente.
• Analisar um trace de Time Travel Debugging e encontrar o ponto de divergência.
• Visualizar resultados de consultas ao modelo de dados como árvore, grade ou grafo.
• Criar e validar scripts que automatizam uma análise repetitiva.

Boas práticas para escrever prompts

Um prompt eficiente dá contexto suficiente para a IA escolher as ferramentas certas. Por isso, identifique sempre o alvo e a tarefa, como analisar um dump ou examinar um trace.

Também peça evidências e suposições pendentes, e não somente o veredito final. Se necessário, especifique o formato da saída, por exemplo um plano de investigação ordenado.

Por fim, compare o resultado com o estado do alvo e com a saída visível no WinDbg antes de agir. Esse hábito evita decisões baseadas em uma conclusão errada da IA.

Secure Mode

O Secure Mode restringe operações de alto risco, como carregar ou executar código não confiável e iniciar processos. Ele também bloqueia operações de arquivo inseguras e comandos perigosos como .shell.

A opção vem marcada por padrão quando você inicia o serviço MCP. Para ter o modo completo, inicie o MCP antes de conectar o alvo.

Se o alvo já estiver conectado, o WinDbg entra em Secure Mode parcial e exibe um aviso. Depois de ativado, o modo não pode ser desligado e permanece ativo até você reiniciar o WinDbg.

Existe ainda um detalhe importante sem o Secure Mode. Comandos executados diretamente pela IA continuam restritos, mas ações indiretas não são, como um breakpoint que dispara um comando com as suas permissões completas.

Proteção contra cross-prompt injection

A saída de um comando do depurador pode conter texto vindo do próprio alvo, inclusive texto malicioso. Esse texto poderia enganar a IA e induzi-la a executar ações inseguras.

Para mitigar isso, o WinDbg classifica a saída de operações protegidas usando o próprio modelo configurado no cliente. Então, se a classificação identificar conteúdo potencialmente inseguro, a saída é bloqueada.

Essa proteção depende de um recurso chamado MCP sampling. Portanto, o cliente precisa suportar e permitir sampling, e a verificação pode consumir tokens adicionais.

Outros clientes MCP, como o Codex, podem funcionar com configuração personalizada, embora sem suporte oficial. Contudo, alguns deles não suportam sampling, o que exigiria desligar essa proteção.

Privacidade e controles administrativos

O cliente de IA pode enviar contexto da depuração para o serviço de modelo configurado. Ou seja, dados da memória do processo podem sair da sua máquina.

Por isso, use o recurso apenas com alvos e dados que você tem autorização para inspecionar. Além disso, trate os logs de diagnóstico do MCP como dados sensíveis, pois eles podem conter comandos e dados do alvo.

Organizações podem desativar o recurso ativando o modo restrito do WinDbg, com a configuração EnableRestrictedMode definida como 1. A documentação oficial do WinDbg MCP detalha todas essas orientações.