Felsöka problem med konfiguration och anslutning av WinDbg MCP

Använd den här artikeln när Visual Studio Code med GitHub Copilot eller GitHub Copilot CLI inte kan registrera MCP-servern för WinDbg Model Context Protocol, inte kan ansluta till en WinDbg MCP-session eller WinDbg MCP-säkerhetskontroller blockerar en åtgärd. Registrering lägger till WinDbg MCP-servern i AI-klientens konfiguration, samtidigt som klienten associeras med en specifik WinDbg-session.

För installationsinstruktioner, se Installera och aktivera WinDbg MCP. Auktoritativ säkerhets- och sekretessvägledning finns i WinDbg MCP-säkerhets- och sekretessöverväganden.

Börja med det symptom som du observerar, identifiera den troliga orsaken och slutför lösningsstegen.

Checklista för felsökning

För MCP-serverregistreringsproblem:

  1. Öppna WinDbg. Du behöver inte läsa in eller ansluta till ett felsökningsmål för att använda Aktivera server eller Installera MCP.
  2. Öppna inställningarna för MCP-tjänsten och bekräfta att du har valt Aktivera server.
  3. Bekräfta att du har valt Visual Studio Code eller GitHub Copilot CLI som klient.

För anslutning eller sessionsproblem:

  1. Starta MCP-tjänsten i det avsedda WinDbg-fönstret.
  2. Om du analyserar en målprocess läser du in eller ansluter till felsökningsmålet efter behov.

MCP-serverlistan innehåller inte WinDbg

Den AI-klients MCP-serverlista som stöds innehåller inte WinDbg.

Orsak

Install MCP registrerade inte WinDbg med klienten, eller så har klienten inte läst in sin MCP-serverkonfiguration igen.

Lösning

  1. Starta om AI-klienten och kontrollera sedan dess MCP-serverlista.
  2. I WinDbg öppnar du inställningarna för MCP-tjänsten och väljer rätt kompatibla klient.
  3. Välj Installera MCP igen.
  4. Slutför alla bekräftelser som programmet visar.
  5. Starta om klienten och kontrollera sedan MCP-serverlistan igen.

Om WinDbg fortfarande saknas eftersom Install MCP misslyckas registrerar du WinDbg manuellt.

Registrera en klient som stöds manuellt

Använd den här reservlösningen endast när Install MCP inte registrerar WinDbg med Visual Studio Code eller GitHub Copilot CLI.

  1. Öppna MCP-tjänstinställningar i WinDbg.
  2. Välj Anpassad för att visa proxykonfigurationen. Om du väljer Anpassad i det här steget får du bara proxykommandot för konfigurationen för den klient som stöds.
  3. Välj Kopiera till Urklipp och notera sökvägen command som WinDbg kopierar till Urklipp.

Konfigurera den klient som stöds:

  1. I din arbetsyta lägger du till WinDbg-servern i .vscode/mcp.json. Ersätt exempelvärdet command med sökvägen från Urklipp:

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

  2. Starta om Visual Studio Code.

När klienten har startats om, se Verifiera WinDbg MCP-anslutningen.

GitHub Copilot kan inte hitta den avsedda WinDbg-sessionen

Visual Studio Code med GitHub Copilot och GitHub Copilot CLI kan inte hitta WinDbg-sessionen som innehåller det avsedda felsökningsmålet.

Orsak

MCP-tjänsten körs inte i det avsedda WinDbg-fönstret, eller så är mer än en WinDbg-session tillgänglig och proxyn kan inte välja en session automatiskt.

Lösning

  1. I det avsedda WinDbg-fönstret väljer du MCP Service.
  2. Be AI-klienten att använda list_sessions.
  3. Identifiera process-ID:t för den avsedda WinDbg-sessionen.
  4. Be AI-klienten att använda connect_session med det process-ID:t.
  5. Bekräfta att måltypen och körningstillståndet som klienten rapporterar matchar dem i det avsedda WinDbg-fönstret.

Mer vägledning för sessionsval finns i Hantera WinDbg-sessioner.

WinDbg-sessionen är inte tillgänglig eftersom en annan klient är ansluten

Den avsedda WinDbg-sessionen verkar inte vara tillgänglig när AI-klienten visar sessioner eller försöker ansluta.

Orsak

En annan AI-klient har en aktiv anslutning till WinDbg-sessionen. Endast en aktiv MCP-klient kan ansluta till en WinDbg-session i taget.

Lösning

  1. I den anslutna AI-klienten ber du klienten att använda disconnect_session.
  2. Bekräfta att klienten rapporterar att den kopplades från WinDbg-sessionen.
  3. I den avsedda AI-klienten ber du klienten att använda list_sessions.
  4. Be den avsedda klienten att använda connect_session med WinDbg-sessionens process-ID.
  5. Bekräfta att klienten rapporterar en anslutning till den avsedda sessionen.

Åtkomst nekad när WinDbg körs som administratör

Anslutningen misslyckas med ett meddelande om nekad åtkomst när WinDbg körs som administratör.

Orsak

Den förhöjda WinDbg-sessionen förhindrar att AI-klienten som stöds ansluter via proxyn.

Lösning

  1. Stäng WinDbg-sessionen som körs som administratör.
  2. Starta WinDbg utan att välja Kör som administratör.
  3. Starta MCP-tjänsten.
  4. Läs in eller koppla till felsökningsmålet efter behov.
  5. Öppna AI-klienten som stöds och slutför stegen i Verifiera WinDbg MCP-anslutningen.

Skydd mot prompt-injektion blockerar en åtgärd

AI-klienten rapporterar att prompt-injection protection blockerade en åtgärd eller klassificerade felsökningsutdata som osäkra.

Orsak

WinDbg-skydd för cross-prompt injection attack (XPIA) identifierade felsökningsprogrammets utdata som potentiellt osäkra och blockerade utdata.

Lösning

  1. Följ felinformationen som AI-klienten rapporterar.
  2. Granska den relevanta utdatan direkt i WinDbg.
  3. Behandla utdata som opålitliga och skicka inte blockerade utdata till AI-klienten.
  4. Granska skydd mot cross-prompt-injektion innan du bestämmer dig för hur du ska fortsätta.

Klassificering av promptinjektion kan inte köras eftersom AI-klienten inte stöder eller tillåter MCP-sampling

AI-klienten rapporterar att klassificering av prompt-injection inte kan köras, och den skyddade åtgärden misslyckas utan att returnera utdata.

Orsak

AI-klienten stöder inte MCP-sampling, eller dess konfiguration eller organisationens policy tillåter inte MCP-sampling. WinDbg XPIA-skydd kräver MCP-sampling för att begära klassificering från klientens konfigurerade modelltjänst.

Lösning

  1. Bekräfta att AI-klienten stöder MCP-sampling.
  2. Bekräfta att klientkonfigurationen och organisationens policy tillåter MCP-sampling.
  3. När samplingen är tillgänglig kör du åtgärden igen.
  4. Om klassificeringen fortfarande inte kan köras granskar du Skydd mot promptinjektion mellan promptar och kontaktar administratören som hanterar AI-klientens policy.

Verifiera WinDbg MCP-anslutningen och rapportera olösta problem

  • Uppdaterades senast