
封面为 AI 生成的能力示意图非产品界面截图。本文记录一个 Windows 本地 MCP 的可重复上手流程安装 Termexo v0.10.10启用服务启动新的 Agent先查询工作区再决定是否读取终端和创建任务。遇到“发现了工具但任务没有继续”的情况也需要区分配置成功、输入成功和任务完成。我是 Termexo 的维护者。这个 Windows 开源工作台已经可以把 Claude Code、Codex、OpenCode、Grok Build 和 Antigravity 放在同一个项目视图里。v0.10.10 往前走了一步把工作台的终端、任务和部分设置开放为本地 MCP 工具让已经启动的 Agent 也能按授权范围操作这些资源。下面用一个具体流程说明它怎样使用以及哪些事情仍需要自己确认。从“看见多个终端”到“让 Agent 查询工作现场”例如你把一个项目交给 Codex另一个终端正在运行测试。希望它先看看测试输出再帮你整理待办过去往往需要自己复制终端内容、说明当前目录并手动创建任务。接入工作台 MCP 后可以让 Agent 先查询实际工作区与终端 ID再读取指定终端的输出最后在对应项目中创建一条包含目标与验收标准的任务。终端和任务仍然出现在原来的工作台中你可以检查它到底读了什么、创建了什么。这里要先划清操作范围。读取一个终端、创建一条待办和关闭正在运行的进程影响并不相同。第一条指令可以只做查询确认接入正确再安排明确的写入操作。图为 v0.10.6 真实桌面录屏的封面用于说明并排终端的工作方式v0.10.10 的 MCP 入口见下文步骤。19 个工具围绕三类日常操作工具列表并不要求使用者全部记住。先看自己这次需要哪类能力范围可以做什么初次体验可以怎么用工作区与终端查询工作区创建或关闭终端读取输出发送文字或控制按键先列出终端再读取自己指定的测试终端任务查询、创建、编辑、执行、停止、继续、完成和验收创建草稿任务核对项目、Agent 和验收标准设置读取不含凭据的配置修改语言、终端偏好及已有模型或网络配置先查询配置名称需要修改时再开启设置权限任务执行目前支持 Claude Code、Codex、OpenCode 和 Grok Build。Antigravity 可在终端中自动接入 MCP任务看板暂不支持由它执行任务。更重要的是结果的含义terminal_write返回成功只表示输入已写入终端task_execute返回成功表示启动流程已经建立任务与终端的绑定。下一步仍要读取终端、查询任务状态并检查实际产物。任务的完成标记也不能代替代码验收。开启一次新启动的五种 Agent 自动接入不需要为每个 Termexo 终端复制一份令牌。上手流程是1. 下载并安装 Termexo v0.10.10 的 Windows EXE 或 MSI为本机项目目录创建工作区。2. 在桌面设置 → AI 操控MCP中开启本地服务选择访问范围并点击“应用”。默认允许终端和任务访问设置访问单独开启。3. 保留默认勾选的“自动连接 Termexo 启动的 Agent”确认服务显示“运行中”然后启动一个新的 Agent 终端。4. 在终端里先发送下面这条只读指令。调用 termexo-desktop 的 workspace_list列出工作区。 先不要创建任务、发送终端输入或修改设置。检查终端中是否出现真实工具调用和返回结果。已经运行的 Agent 需要重新启动连接期间Termexo 桌面窗口需要保持打开。Claude 的 attach 会话连接的是已有进程也要由原进程重新启动才能载入新 MCP。默认服务地址为http://127.0.0.1:7421/mcp。Termexo 外启动的 AI 客户端也可以使用设置面板生成的 JSON 或 TOML但客户端需要支持 Streamable HTTP并正确配置 Bearer 令牌。这是根据已实现连接路径绘制的技术示意图不是软件截图。自动接入怎样保留原来的配置做自动接入时一个需要处理的问题是用户往往已经配好了其他 MCP 服务新的连接应该可以追加也应该可以撤回。Claude Code、Codex 和 OpenCode 通过本次启动配置接入保留已有 Profile 或其他服务。OpenCode V1 与 V2 的结构不同需要分别生成mcp和mcp.servers配置。Grok Build 和 Antigravity 采用用户级配置。同一份配置下在 Termexo 外启动的客户端也可能看到termexo-desktop条目关闭服务或自动连接并应用后Termexo 移除自己添加的内容保留其他配置。遇到用户已经创建的同名服务或原配置无法解析会提示错误。自动连接使用 Termexo 自带的 stdio 桥接程序。它在每次请求时读取当前端口及系统凭据启动命令和生成的 Agent 配置不包含令牌。服务默认关闭只监听本机回环地址终端、任务和设置权限分别控制Agent 自身的工具审批也继续生效。真实验证到了哪一步本次发布用官方 MCP SDK 验证正式版 Windows 程序stdio 握手成功、发现 19 个工具并查询到独立测试桌面的工作区。自动接入的 Codex 任务终端实际调用了termexo-desktop.workspace_list并返回测试工作区。其他客户端的检查范围也有区别Grok 完成握手和工具发现OpenCode 2.0.15 的隔离服务确认连接Antigravity 确认条目被识别为启用Claude 的配置合并由 Rust 测试覆盖。五种客户端的自动接入均已实现模型实际调用的验证范围以这些记录为准。Codex 的那次任务测试通过terminal_write补发了回车任务提示词的全程自动提交仍需进一步验证。完整过程和限制已放在 MCP 真实联调记录 中。适合从一项小操作开始如果已经在 Windows 上并行使用几个编程 Agent可以先试三个动作查询工作区、读取自己指定的终端、创建一条草稿任务。确认目录、权限和返回结果后再把它纳入自己的开发流程。多个 Agent 修改同一个目录时仍会相互影响。需要隔离文件改动可以使用不同目录或 Git worktreeMCP 接入本身不负责解决并行修改冲突。Termexo 采用 MIT 许可证桌面版面向 Windows x64。运行 Agent 仍需相应 CLI、账号或模型服务项目不包含模型订阅。v0.10.10 的 EXE 和 MSI 安装包已在 GitHub 发布。- 下载安装包与更新说明- 在线使用说明与 PDF- 项目源码欢迎反馈管理多个 Agent 时最常需要手动处理的操作。本文为项目维护者发布AI 辅助整理概念封面、技术示意图与真实界面图分别标明来源。