Risolvere i problemi di configurazione di WinDbg MCP e di connessione

Usare questo articolo quando Visual Studio Code con GitHub Copilot o l'interfaccia della riga di comando di GitHub Copilot non è in grado di registrare il server McP (WinDbg Model Context Protocol), non può connettersi a una sessione MCP WinDbg o i controlli di sicurezza MCP winDbg bloccano un'operazione. La registrazione aggiunge il server MCP WinDbg alla configurazione del client di intelligenza artificiale, mentre la connessione associa il client a una sessione WinDbg specifica.

Per istruzioni sull'installazione, vedere Installare e abilitare WinDbg MCP. Per indicazioni autorevoli sulla sicurezza e sulla privacy, vedere Considerazioni sulla sicurezza e la privacy di WinDbg MCP.

Iniziare con il sintomo osservato, identificare la causa probabile e completare i passaggi di risoluzione.

Elenco di controllo per la risoluzione dei problemi

Per i problemi di registrazione del server MCP:

  1. Apri WinDbg. Non è necessario caricare o collegare a una destinazione di debug per usare Enable Server o Installa MCP.
  2. Aprire le impostazioni del servizio MCP e verificare di aver selezionato Abilita server.
  3. Verificare di aver selezionato Visual Studio Code o GitHub Copilot CLI come client.

Per problemi di connessione o sessione:

  1. Avviare il servizio MCP nella finestra WinDbg desiderata.
  2. Se si analizza un target, si carica o ci si collega al target di debug in base alle esigenze.

L'elenco dei server MCP non include WinDbg

L'elenco dei server MCP del client di intelligenza artificiale supportato non include WinDbg.

Cause

Installa MCP non ha registrato WinDbg con il client o il client non ha ricaricato la configurazione del server MCP.

Resolution

  1. Riavviare il client di intelligenza artificiale e quindi controllare l'elenco dei server MCP.
  2. In WinDbg aprire le impostazioni del servizio MCP e selezionare il client supportato corretto.
  3. Seleziona di nuovo Installa MCP.
  4. Completare tutte le conferme visualizzate dal client.
  5. Riavviare il client e quindi controllarne di nuovo l'elenco dei server MCP.

Se WinDbg è ancora mancante perché Install MCP non riesce, registrare manualmente WinDbg.

Registrare manualmente un client supportato

Usare questo fallback solo quando Install MCP non registra WinDbg con Visual Studio Code o GitHub Copilot cli.

  1. In WinDbg aprire le impostazioni del servizio MCP.
  2. Selezionare Personalizzato per visualizzare la configurazione del proxy. Se si seleziona Personalizzato in questo passaggio, viene fornito solo il comando proxy per la configurazione del client supportato.
  3. Selezionare Copia negli Appunti e prendere nota del command percorso che WinDbg copia negli Appunti.

Configurare il client supportato:

  1. Nell'area di lavoro aggiungere il server WinDbg a .vscode/mcp.json. Sostituire il valore di esempio command con il percorso dagli Appunti:

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

  2. Riavviare Visual Studio Code.

Dopo il riavvio del client, vedere Verificare la connessione MCP winDbg.

GitHub Copilot non riesce a trovare la sessione WinDbg desiderata

Visual Studio Code con GitHub Copilot e GitHub Copilot CLI non riescono a trovare la sessione WinDbg che contiene la destinazione di debug prevista.

Cause

Il servizio MCP non è in esecuzione nella finestra WinDbg desiderata o è disponibile più di una sessione WinDbg e il proxy non può selezionare automaticamente una sessione.

Resolution

  1. Nella finestra di WinDbg desiderata selezionare MCP Service.
  2. Chiedere al client di intelligenza artificiale di usare list_sessions.
  3. Identificare l'ID del processo per la sessione WinDbg desiderata.
  4. Chiedere al client di intelligenza artificiale di usare connect_session con tale ID processo.
  5. Verificare che il tipo di destinazione e lo stato di esecuzione riportati dal client corrispondano a quelli nella finestra WinDbg prevista.

Per altre indicazioni sulla selezione delle sessioni, vedere Gestire sessioni WinDbg.

Sessione WinDbg non disponibile perché un altro client è connesso

La sessione WinDbg prevista non è disponibile quando il client di intelligenza artificiale elenca le sessioni o tenta di connettersi.

Cause

Un altro client di intelligenza artificiale ha una connessione attiva alla sessione WinDbg. Solo un client MCP attivo può connettersi a una sessione WinDbg alla volta.

Resolution

  1. Nel client di intelligenza artificiale connesso chiedere al client di usare disconnect_session.
  2. Verificare che il client segnali che si è disconnesso dalla sessione WinDbg.
  3. Nel client di intelligenza artificiale previsto chiedere al client di usare list_sessions.
  4. Chiedere al client interessato di usare connect_session con l'ID del processo della sessione WinDbg.
  5. Verificare che il client segnali una connessione alla sessione prevista.

Accesso negato quando WinDbg viene eseguito come amministratore

La connessione ha esito negativo con un messaggio di accesso negato quando WinDbg è in esecuzione come amministratore.

Cause

La sessione WinDbg con privilegi elevati impedisce al client di intelligenza artificiale supportato di connettersi tramite il proxy.

Resolution

  1. Chiudere la sessione WinDbg con privilegi elevati.
  2. Avviare WinDbg senza selezionare Esegui come amministratore.
  3. Avvia il servizio MCP.
  4. Caricare o collegarsi al target di debug in base alle esigenze.
  5. Aprire il client di intelligenza artificiale supportato e completare i passaggi descritti in Verificare la connessione MCP winDbg.

La protezione dall'iniezione di prompt blocca un'operazione

Il client di intelligenza artificiale segnala che la protezione prompt-injection ha bloccato un'operazione o ha classificato come non sicuro l'output del debugger.

Cause

La protezione xpia (Cross-Prompt Injection Attack) di WinDbg ha identificato l'output del debugger come potenzialmente non sicuro e ha bloccato l'output.

Resolution

  1. Seguire le informazioni sull'errore riportate dal client di intelligenza artificiale.
  2. Esaminare l'output pertinente direttamente in WinDbg.
  3. Considerare l'output come non attendibile e non inviare l'output bloccato al client di intelligenza artificiale.
  4. Prima di decidere come continuare, consultare protezione dall'iniezione tra prompt.

La classificazione prompt injection non può essere eseguita perché il client di intelligenza artificiale non supporta o consente il campionamento MCP

Il client di intelligenza artificiale segnala che la classificazione prompt-injection non può essere eseguita e l'operazione protetta ha esito negativo senza restituire l'output.

Cause

Il client di intelligenza artificiale non supporta il campionamento MCP o la configurazione o i criteri dell'organizzazione non consentono il campionamento MCP. La protezione XPIA winDbg richiede il campionamento MCP per richiedere la classificazione dal servizio modello configurato del client.

Resolution

  1. Verificare che il client di intelligenza artificiale supporti il campionamento MCP.
  2. Verificare che la configurazione client e i criteri dell'organizzazione consentano il campionamento MCP.
  3. Dopo aver eseguito il campionamento, eseguire di nuovo l'operazione.
  4. Se la classificazione non può ancora essere eseguita, vedere Protezione cross-prompt injection e contattare l'amministratore che gestisce i criteri del client di intelligenza artificiale.

Verificare la connessione MCP winDbg e segnalare i problemi non risolti

  • Ultimo aggiornamento: