Behandeln von Problemen beim Einrichten und Herstellen von Verbindungen mit WinDbg MCP

Verwenden Sie diesen Artikel, wenn Visual Studio Code mit GitHub Copilot oder GitHub Copilot CLI den WinDbg Model Context Protocol (MCP)-Server nicht registrieren kann, keine Verbindung mit einer WinDbg MCP-Sitzung herstellen kann oder wenn WinDbg MCP-Sicherheitssteuerelemente einen Vorgang blockieren. Durch die Registrierung wird der WinDbg MCP-Server zur Konfiguration des AI-Clients hinzugefügt, während beim Verbinden der Client mit einer bestimmten WinDbg-Sitzung verknüpft wird.

Anweisungen zum Einrichten finden Sie unter Installieren und Aktivieren von WinDbg MCP. Informationen zu autoritativen Sicherheits- und Datenschutzrichtlinien finden Sie unter WinDbg MCP-Sicherheits- und Datenschutzaspekte.

Beginnen Sie mit dem Symptom, das Sie beobachten, identifizieren Sie die wahrscheinliche Ursache, und führen Sie die Lösungsschritte aus.

Checkliste zur Problembehandlung

Bei MCP-Serverregistrierungsproblemen:

  1. Öffnen Sie WinDbg. Sie müssen kein Debuggingziel laden oder anfügen, um "Server aktivieren" zu verwenden oder MCP zu installieren.
  2. Öffnen Sie MCP-Serviceeinstellungen, und bestätigen Sie, dass Sie Server aktivieren ausgewählt haben.
  3. Vergewissern Sie sich, dass Sie Visual Studio Code oder GitHub Copilot CLI als Client ausgewählt haben.

Bei Verbindungs- oder Sitzungsproblemen:

  1. Starten Sie DEN MCP-Dienst im vorgesehenen WinDbg-Fenster.
  2. Wenn Sie ein Zielsystem analysieren, laden Sie das Debuggingziel oder stellen Sie bei Bedarf eine Verbindung damit her.

Die MCP-Serverliste enthält WinDbg nicht.

Die MCP-Serverliste des unterstützten AI-Clients enthält WinDbg nicht.

Ursache

Install MCP hat WinDbg nicht für den Client registriert, oder der Client hat seine MCP-Serverkonfiguration nicht neu geladen.

Resolution

  1. Starten Sie den KI-Client neu, und überprüfen Sie dann die MCP-Serverliste.
  2. Öffnen Sie in WinDbg MCP-Diensteinstellungen , und wählen Sie den richtigen unterstützten Client aus.
  3. Wählen Sie MCP installieren erneut.
  4. Schließen Sie jede Bestätigung ab, die der Client anzeigt.
  5. Starten Sie den Client neu, und überprüfen Sie dann die MCP-Serverliste erneut.

Wenn WinDbg immer noch fehlt, weil Install MCP fehlschlägt, registrieren Sie WinDbg manuell.

Manuelles Registrieren eines unterstützten Clients

Verwenden Sie diesen Fallback nur, wenn MCP installieren WinDbg nicht für Visual Studio Code oder die GitHub Copilot CLI registriert.

  1. Öffnen Sie in WinDbg MCP-Diensteinstellungen.
  2. Wählen Sie "Benutzerdefiniert" aus, um die Proxykonfiguration anzuzeigen. Wenn Sie in diesem Schritt " Benutzerdefiniert" auswählen, wird nur der Proxybefehl für die Konfiguration unterstützter Clients bereitgestellt.
  3. Wählen Sie In Zwischenablage kopieren aus, und notieren Sie sich den command Pfad, den WinDbg in die Zwischenablage kopiert.

Konfigurieren Sie den unterstützten Clienttyp:

  1. Fügen Sie in Ihrem Arbeitsbereich den WinDbg-Server zu .vscode/mcp.json hinzu. Ersetzen Sie den Beispielwert command durch den Pfad aus der Zwischenablage:

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

  2. Starten Sie Visual Studio Code neu.

Nach dem Neustart des Clients siehe Überprüfen Sie die WinDbg MCP-Verbindung.

GitHub Copilot kann die beabsichtigte WinDbg-Sitzung nicht finden.

Visual Studio Code mit GitHub Copilot und GitHub Copilot CLI kann die WinDbg-Sitzung, die das beabsichtigte Debuggingziel enthält, nicht finden.

Ursache

DER MCP-Dienst wird nicht im vorgesehenen WinDbg-Fenster ausgeführt, oder mehr als eine WinDbg-Sitzung ist verfügbar, und der Proxy kann keine Sitzung automatisch auswählen.

