Rozwiąż problemy z konfiguracją i połączeniem WinDbg MCP

Użyj tego artykułu, gdy Visual Studio Code z GitHub Copilot lub interfejsem wiersza polecenia GitHub Copilot nie może zarejestrować serwera MCP (WinDbg Model Context Protocol, MCP), nie może nawiązać połączenia z sesją MCP WinDbg lub mechanizmy kontroli zabezpieczeń WinDbg blokują operację. Rejestracja dodaje serwer MCP WinDbg do konfiguracji klienta sztucznej inteligencji, natomiast połączenie wiąże klienta z określoną sesją WinDbg.

Instrukcje instalacji i konfiguracji znajdują się w artykule Instalowanie i włączanie programu WinDbg MCP. Aby uzyskać autorytatywne wskazówki dotyczące zabezpieczeń i prywatności, zobacz WinDbg MCP security and privacy considerations.

Zacznij od obserwowanego objawu, zidentyfikuj prawdopodobną przyczynę i wykonaj kroki rozwiązywania problemu.

Lista kontrolna rozwiązywania problemów

W przypadku problemów z rejestracją serwera MCP:

  1. Otwórz plik WinDbg. Nie musisz ładować ani dołączać do celu debugowania, aby użyć opcji Włącz serwer lub Zainstaluj MCP.
  2. Otwórz ustawienia usługi MCP i upewnij się, że wybrano opcję Włącz serwer.
  3. Potwierdź, że jako klient wybrano Visual Studio Code lub interfejs wiersza polecenia GitHub Copilot.

W przypadku problemów z połączeniem lub sesją:

  1. Uruchom usługę MCP w zamierzonym oknie WinDbg.
  2. Jeśli analizujesz cel, załaduj lub dołącz do celu debugowania zgodnie z potrzebami.

Lista serwerów MCP nie zawiera WinDbg

Lista serwerów MCP obsługiwanego klienta sztucznej inteligencji nie zawiera WinDbg.

Przyczyna

Install MCP nie zarejestrował WinDbg w kliencie lub klient nie załadował ponownie konfiguracji serwera MCP.

Resolution

  1. Uruchom ponownie klienta AI, a następnie sprawdź listę serwerów MCP.
  2. W systemie WinDbg otwórz ustawienia usługi MCP i wybierz odpowiedniego obsługiwanego klienta.
  3. Ponownie wybierz Install MCP.
  4. Ukończ wszelkie potwierdzenia wyświetlane przez klienta.
  5. Uruchom ponownie klienta, a następnie ponownie sprawdź listę serwerów MCP.

Jeśli nadal brakuje WinDbg, ponieważ Install MCP kończy się niepowodzeniem, zarejestruj WinDbg ręcznie.

Ręczne rejestrowanie obsługiwanego klienta

Tego rozwiązania zastępczego należy używać tylko wtedy, gdy Install MCP nie rejestruje WinDbg w Visual Studio Code lub GitHub Copilot CLI.

  1. W systemie WinDbg otwórz ustawienia usługi MCP.
  2. Wybierz opcję Niestandardowy, aby wyświetlić konfigurację serwera proxy. Wybranie pozycji Niestandardowe w tym kroku zapewnia tylko polecenie proxy dla konfiguracji obsługiwanych klientów.
  3. Wybierz pozycję Kopiuj do Schowka i zanotuj command ścieżkę skopiowaną przez WinDbg do schowka.

Skonfiguruj obsługiwany klient:

  1. W obszarze roboczym dodaj serwer WinDbg do .vscode/mcp.json. Zastąp przykładową wartość command ścieżką ze schowka:

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

  2. Uruchom ponownie program Visual Studio Code.

Po ponownym uruchomieniu klienta zobacz Weryfikowanie połączenia MCP WinDbg.

GitHub Copilot nie może odnaleźć zamierzonej sesji WinDbg

Visual Studio Code z GitHub Copilot i GitHub Copilot CLI nie może odnaleźć sesji WinDbg zawierającej zamierzony cel debugowania.

Przyczyna

Usługa MCP nie jest uruchomiona w zamierzonym oknie WinDbg lub jest dostępna więcej niż jedna sesja WinDbg i serwer proxy nie może wybrać sesji automatycznie.

Resolution

  1. W odpowiednim oknie WinDbg wybierz pozycję Usługa MCP.
  2. Poproś klienta sztucznej inteligencji o użycie list_sessions.
  3. Zidentyfikuj identyfikator procesu dla zamierzonej sesji WinDbg.
  4. Poproś klienta sztucznej inteligencji o użycie connect_session z tym identyfikatorem procesu.
  5. Upewnij się, że typ docelowy i stan wykonywania zgłaszane przez klienta są zgodne z tymi w odpowiednim oknie WinDbg.

