Problemen met de installatie en verbinding van WinDbg MCP oplossen

Gebruik dit artikel wanneer Visual Studio Code met GitHub Copilot of GitHub Copilot CLI de MCP-server (WinDbg Model Context Protocol) niet kan registreren, geen verbinding kan maken met een WinDbg MCP-sessie of wanneer WinDbg MCP-beveiligingsmaatregelen een bewerking blokkeren. Bij het registreren wordt de WinDbg MCP-server toegevoegd aan de configuratie van de AI-client, terwijl de client wordt gekoppeld aan een specifieke WinDbg-sessie.

Zie WinDbg MCP installeren en inschakelen voor installatie-instructies. Zie WinDbg MCP-beveiligings- en privacyoverwegingen voor gezaghebbende richtlijnen voor beveiliging en privacy.

Begin met het symptoom dat u ziet, identificeer de waarschijnlijke oorzaak en voltooi de oplossingsstappen.

Controlelijst voor probleemoplossing

Voor problemen met MCP-serverregistratie:

  1. Open WinDbg. U hoeft geen foutopsporingsdoel te laden of te koppelen om Server inschakelen of MCP installeren te gebruiken.
  2. Open de MCP-service-instellingen en bevestig dat u Server inschakelen hebt geselecteerd.
  3. Controleer of u Visual Studio Code of GitHub Copilot CLI als client hebt geselecteerd.

Voor verbinding of sessieproblemen:

  1. Start DE MCP-service in het beoogde WinDbg-venster.
  2. Als u een doelobject analyseert, laadt u indien nodig het foutopsporingsdoel of maakt u er verbinding mee.

De MCP-serverlijst bevat geen WinDbg

De mcp-serverlijst van de ondersteunde AI-client bevat geen WinDbg.

Oorzaak

Install MCP heeft WinDbg niet geregistreerd bij de client of de client heeft de configuratie van de MCP-server niet opnieuw geladen.

Resolutie / Besluit

  1. Start de AI-client opnieuw en controleer vervolgens de MCP-serverlijst.
  2. Open in WinDbg de MCP-service-instellingen en selecteer de juiste ondersteunde client.
  3. Selecteer Installeer MCP opnieuw.
  4. Voltooi elke bevestiging die de client weergeeft.
  5. Start de client opnieuw op en controleer de MCP-serverlijst opnieuw.

Als WinDbg nog steeds ontbreekt omdat Install MCP mislukt, registreert u WinDbg handmatig.

Een ondersteunde client handmatig registreren

Gebruik deze terugval alleen wanneer Install MCP WinDbg niet registreert bij Visual Studio Code of GitHub Copilot CLI.

  1. Open de MCP-service-instellingen in WinDbg.
  2. Selecteer Aangepast om de proxyconfiguratie weer te geven. Het selecteren van Aangepast in deze stap biedt alleen de proxyopdracht voor de ondersteunde clientconfiguratie.
  3. Selecteer Kopiëren naar Klembord en noteer het command pad dat WinDbg naar het Klembord kopieert.

Configureer de ondersteunde client:

  1. Voeg in uw werkruimte de WinDbg-server toe aan .vscode/mcp.json. Vervang de voorbeeldwaarde command door het pad van het Klembord:

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

  2. Start Visual Studio Code opnieuw.

Nadat de client opnieuw is opgestart, zie De WinDbg MCP-verbinding controleren.

GitHub Copilot kan de beoogde WinDbg-sessie niet vinden

Visual Studio Code met GitHub Copilot en GitHub Copilot CLI kan de WinDbg-sessie met het beoogde foutopsporingsdoel niet vinden.

Oorzaak

MCP-service wordt niet uitgevoerd in het beoogde WinDbg-venster of er is meer dan één WinDbg-sessie beschikbaar en de proxy kan geen sessie automatisch selecteren.

Resolutie / Besluit

  1. Selecteer MCP-service in het beoogde WinDbg-venster.
  2. Vraag de AI-client list_sessions te gebruiken.
  3. Identificeer de proces-id voor de beoogde WinDbg-sessie.
  4. Vraag de AI-client om connect_session met die proces-id te gebruiken.
  5. Controleer of het doeltype en de uitvoeringsstatus die de client rapporteert overeenkomen met die in het beoogde WinDbg-venster.

