この記事は、Visual Studio Code GitHub Copilotまたは GitHub Copilot CLI で WinDbg モデル コンテキスト プロトコル (MCP) サーバーを登録できない、WinDbg MCP セッションに接続できない、または WinDbg MCP セキュリティ コントロールが操作をブロックする場合に使用します。 登録すると、WinDbg MCP サーバーが AI クライアントの構成に追加され、一方、接続するとクライアントを特定の WinDbg セッションに関連付けます。
セットアップ手順については、「 WinDbg MCP のインストールと有効化」を参照してください。 公式のセキュリティとプライバシーのガイダンスについては、WinDbg MCP のセキュリティとプライバシーに関する考慮事項を参照してください。
観察した症状から始めて、考えられる原因を特定し、解決手順を完了してください。
トラブルシューティング チェックリスト
MCP サーバーの登録に関する問題の場合:
- WinDbg を開きます。 サーバーの有効化または MCP のインストールを使用するために、デバッグ ターゲットを読み込んだりアタッチしたりする必要はありません。
- MCP サービス設定を開き、[サーバーの有効化] を選択したことを確認します。
- クライアントとして Visual Studio Code または GitHub Copilot CLI を選択したことを確認します。
接続またはセッションの問題の場合:
- 目的の WinDbg ウィンドウで MCP サービス を開始します。
- ターゲットを分析する場合は、必要に応じてデバッグ ターゲットを読み込むか、アタッチします。
MCP サーバーの一覧に WinDbg が含まれていない
サポートされている AI クライアントの MCP サーバーの一覧には、WinDbg は含まれません。
原因
Install MCP で WinDbg がクライアントに登録されなかったか、クライアントが MCP サーバー構成を再読み込みしていません。
Resolution
- AI クライアントを再起動し、MCP サーバーの一覧を確認してください。
- WinDbg で 、MCP サービス設定 を開き、サポートされている適切なクライアントを選択します。
- [MCP のインストール] をもう一度選択します。
- クライアントが表示する確認があればそれを完了します。
- クライアントを再起動して、その MCP サーバー リストをもう一度確認します。
[MCP のインストール] が失敗したことで WinDbg が見つからない場合は、WinDbg を手動で登録します。
サポートされているクライアントを手動で登録する
このフォールバックは、[MCP のインストール] で WinDbg が Visual Studio Code または GitHub Copilot CLI に登録されない場合にのみ使用します。
- WinDbg で、 MCP サービス設定を開きます。
- [カスタム] を選択してプロキシ構成を表示します。 この手順で [カスタム] を選択すると、サポートされているクライアント構成のプロキシ コマンドのみが提供されます。
-
クリップボードにコピー を選択し、WinDbg がクリップボードにコピーする
commandパスを書き留めます。
サポートされているクライアントを構成します。
ワークスペースで、WinDbg サーバーを
.vscode/mcp.jsonに追加してください。commandの例の値をクリップボードから取得したパスに置き換えます。{ "servers": { "WinDbg": { "type": "stdio", "command": "C:\\path\\to\\DbgX.Mcp.Proxy.exe", "args": [] } } }Visual Studio Code を再起動します。
クライアントの再起動後、 WinDbg MCP 接続の確認を参照してください。
GitHub Copilot は目的の WinDbg セッションを見つけられません
GitHub CopilotとGitHub Copilot CLI を使用したVisual Studio Codeは、目的のデバッグ ターゲットを含む WinDbg セッションを見つけることができません。
原因
MCP サービス が目的の WinDbg ウィンドウで実行されていないか、複数の WinDbg セッションが使用可能であり、プロキシはセッションを自動的に選択できません。
Resolution
- 目的の WinDbg ウィンドウで、 MCP サービスを選択します。
- を使用するように AI クライアントに依頼します。
- 目的の WinDbg セッションのプロセス ID を識別します。
- そのプロセス ID で
connect_sessionを使用するように AI クライアントに依頼します。 - クライアントが報告するターゲットの種類と実行状態が、目的の WinDbg ウィンドウのものと一致することを確認します。
セッション選択のガイダンスの詳細については、「 WinDbg セッションの管理」を参照してください。
別のクライアントが接続されているため、WinDbg セッションは使用できません
AI クライアントがセッションを一覧表示するか、接続しようとすると、目的の WinDbg セッションが使用できないようです。
原因
別の AI クライアントが WinDbg セッションへのアクティブな接続を持っています。 一度に 1 つの WinDbg セッションに接続できるアクティブな MCP クライアントは 1 つだけです。
Resolution
- 接続されている AI クライアントで、
disconnect_sessionを使用するようにクライアントに依頼します。 - クライアントが WinDbg セッションから切断したと報告していることを確認します。
- 目的の AI クライアントで、
list_sessionsを使用するようにクライアントに依頼します。 - 目的のクライアントに、WinDbg セッションのプロセス ID を持つ
connect_sessionを使用するよう依頼します。 - クライアントが目的のセッションへの接続を報告することを確認します。
WinDbg を管理者として実行した場合にアクセスが拒否される
WinDbg が管理者として実行されているときに、アクセスが拒否されました というメッセージが表示されて接続に失敗します。
原因
管理者特権の WinDbg セッションでは、サポートされている AI クライアントがプロキシ経由で接続できなくなります。
Resolution
- 管理者特権の WinDbg セッションを閉じます。
- [管理者として実行] を選択せずに WinDbg を起動します。
- MCP サービスを開始します。
- 必要に応じて、デバッグ ターゲットを読み込むか、デバッグ ターゲットにアタッチします。
- サポートされている AI クライアントを開き、WinDbg MCP 接続の確認の手順を完了します。
プロンプトインジェクション保護によって操作がブロックされる
AI クライアントは、プロンプトインジェクション保護が操作をブロックした、またはデバッガー出力を安全でないと分類したと報告しています。
原因
WinDbg クロスプロンプトインジェクション攻撃 (XPIA) 保護により、デバッガーの出力が安全でない可能性があると識別され、出力がブロックされました。
Resolution
- AI クライアントが報告するエラー情報を参照してください。
- WinDbg で関連する出力を直接確認します。
- 出力を信頼できないものとして扱い、ブロックされた出力を AI クライアントに送信しないでください。
- 続行する方法を決定する前に 、クロスプロンプトインジェクション保護 を確認してください。
AI クライアントが MCP サンプリングをサポートまたは許可していないため、プロンプトインジェクション分類を実行できません
AI クライアントは、プロンプトインジェクション分類を実行できないことを報告し、保護された操作は出力を返さずに失敗します。
原因
AI クライアントでは MCP サンプリングがサポートされていないか、構成または組織のポリシーで MCP サンプリングが許可されていません。 WinDbg XPIA 保護では、クライアントの構成済みモデル サービスから分類を要求するために MCP サンプリングが必要です。
Resolution
- AI クライアントが MCP サンプリングをサポートしていることを確認します。
- クライアント構成と組織ポリシーで MCP サンプリングが許可されていることを確認します。
- サンプリングが使用可能になったら、操作をもう一度実行します。
- 分類を実行できない場合は、 クロスプロンプトインジェクション保護 を確認し、AI クライアントのポリシーを管理する管理者に問い合わせてください。
WinDbg MCP 接続を確認し、未解決の問題を報告する
- WinDbg MCP 接続を確認します。
- WinDbg MCP のセキュリティとプライバシーに関する考慮事項を確認してください。
- 問題が解決しない場合は、[WinDbg フィードバック リポジトリ] で報告してください。