Konfigurera och använda WinDbg MCP

Använd WinDbg MCP för att undersöka ett felsökningsmål med en AI-klient som stöds medan du granskar AI-initierade felsökningsåtgärder i WinDbg. WinDbg MCP använder Model Context Protocol (MCP) för att förse klienten med WinDbg-felsökningsverktyg och kontext under analysen.

AI-genererade resultat är inte auktoritativa. Verifiera iakttagelser, bevis, antaganden, måltillstånd och kommandon mot utdata i WinDbg.

Den här artikeln visar hur du registrerar WinDbg med Visual Studio Code med GitHub Copilot eller GitHub Copilot CLI, ansluter den valda klienten till den avsedda WinDbg-sessionen och använder anslutningen för AI-assisterad felsökning.

Prerequisites

• Bekräfta att din organisation tillåter WinDbg MCP. Administratörer kan inaktivera det genom att aktivera WinDbg-begränsat läge.
• Hämta WinDbg version 1.2610.1001.0 eller senare från Microsoft Store WinDbg-appen eller WinDbg-nedladdningen.
• En av följande AI-klienter som stöds:
  • Visual Studio Code med GitHub Copilot
  • GitHub Copilot CLI
• Auktorisering för att använda felsökningsmålet och dess data med den valda AI-klienten och dess konfigurerade modelltjänst.
• Granskning av vägledning om säkerhet, sekretess och sessionsgränser i WinDbg MCP overview.

Installera och aktivera WinDbg MCP

I det här avsnittet registrerar du WinDbg som en MCP-server med din valda AI-klient, startar MCP-tjänsten för den aktuella WinDbg-sessionen, som aktiverar säkert läge som standard, och ansluter klienten till ett felsökningsmål så att du kan påbörja AI-assisterad analys. Du behöver inte ladda eller ansluta till ett felsökningsmål för att aktivera servern eller registrera WinDbg med en AI-klient som stöds.

Följ dessa steg för att installera och aktivera MCP-servern:

1. Öppna WinDbg. Om du vill öppna den söker du efter WinDbg i Start-menyn och väljer den.

2. På menyn File i WinDbg väljer du Inställningar.

3. På sidan Inställningar väljer du MCP-tjänstinställningar, väljer Aktivera server och sedan din klient i listan Klient . Välj VS Code för Visual Studio Code med GitHub Copilot eller välj GitHub Copilot CLI om du använder GitHub Copilot CLI.

   

4. Använd de numrerade kontrollerna i menyfliksområdet WinDbg för att installera servern, starta tjänsten och öppna klienten.

   

5. Välj Installera MCP (1) för att registrera WinDbg som en MCP-server med den valda klienten och slutför sedan alla bekräftelser som klienten visar. Ett meddelande bekräftar att WinDbg registrerade MCP-servern hos den valda klienten.

   

6. Välj MCP-tjänsten (2) för att starta MCP-servern för den aktuella WinDbg-sessionen. I sekretess- och säkerhetsvarningen granskar du följande beteenden för säkert läge:

   • Standard: WinDbg väljer Aktivera säkert läge när MCP-servern startar som standard.
   • Aktivering: Om du lämnar kryssrutan markerad när MCP-servern startar aktiveras säkert läge. Efter aktiveringen kan secure mode inte stängas av och förblir aktivt förrän WinDbg startas om.
   • Sparad inställning: Om du avmarkerar eller markerar kryssrutan uppdateras den sparade inställningen >>>Aktivera säkert läge för MCP-server så att den matchar kryssrutans tillstånd.

   Bekräfta att du godkänner det avsedda felsökningsmålet och dess data för användning med den valda AI-klienten och dess konfigurerade modelltjänst och välj sedan Ja.

   

   WinDbg-sekretess- och säkerhetsvarningen förklarar att start av MCP-servern kan exponera känslig felsökningsmålinformation för ej betrodda parter. Den varnar för att inte använda servern med personliga, konfidentiella, proprietära eller andra data som du inte äger eller inte har behörighet att lämna ut. AI-drivna felsökningsåtgärder kan direkt eller indirekt läsa in eller köra obetrodd kod, vilket kan äventyra säkerheten, skada data eller skada systemet eller enheterna. Säkerhetsläge minskar dessa risker genom att begränsa felsökningsåtgärder som kan läsa in eller köra obetrodd kod, starta processer eller utföra osäkra filåtgärder. WinDbg markerar kryssrutan **Aktivera säkert läge när MCP-servern startar** som standard. Säkert läge aktiveras när servern startar och förblir aktiv tills WinDbg startas om. Att avmarkera kryssrutan ändrar inställningen för den sparade MCP-tjänsten. Om du väljer **Ja** bekräftar du varningarna och startar servern. Om du väljer **Nej** avbryts åtgärden.

   Mer information om säkert läge finns i Säkert läge.