Zie WinDbg-sessies beheren voor meer richtlijnen voor sessieselectie.

WinDbg-sessie is niet beschikbaar omdat er een andere client is verbonden

De beoogde WinDbg-sessie lijkt niet beschikbaar te zijn wanneer de AI-client sessies vermeldt of probeert verbinding te maken.

Oorzaak

Een andere AI-client heeft een actieve verbinding met de WinDbg-sessie. Slechts één actieve MCP-client kan tegelijkertijd verbinding maken met een WinDbg-sessie.

Resolutie / Besluit

  1. Vraag de client in de verbonden AI-client om disconnect_session te gebruiken.
  2. Controleer of de client rapporteert dat de client de verbinding met de WinDbg-sessie heeft verbroken.
  3. Vraag in de beoogde AI-client om list_sessions te gebruiken.
  4. Vraag de beoogde client om connect_session te gebruiken met de proces-id van de WinDbg-sessie.
  5. Controleer of de client een verbinding met de beoogde sessie rapporteert.

Toegang geweigerd wanneer WinDbg met verhoogde bevoegdheden wordt uitgevoerd

De verbinding mislukt met een bericht Toegang geweigerd wanneer WinDbg als beheerder wordt uitgevoerd.

Oorzaak

De verhoogde WinDbg-sessie voorkomt dat de ondersteunde AI-client via de proxy verbinding maakt.

Resolutie / Besluit

  1. Sluit de WinDbg-sessie met verhoogde rechten.
  2. Start WinDbg zonder Uitvoeren als administrator te selecteren.
  3. Start MCP-service.
  4. Laad of maak indien nodig verbinding met het foutopsporingsdoel.
  5. Open de ondersteunde AI-client en voltooi de stappen in De WinDbg MCP-verbinding verifiëren.

Bescherming tegen prompt-injectie blokkeert een bewerking

De AI-client meldt dat prompt-injectiebeveiliging een bewerking heeft geblokkeerd of dat de uitvoer van het foutopsporingsprogramma als onveilig is geclassificeerd.

Oorzaak

WinDbg-bescherming tegen cross-prompt-injectieaanvallen (XPIA) identificeerde de uitvoer van het foutopsporingsprogramma als mogelijk onveilig en blokkeerde de uitvoer.

Resolutie / Besluit

  1. Volg de foutinformatie die door de AI-client wordt gerapporteerd.
  2. Controleer de relevante uitvoer rechtstreeks in WinDbg.
  3. Behandel de uitvoer als niet-vertrouwd en verzend de geblokkeerde uitvoer niet naar de AI-client.
  4. Controleer de bescherming tegen cross-prompt-injectie voordat u besluit hoe u doorgaat.

Classificatie van prompt-injectie kan niet worden uitgevoerd omdat de AI-client geen ondersteuning biedt voor MCP-sampling of dit toestaat

De AI-client meldt dat de classificatie van prompt-injectie niet kan worden uitgevoerd en dat de beveiligde bewerking mislukt zonder uitvoer te retourneren.

Oorzaak

De AI-client biedt geen ondersteuning voor MCP-sampling, of de configuratie of het organisatiebeleid staat MCP-sampling niet toe. WinDbg XPIA-beveiliging vereist MCP-sampling om classificatie aan te vragen bij de geconfigureerde modelservice van de client.

Resolutie / Besluit

  1. Controleer of de AI-client MCP-sampling ondersteunt.
  2. Controleer of de clientconfiguratie en uw organisatiebeleid MCP-steekproeven toestaan.
  3. Nadat sampling beschikbaar is, voert u de bewerking opnieuw uit.
  4. Als de classificatie nog steeds niet kan worden uitgevoerd, controleert u Bescherming tegen cross-promptinjectie en neemt u contact op met de beheerder die het beleid van de AI-client beheert.

Controleer de WinDbg MCP-verbinding en meld onopgeloste problemen

  • Laatst bijgewerkt om