Resolution

  1. Wählen Sie im vorgesehenen WinDbg-Fenster MCP-Dienst aus.
  2. Bitten Sie den KI-Client, list_sessions zu verwenden.
  3. Identifizieren Sie die Prozess-ID für die beabsichtigte WinDbg-Sitzung.
  4. Fordern Sie den KI-Client auf, connect_session mit dieser Prozess-ID zu verwenden.
  5. Vergewissern Sie sich, dass der Zieltyp und der Ausführungsstatus, die der Client meldet, mit denen im vorgesehenen WinDbg-Fenster übereinstimmen.

Weitere Anleitungen zur Sitzungsauswahl finden Sie unter Verwalten von WinDbg-Sitzungen.

WinDbg-Sitzung ist nicht verfügbar, da ein anderer Client verbunden ist

Die beabsichtigte WinDbg-Sitzung erscheint als nicht verfügbar, wenn der KI-Client Sitzungen auflistet oder versucht, eine Verbindung herzustellen.

Ursache

Ein anderer KI-Client verfügt über eine aktive Verbindung zur WinDbg-Sitzung. Es kann jeweils nur ein aktiver MCP-Client eine Verbindung mit einer WinDbg-Sitzung herstellen.

Resolution

  1. Fordern Sie den Client im verbundenen KI-Client auf, disconnect_session zu verwenden.
  2. Vergewissern Sie sich, dass der Client meldet, dass die Verbindung zur WinDbg-Session getrennt wurde.
  3. Fordern Sie im vorgesehenen KI-Client den Client auf, list_sessions zu verwenden.
  4. Fordern Sie den betroffenen Client auf, connect_session mit der Prozess-ID der WinDbg-Session zu verwenden.
  5. Vergewissern Sie sich, dass der Client meldet, dass eine Verbindung zur beabsichtigten Session besteht.

Zugriff verweigert, wenn WinDbg mit erhöhten Rechten versehen ist

Die Verbindung schlägt mit der Meldung "Zugriff verweigert" fehl, wenn WinDbg als Administrator ausgeführt wird.

Ursache

Die WinDbg-Sitzung mit erhöhten Rechten verhindert, dass der unterstützte KI-Client eine Verbindung über den Proxy herstellt.

Resolution

  1. Schließen Sie die WinDbg-Sitzung mit erhöhten Rechten.
  2. Starten Sie WinDbg, ohne "Als Administrator ausführen" auszuwählen.
  3. Starten Sie den MCP-Dienst.
  4. Laden Sie das Debuggingziel oder stellen Sie bei Bedarf eine Verbindung damit her.
  5. Öffnen Sie den unterstützten KI-Client, und führen Sie die Schritte unter Überprüfen der WinDbg MCP-Verbindung aus.

Schutz vor Prompt-Injection blockiert einen Vorgang

Der KI-Client meldet, dass der Schutz vor Prompt-Injection einen Vorgang blockiert oder die Debuggerausgabe als unsicher klassifiziert hat.

Ursache

WinDbg cross-prompt injection attack (XPIA) protection identifizierte die Debuggerausgabe als potenziell unsicher und blockierte die Ausgabe.

Resolution

  1. Folgen Sie den Fehlerinformationen, die der KI-Client meldet.
  2. Überprüfen Sie die relevante Ausgabe direkt in WinDbg.
  3. Behandeln Sie die Ausgabe als nicht vertrauenswürdig, und senden Sie die blockierte Ausgabe nicht an den KI-Client.
  4. Überprüfen Sie Schutz vor promptübergreifender Injektion, bevor Sie entscheiden, wie Sie fortfahren.

Die Prompt-Injection-Klassifizierung kann nicht ausgeführt werden, da der KI-Client MCP-Sampling nicht unterstützt oder zulässt.

Der KI-Client meldet, dass die Prompt-Injection-Klassifizierung nicht ausgeführt werden kann und der geschützte Vorgang fehlschlägt, ohne eine Ausgabe zurückzugeben.

Ursache

Der KI-Client unterstützt kein MCP-Sampling, oder seine Konfiguration oder Organisationsrichtlinie lässt keine MCP-Samplings zu. Der WinDbg XPIA-Schutz erfordert MCP-Sampling, um die Klassifizierung vom konfigurierten Modelldienst des Clients anzufordern.

Resolution

  1. Vergewissern Sie sich, dass der KI-Client MCP-Sampling unterstützt.
  2. Vergewissern Sie sich, dass die Clientkonfiguration und Ihre Organisationsrichtlinie MCP Sampling zulassen.
  3. Führen Sie den Vorgang erneut aus, nachdem das Sampling verfügbar ist.
  4. Wenn die Klassifizierung immer noch nicht ausgeführt werden kann, überprüfen Sie den Cross-Prompt-Injection-Schutz und wenden Sie sich an den Administrator, der die Richtlinie des KI-Clients verwaltet.

Überprüfen Sie die WinDbg MCP-Verbindung und melden Sie nicht behobene Probleme

  • Zuletzt aktualisiert um