7. Läs in eller koppla till ett felsökningsmål.

8. Välj Öppna chatt (3) för att öppna den valda AI-klienten och starta en chatt.

Verifiera WinDbg MCP-anslutningen

1. Bekräfta att statusfältet WinDbg visar AI-klienten ansluten till MCP-servern.

   

2. Bekräfta att WinDbg MCP är tillgängligt i AI-klienten.

3. Ange följande fråga:

   Use WinDbg MCP to report the current target type and execution state.
   

4. Bekräfta att AI-klienten använder WinDbg MCP-verktyg och rapporterar måltypen och körningstillståndet som WinDbg visar.

Om klienten inte ansluter eller om resultatet inte matchar målet, se Felsöka problem med WinDbg MCP-installation och anslutning.

Analysera ett felsökningsmål med WinDbg MCP

När du har verifierat anslutningen kan du prova en omedelbar analysfråga:

Analyze this debugging target and provide the likely cause, supporting evidence, and remaining assumptions.

Jämför AI-klientens resultat med måltillståndet och synliga felsökningsutdata innan du agerar på dem. För tillgängliga verktyg och inbyggda promptar, se WinDbg MCP-verktyg och -promptar. För scenarier som stöds, se Använd WinDbg MCP för felsökning.

Skriv effektiva WinDbg MCP-frågor

Ge AI-klienten tillräckligt med kontext för att välja lämpliga WinDbg MCP-verktyg och skapa resultat som du kan verifiera:

• Identifiera felsökningsmålet och uppgiften, till exempel att analysera en kraschdump, undersöka ett live-mål eller undersöka en Time Travel Debugging-spårning.
• Be om stödjande bevis och återstående antaganden, inte bara en slutsats.
• Begär relevanta felsökningskommandon, diagnostik, källgranskning eller skript när du behöver en viss typ av analys.
• Ange utdataformatet, till exempel ett träd, rutnät, diagram eller en ordnad undersökningsplan.
• Jämför resultatet med måltillståndet, kommandona och de synliga felsökningsutdata i WinDbg innan du agerar på det.

Hantera WinDbg-sessioner

Dessa procedurer förutsätter att du har slutfört installationen, öppnat ai-klientens chatt som stöds, bekräftat att WinDbg MCP är tillgängligt i klienten och startat MCP-tjänsten i varje WinDbg-fönster som du vill använda. Begär kommandon för sessionsval via AI-klientens chatt; ange inte verktygsnamnen direkt i WinDbg.

WinDbg MCP-proxyn ansluter automatiskt när den identifierar exakt en tillgänglig WinDbg-session. Om fler än en session är tillgänglig förblir AI-klienten frånkopplad tills du väljer en session.

Anslut AI-klienten när flera WinDbg-sessioner är tillgängliga

Använd den här proceduren när flera WinDbg-sessioner är tillgängliga och AI-klienten inte är ansluten till en. Efter proceduren ansluter klienten till den valda sessionen.

1. Be AI-klienten att använda list_sessions.
2. Identifiera process-ID:t för den avsedda WinDbg-sessionen i resultatet.
3. Be AI-klienten att använda connect_session med det process-ID:t.
4. Bekräfta att klienten rapporterar en anslutning till den avsedda sessionen och att dess måltillstånd matchar det valda WinDbg-fönstret.

Växla AI-klienten till en annan WinDbg-session

Använd den här proceduren när AI-klienten är ansluten till en WinDbg-session och du vill att den ska använda en annan session. Efter proceduren kopplar klienten från den ursprungliga sessionen och ansluter till den valda ersättningssessionen.

1. Be AI-klienten att använda disconnect_session.
2. Be AI-klienten att använda list_sessions.
3. Ta reda på process-ID:t för den nya WinDbg-sessionen.
4. Be AI-klienten att använda connect_session med det process-ID:t.
5. Bekräfta att klienten rapporterar en anslutning till den nya sessionen och verifiera dess måltyp och körningstillstånd mot det valda WinDbg-fönstret.

Koppla bort AI-klienten från den aktuella WinDbg-sessionen

Använd den här proceduren när AI-klienten är ansluten till en WinDbg-session och du vill avsluta anslutningen. Efter proceduren har klienten ingen anslutning till en WinDbg-session. WinDbg och MCP-tjänsten kan fortsätta att köras.

1. Be AI-klienten att använda disconnect_session.
2. Bekräfta att klienten rapporterar att proxyn är frånkopplad från WinDbg-sessionen.

Endast en aktiv MCP-klient kan ansluta till en WinDbg-session i taget. Om en session inte är tillgänglig kopplar du bort den andra AI-klienten från den sessionen och ansluter sedan den avsedda klienten.

Relaterat innehåll

• WinDbg MCP-översikt
• Felsöka problem med konfiguration och anslutning av WinDbg MCP