通过本地 MCP 管理

在 Claude、Codex 等支持 MCP 的 AI 软件中使用 Secure Pipes，查询已保存配置、分析连接活动，并在授权范围内管理连接与设置。

启用并连接

打开 自动化 → 本地 MCP，启用开关，选择客户端格式，将配置复制到 AI 客户端。请使用当前安装生成的配置，不要自行猜测可执行文件或 socket 路径。重启或重新连接客户端，并保持 Secure Pipes 运行且已解锁。未保存过设置时，本地 MCP 默认启用；已有的开关选择保持不变。需要专业版或有效试用。

权限与凭据

未保存过修改权限时，默认需要手动批准；已有权限选择保持不变。根据对客户端的信任，选择不允许、允许（手动批准）或允许（自动同意），设置会记住。手动批准在 Secure Pipes 中确认；自动同意允许支持的操作直接执行。MCP 不读取已保存的密码、私钥路径或其他凭据，也不能写入密码和私钥路径，必须在软件画面中设置。支持的创建接口可以填写用户名和启用认证选项。

查询、诊断与批量创建

可以读取连接、全部映射、代理服务器、规则、场景、应用程序、分组、服务状态、活动代理/共享连接及支持的通用和 DNS 设置。可查询、分析近期内存日志的元数据；分析结果只是诊断线索，不代表已确定根因。允许修改后，可启停连接和分组、切换场景、调整规则及顺序/收藏，管理支持的服务设置和任务计划。实际能力以运行中 App 返回的工具列表和参数定义为准。

支持批量创建代理服务器、SSH 预设主机、本地转发、远程转发、SOCKS 代理、规则和场景，每次最多 128 项。本地/远程转发的每个配置可包含多条映射。创建应用规则前，先读取该应用的全部相关标识符，不要猜测 bundle ID。连接前在画面补齐认证资料。

连接详情与脚本参考

先用 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-Hans"}。有 nextOffset 时继续分页。它提供当前运行版本的 AppleScript/spcli 说明和示例，不执行脚本。可以提问：显示连接及状态；分析近期 DNS 失败；编写启动连接、等待就绪并处理失败的脚本。

故障排查

不可用时检查 App 是否运行、本地 MCP 是否开启、是否已解锁、许可证以及客户端配置中的安装路径。更新 App 后刷新工具或重新连接客户端，替换旧桥接进程和工具缓存。Transport closed 可能需要重启客户端的 MCP 连接；反复重试已关闭的传输不会自动重连。可在日志中查看 MCP 记录，勿公开含私人资料的配置、备注或日志。