透過本機 MCP 管理

在 Claude、Codex 等支援 MCP 的 AI 軟體中使用 Secure Pipes，查詢已儲存的設定、分析連線活動，並在授權範圍內管理連線與設定。

啟用與連線

開啟自動化 → 本機 MCP，啟用開關，選擇用戶端格式並複製設定。請使用此安裝產生的設定，不要猜測執行檔或 socket 路徑。重新啟動或連接 AI 用戶端，保持 Secure Pipes 執行且已解鎖。尚未儲存設定時，本機 MCP 預設啟用；既有的開關選擇保持不變。需要專業版或有效試用。

權限與憑證資料

尚未儲存修改權限時，預設需要手動核准；既有權限選擇保持不變。可選不允許、允許（手動核准）或允許（自動同意），並記住選擇。手動核准須在 App 確認，自動同意則可直接執行支援的修改。MCP 不讀取已存密碼、私鑰路徑或其他憑證資料，也不能寫入密碼或私鑰路徑，須在畫面設定。支援的建立工具可指定使用者名稱及啟用驗證。

查詢、診斷與批次建立

可查詢連線、完整映射、代理伺服器、規則、情境、應用程式、群組、服務狀態、代理與共享活動及支援的一般/DNS 設定。日誌工具分析近期記憶體日誌中繼資料，僅提供診斷線索。允許修改後可啟停連線與群組、切換情境、調整順序/收藏、管理支援的服務與任務計畫。以執行中 App 的工具清單及參數為準。

可批次建立代理伺服器、SSH 預設主機、本機/遠端轉送、SOCKS、規則與情境，每次最多 128 項；轉送設定可包含多個映射。建立應用程式規則前先讀取所有相關識別碼，不要猜測 bundle ID。認證資料須在 App 補齊。

連線詳細資料與指令碼參考

先用 list_connections 取得 UUID，再呼叫 get_connection_detail：{"id":"CONNECTION-UUID"}。mappingCount 與完整有序 mappings 包含停用項目，區分 local_forward、remote_forward、socks、reverse_socks，列出監聽/目標端、位址、連接埠及啟用狀態；SOCKS 目標為動態。詳細資料也會返回備註、自訂 SSH 文字及映射備註，請勿填入秘密。已存憑證欄位仍排除。

以 get_automation_reference 查詢章節索引，再按章節或命令搜尋，例如 {"interface":"spcli","query":"open-remote-desktop","language":"zh-Hant"}。依 nextOffset 繼續分頁。此工具提供執行版本的說明與範例，不執行指令碼。可詢問連線狀態、DNS 失敗原因，或要求編寫啟動連線、等待就緒並處理失敗的指令碼。

疑難排解

無法使用時檢查 App、MCP 開關、解鎖、授權及用戶端安裝路徑。更新後重新連接或重新整理工具，以替換舊橋接程序與快取。Transport closed 可能需要重新啟動 MCP 連線，反覆重試已關閉的傳輸不會重連。查看 MCP 日誌，勿公開私人設定、備註或日誌。