Solucionar problemas de configuração e conexão do MCP do WinDbg

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

Para obter instruções de instalação, consulte Instalar e habilitar o WinDbg MCP. Para obter diretrizes autoritativas de segurança e privacidade, consulte considerações de segurança e privacidade do MCP winDbg.

Comece com o sintoma observado, identifique a causa provável e conclua as etapas de resolução.

Lista de verificação de solução de problemas

Para problemas de registro do servidor MCP:

  1. Abra o WinDbg. Você não precisa carregar ou anexar a um destino de depuração para usar Ativar servidor ou Instalar MCP.
  2. Abra as configurações do serviço MCP e confirme se você selecionou Habilitar Servidor.
  3. Confirme se você selecionou Visual Studio Code ou GitHub Copilot CLI como o cliente.

Para problemas de conexão ou sessão:

  1. Inicie o Serviço MCP na janela WinDbg pretendida.
  2. Se você estiver analisando um alvo, 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 com suporte não inclui o WinDbg.

Cause

Instalar MCP não registrou o WinDbg com o cliente, ou o cliente não recarregou a configuração do servidor MCP.

Resolução

  1. Reinicie o cliente de IA e, em seguida, verifique a lista de servidores MCP.
  2. No WinDbg, abra as configurações do serviço MCP e selecione o cliente com suporte correto.
  3. Selecione Instalar MCP novamente.
  4. Conclua qualquer confirmação exibida pelo cliente.
  5. Reinicie o cliente e verifique a lista de servidores MCP novamente.

Se o WinDbg ainda não for encontrado por causa da falha em Instalar MCP, registre manualmente o WinDbg.

Registrar manualmente um cliente compatível

Só use esse fallback quando Instalar MCP não registrar o WinDbg com o Visual Studio Code ou a CLI do GitHub Copilot.

  1. No WinDbg, abra as configurações do serviço MCP.
  2. Selecione Custom para exibir a configuração de proxy. Selecionar Personalizado nesta etapa fornece apenas o comando proxy para a configuração de cliente com suporte.
  3. Selecione Copiar para Área de Transferência e observe o command caminho copiado pelo WinDbg para a área de transferência.

Configure o cliente compatível:

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

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

  2. Reinicie Visual Studio Code.

Depois que o cliente for reiniciado, consulte Verificar a conexão MCP do WinDbg.

GitHub Copilot não consegue localizar a sessão do WinDbg pretendida

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

Cause

O Serviço MCP não está em execução na janela do WinDbg pretendida ou mais de uma sessão do WinDbg está disponível e o proxy não pode selecionar uma sessão automaticamente.

Resolução

  1. Na janela WinDbg pretendida, selecione Serviço MCP.
  2. Peça ao cliente de IA para usar list_sessions.
  3. Identifique a ID do processo para a sessão WinDbg pretendida.
  4. Peça ao cliente de IA para usar connect_session com essa ID do processo.
  5. Confirme se o tipo de destino e o estado de execução que o cliente relata correspondem aos da janela WinDbg pretendida.

Para obter mais diretrizes de seleção de sessão, consulte Gerenciar sessões do WinDbg.

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

A sessão do WinDbg pretendida aparece indisponível quando o cliente de IA lista sessões ou tenta se conectar.

Cause

Outro cliente de IA tem uma conexão ativa com a sessão WinDbg. Somente um cliente MCP ativo pode se conectar a uma sessão do WinDbg de cada vez.

Resolução

  1. No cliente de IA conectado, peça ao cliente para usar disconnect_session.
  2. Confirme se o cliente relata que se desconectou da sessão do WinDbg.
  3. No cliente de IA desejado, peça ao cliente para usar list_sessions.
  4. Peça ao cliente de destino para usar connect_session com a ID do processo da sessão WinDbg.
  5. Confirme se o cliente relata uma conexão com a sessão desejada.

Acesso negado quando o WinDbg é elevado

A conexão falha com uma mensagem Acesso negado quando o WinDbg está em execução como administrador.

Cause

A sessão do WinDbg com privilégios elevados impede que o cliente de IA com suporte se conecte por meio do proxy.

Resolução

  1. Feche a sessão do WinDbg com privilégios elevados.
  2. Inicie o WinDbg sem selecionar Executar como administrador.
  3. Inicie o Serviço MCP.
  4. Carregue ou anexe ao destino de depuração conforme necessário.
  5. Abra o cliente de IA com suporte e conclua as etapas em Verificar a conexão MCP do WinDbg.

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

O cliente de IA informa que a proteção contra injeção de prompt bloqueou uma operação ou classificou a saída do depurador como não segura.

Cause

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

Resolução

  1. Siga as informações de erro que o cliente de IA relata.
  2. Examine a saída relevante diretamente 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. Examine a proteção contra injeção entre prompts antes de decidir como continuar.

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

O cliente de IA informa que a classificação de injeção de prompt não pode ser executada e a operação protegida falha sem retornar a saída.

Cause

O cliente de IA não dá suporte à amostragem mcp ou sua configuração ou política organizacional não permite amostragem mcp. A proteção do WinDbg XPIA exige amostragem MCP para solicitação da classificação do serviço de modelo configurado do cliente.

Resolução

  1. Confirme se o cliente de IA dá suporte à amostragem de MCP.
  2. Confirme se a configuração do cliente e sua política organizacional permitem a amostragem de MCP.
  3. Depois que a amostragem estiver disponível, execute a operação novamente.
  4. Se a classificação ainda não puder ser executada, examine a proteção contra injeção de prompt cruzado e contate o administrador que gerencia a política do cliente de IA.

Verificar a conexão MCP do WinDbg e relatar problemas não resolvidos

  • Última atualização em