安装并准备机器
桌面应用负责运维控制层，但它要启动的本地 MCP Runtime 仍需预先安装在机器上。
安装 Tunnel Manager公开稳定版发布后，请使用已签名的 Windows Installer。Landing Page 与 Release Endpoint 会显示同一套版本信息。
准备 MCP Runtime安装目标 MCP Server 所需的 Runtime。对于 Serena 项目，请确保 Tunnel Manager 使用的环境能够找到 Serena 命令。
让项目留在本地你的源项目始终保留在本机，Tunnel Manager 只负责协调本地 MCP Process 与 Secure Tunnel 连接。
创建配置
配置是一个 MCP Workspace 可复用的连接定义。建议每组 Project/Runtime 使用独立配置，以保持验证和 Runtime 状态清晰。
推荐配置字段
项目目录MCP Server 实际操作的本地 Workspace。
MCP Target 命令Tunnel Manager 要启动的命令，例如选定项目的 Serena MCP Server。
Tunnel Identity 与 Runtime Key使用 OpenAI Secure Tunnel 工作流签发的值，敏感信息只应保存在本地控制层。
启动前验证
验证应作为必需的预检步骤。只有配置、Credential、Tunnel Identity、MCP Target 和本地 Runtime 全部通过后，Start 才应可用。
连接 ChatGPT
验证通过后启动配置。Tunnel Manager 会启动已配置的本地 MCP Process、建立 Secure Tunnel，并在桌面 UI 中显示连接状态。
启动已验证配置等待 MCP Runtime 与 Tunnel 都显示健康运行状态。
打开 ChatGPT Connector 设置选择或重新连接与 Tunnel 关联的 MCP Connector。
观察 AI 活动当 ChatGPT 调用本地 MCP Tool 时，Tunnel Manager 应从 Connected/Standby 切换到 AI Active，并流式显示对应 Runtime 日志。
Serena 项目设置
对于 Serena 项目，请将项目级行为保存在项目的 .serena 目录中，并将机器专用 Override 保存在 project.local.yml.
Trusted Project 要求
Serena 只会运行项目的 activation_command 前提是 Project Path 已被 Serena Global Configuration 信任。建议只信任明确的 Project Path 或有限的开发目录，而不是使用全局规则 ** rule.
故障排除
先查看可见的验证状态，再检查流式日志。问题通常只出现在链路中的某一层。
添加新 Key 前，先确认 Profile 已加载现有保存的 Key。任何 Credential 修改后都要重新验证。
确认 Tunnel 属于目标 Environment，并确保 Profile 没有重复使用过期 Identifier。
确认 Project Folder 存在于实际运行 MCP Runtime 的机器上。远程 Linux Workspace 必须使用该 Linux Host 上有效的路径。
在同一 User Environment 中手动运行配置的 MCP Target。修复 PATH/Runtime 安装后再重试 Tunnel Manager。
将准确的 Project Path 添加到 Serena Global trusted_project_path_patterns，然后重启 Serena/Tunnel Process 以加载新的 Global Configuration。
先确认现有 Process。避免重复启动 Server；可复用健康 Process，或停止失效 Process 后重启 Profile。
检查本地网络可达性、Profile Credential 和 Tunnel 状态。若启用 Auto Recovery，请在 Live Log 中确认重连是否正在进行。
检查当前状态。当 Process 正在启动或运行时，Start 应禁用；在不兼容的状态转换期间，Validate 也可能不可用。