當 Visual Studio Code 搭配 GitHub Copilot 或 GitHub Copilot CLI 無法註冊 WinDbg 模型情境協定(MCP)伺服器、無法連接 WinDbg MCP 會話,或 WinDbg MCP 的安全控制阻擋操作時,請使用這篇文章。 註冊會將 WinDbg MCP 伺服器加入 AI 用戶端的設定,而連接則將用戶端與特定的 WinDbg 會話關聯起來。
關於設定說明,請參閱 安裝並啟用 WinDbg MCP。 關於權威安全與隱私指引,請參見 WinDbg MCP 的安全與隱私考量。
從你觀察到的症狀開始,找出可能的原因,並完成解決步驟。
故障排除清單
關於 MCP 伺服器註冊問題:
- 開啟 WinDbg。 你不需要載入或附加到除錯目標,就能使用 Enable Server 或 Install MCP。
- 打開 MCP 服務設定,確認你已選擇 啟用伺服器。
- 確認你選擇了 Visual Studio Code 或 GitHub Copilot CLI 作為客戶端。
連線或會話問題:
- 在預期的 WinDbg 視窗中啟動 MCP 服務 。
- 如果你在分析目標,可以根據需要載入或附加到除錯目標上。
MCP 伺服器清單中沒有包含 WinDbg
支援的 AI 客戶端的 MCP 伺服器清單中沒有 WinDbg。
原因
安裝 MCP 沒有在用戶端註冊 WinDBG,或者用戶端沒有重新載入它的 MCP 伺服器設定。
Resolution
- 重新啟動 AI 客戶端,然後檢查它的 MCP 伺服器清單。
- 在 WinDBG 中,打開 MCP 服務設定 並選擇正確的支援用戶端。
- 再次選擇 安裝 MCP 。
- 完成客戶端顯示的任何確認步驟。
- 重新啟動客戶端,然後再檢查一次 MCP 伺服器清單。
如果 WinDbg 因為 安裝 MCP 失敗而仍然缺失,請手動登錄 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 會話
Visual Studio Code 搭配 GitHub Copilot 和 GitHub Copilot CLI 找不到包含預期除錯目標的 WinDbg 會話。
原因
MCP 服務 沒有在預期的 WinDbg 視窗中執行,或者有多個 WinDbg 會話可用,代理無法自動選擇會話。
Resolution
- 在指定的 WinDbg 視窗中,選擇 MCP 服務。
- 要求 AI 客戶端使用
list_sessions。 - 找出預期 WinDbg 工作階段的處理程序識別碼。
- 請 AI 用戶端使用
connect_session搭配該處理序 ID。 - 確認客戶端回報的目標類型和執行狀態,是否與預期的 WinDbg 視窗中顯示的一致。
如需更多工作階段選擇指引,請參見「管理 WinDbg 工作階段」。
因為另一個用戶端已連線,所以 WinDbg 工作階段無法使用
當 AI 用戶端列出會話或嘗試連線時,預期的 WinDbg 會話似乎無法使用。
原因
另一個 AI 用戶端與 WinDbg 會話有活躍連線。 同一時間只能有一個作用中的 MCP 用戶端連線到一個 WinDbg 工作階段。
Resolution
- 在已連線的 AI 用戶端中,請用戶端使用
disconnect_session。 - 確認客戶端回報其已與 WinDbg 工作階段中斷連線。
- 在預期的 AI 用戶端中,請用戶端使用
list_sessions。 - 請要求目標用戶端使用
connect_session搭配 WinDbg 工作階段的處理程序 ID。 - 確認用戶端回報已連線到預期的工作階段。
當 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 意見反應存放庫回報。