Resolver problemas de configuração e ligação do WinDbg MCP

Use este artigo quando o Visual Studio Code com GitHub Copilot ou quando a CLI do GitHub Copilot não conseguir registar o servidor do WinDbg Model Context Protocol (MCP), não conseguir ligar-se a uma sessão WinDbg MCP, ou os controlos de segurança do WinDbg MCP bloquearem uma operação. Registar adiciona o servidor MCP WinDbg à configuração do cliente de IA, enquanto associa o cliente a uma sessão WinDbg específica.

Para instruções de configuração, consulte Instalar e ativar o WinDbg MCP. Para orientações autoritativas sobre segurança e privacidade, consulte as considerações de segurança e privacidade do WinDbg MCP.

Comece pelo sintoma que observa, identifique a causa provável e complete os passos de resolução.

Lista de verificação para resolução de problemas

Para questões de registo de servidores MCP:

  1. Abra o WinDbg. Não precisas de carregar ou ligar a um destino de depuração para usar Enable Server ou Install MCP.
  2. Abra as definições do serviço MCP e confirme que selecionou Ativar Servidor.
  3. Confirma que selecionaste Visual Studio Code ou GitHub Copilot CLI como cliente.

Para problemas de ligação ou de sessão:

  1. Inicie o Serviço MCP na janela WinDbg pretendida.
  2. Se estiver a analisar um destino, carregue ou anexe ao destino de depuração conforme necessário.

A lista de servidores MCP não inclui o WinDbg

A lista de servidores MCP do cliente de IA suportado não inclui o WinDbg.

Cause

Install MCP não registou o WinDbg no cliente, ou o cliente não recarregou a configuração do servidor MCP.

Resolução

  1. Reinicia o cliente de IA e depois verifica a lista de servidores MCP dele.
  2. No WinDbg, abra as definições do serviço MCP e selecione o cliente suportado correto.
  3. Selecione Instalar MCP novamente.
  4. Complete qualquer confirmação que a aplicação cliente apresente.
  5. Reinicia o cliente e depois verifica novamente a sua lista de servidores MCP.

Se o WinDbg continuar em falta porque o Install MCP falhar, regista o WinDbg manualmente.

Registar manualmente um cliente suportado

Use esta alternativa apenas quando o Install MCP não registar o WinDbg com o Visual Studio Code ou GitHub Copilot CLI.

  1. No WinDbg, abre as definições do serviço MCP.
  2. Selecione Personalizado para mostrar a configuração do proxy. Selecionar Personalizado neste passo fornece apenas o comando proxy para a configuração do cliente suportado.
  3. Selecione Copiar para a Área de Transferência e anote o command caminho que o WinDbg copia para a Área de Transferência.

Configure o cliente suportado:

  1. No seu espaço de trabalho, adicione o servidor WinDbg a .vscode/mcp.json. Substitua o valor de exemplo command pelo caminho copiado da área de transferência:

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

  2. Reiniciar o Visual Studio Code.

Depois de o cliente reiniciar, veja Verificar a ligação MCP do WinDbg.

O GitHub Copilot não consegue encontrar a sessão WinDbg pretendida

O Visual Studio Code com GitHub Copilot e GitHub Copilot CLI não consegue encontrar a sessão WinDbg que contém o alvo de depuração pretendido.

Cause

O Serviço MCP não está a correr na janela WinDbg pretendida, ou há mais do que uma sessão WinDbg disponível e o proxy não pode selecionar automaticamente uma sessão.

Resolução

  1. Na janela WinDbg pretendida, selecione MCP Service.
  2. Pede ao cliente de IA para usar list_sessions.
  3. Identifique o ID do processo para a sessão WinDbg pretendida.
  4. Pede ao cliente de IA para usar connect_session com esse ID de processo.
  5. Confirme que o tipo de alvo e o estado de execução que o cliente reporta correspondem aos da janela WinDbg pretendida.

Para mais orientações sobre a seleção de sessões, consulte Gerir sessões WinDbg.

A sessão WinDbg não está disponível porque outro cliente está conectado

A sessão WinDbg pretendida parece indisponível quando o cliente de IA lista sessões ou tenta estabelecer ligação.

Cause

Outro cliente de IA tem uma conexão ativa à sessão WinDbg. Apenas um cliente MCP ativo pode ligar-se a uma sessão WinDbg de cada vez.

Resolução

  1. No cliente de IA conectado, peça ao cliente para usar disconnect_session.
  2. Confirme que o cliente reporta que se desconectou da sessão WinDbg.
  3. No cliente de IA pretendido, peça ao cliente para usar list_sessions.
  4. Pede ao cliente em questão para usar connect_session com o ID de processo da sessão WinDbg.
  5. Confirme que o cliente reporta uma ligação à sessão pretendida.

Acesso negado quando o WinDbg é executado como administrador

A ligação falha com uma mensagem de acesso negado quando o WinDbg está a correr como administrador.

Cause

A sessão WinDbg elevada impede que o cliente de IA suportado se ligue através do proxy.

Resolução

  1. Fecha a sessão elevada do WinDbg.
  2. Inicie o WinDbg sem selecionar Executar como administrador.
  3. Inicie Serviço MCP.
  4. Carregue ou anexe ao alvo de depuração conforme necessário.
  5. Abra o cliente de IA suportado e complete os passos em Verificar a ligação WinDbg MCP.

A proteção contra injeção de prompt bloqueia uma operação

O cliente de IA relata que a proteção contra injeção de prompts bloqueou uma operação ou classificou a saída do depurador como insegura.

Cause

A proteção contra ataque por injeção cruzada (XPIA) do WinDbg identificou a saída do depurador como potencialmente insegura e bloqueou a saída.

Resolução

  1. Consulte as informações de erro que o cliente de IA reporta.
  2. Revise diretamente a saída relevante no WinDbg.
  3. Trate a saída como não confiável e não envie a saída bloqueada para o cliente de IA.
  4. Consulte a proteção contra injeção entre prompts antes de decidir como continuar.

A classificação por injeção de prompt não pode ser executada porque o cliente de IA não suporta nem permite a amostragem MCP

O cliente de IA reporta que a classificação por injeção de prompt não consegue ser executada, e a operação protegida falha sem devolver a saída.

Cause

O cliente de IA não suporta a amostragem MCP, ou a sua configuração ou política organizacional não permite a amostragem MCP. A proteção WinDbg XPIA requer amostragem MCP para solicitar classificação ao serviço de modelo configurado do cliente.

Resolução

  1. Confirme que o cliente de IA suporta a amostragem MCP.
  2. Confirme que a configuração do cliente e a política da sua organização permitem a amostragem MCP.
  3. Depois de a amostragem estar disponível, execute novamente a operação.
  4. Se a classificação ainda não puder ser executada, consulte a proteção contra injeção cruzada e contacte o administrador que gere a política do cliente de IA.

Verifique a ligação ao MCP do WinDbg e reporte problemas não resolvidos

  • Última atualização a