Aby uzyskać więcej wskazówek dotyczących wyboru sesji, zobacz Zarządzanie sesjami WinDbg.

Sesja WinDbg jest niedostępna, ponieważ inny klient jest połączony

Docelowa sesja WinDbg jest niedostępna, gdy klient sztucznej inteligencji wyświetla sesje lub próbuje nawiązać połączenie.

Przyczyna

Inny klient AI ma aktywne połączenie z sesją WinDbg. Tylko jeden aktywny klient MCP może łączyć się z sesją WinDbg naraz.

Resolution

  1. W połączonym kliencie sztucznej inteligencji poproś klienta o użycie disconnect_session.
  2. Upewnij się, że klient zgłasza, że rozłączył się z sesją windbg.
  3. W docelowym kliencie AI poproś klienta o użycie polecenia list_sessions.
  4. Poproś właściwego klienta, aby użył connect_session z identyfikatorem procesu sesji WinDbg.
  5. Upewnij się, że klient zgłasza połączenie z właściwą sesją.

Odmowa dostępu, gdy program WinDbg jest uruchomiony z podwyższonymi uprawnieniami

Połączenie kończy się niepowodzeniem z komunikatem Odmowa dostępu, gdy program WinDbg jest uruchomiony jako administrator.

Przyczyna

Sesja WinDbg z podwyższonym poziomem uprawnień uniemożliwia obsługiwanemu klientowi sztucznej inteligencji nawiązywanie połączenia za pośrednictwem serwera proxy.

Resolution

  1. Zamknij sesję WinDbg z podwyższonym poziomem uprawnień.
  2. Uruchom WinDbg bez wybrania pozycji Uruchom jako administrator.
  3. Uruchom usługę MCP.
  4. Załaduj lub dołącz do celu debugowania zgodnie z potrzebami.
  5. Otwórz obsługiwanego klienta sztucznej inteligencji i wykonaj kroki opisane w artykule Weryfikowanie połączenia MCP WinDbg.

Ochrona przed wstrzyknięciem promptu blokuje operację

Klient sztucznej inteligencji zgłasza, że ochrona przed prompt injection zablokowała operację lub sklasyfikowała dane wyjściowe debugera jako niebezpieczne.

Przyczyna

Ochrona WinDbg przed atakiem polegającym na wstrzyknięciu między monitami (XPIA) zidentyfikowała dane wyjściowe debugera jako potencjalnie niebezpieczne i zablokowała dane wyjściowe.

Resolution

  1. Postępuj zgodnie z informacjami o błędzie, które zgłasza klient AI.
  2. Przejrzyj odpowiednie dane wyjściowe bezpośrednio w usłudze WinDbg.
  3. Traktuj dane wyjściowe jako niezaufane i nie wysyłaj zablokowanych danych wyjściowych do klienta AI.
  4. Przed podjęciem decyzji o kontynuowaniu zapoznaj się z ochroną przed iniekcją między promptami.

Nie można uruchomić klasyfikacji prompt injection, ponieważ klient sztucznej inteligencji nie obsługuje ani nie zezwala na próbkowanie MCP

Klient sztucznej inteligencji zgłasza, że nie można uruchomić klasyfikacji wstrzyknięcia promptu, a chroniona operacja kończy się niepowodzeniem bez zwracania danych wyjściowych.

Przyczyna

Klient sztucznej inteligencji nie obsługuje próbkowania MCP lub jego konfiguracja albo zasady organizacyjne nie zezwalają na próbkowanie MCP. Ochrona WinDbg XPIA wymaga próbkowania MCP, aby zażądać klasyfikacji od skonfigurowanej usługi modelu klienta.

Resolution

  1. Upewnij się, że klient sztucznej inteligencji obsługuje próbkowanie MCP.
  2. Upewnij się, że konfiguracja klienta i zasady organizacyjne zezwalają na próbkowanie MCP.
  3. Po udostępnieniu próbek ponownie uruchom operację.
  4. Jeśli klasyfikacja nadal nie może zostać uruchomiona, zapoznaj się z artykułem Ochrona przed wstrzyknięciem między monitami i skontaktuj się z administratorem, który zarządza polityką klienta AI.

Sprawdź połączenie MCP WinDbg i zgłoś nierozwiązane problemy

  • Ostatnia aktualizacja o