OPENChat Cut
返回博客

用 MCP 把 Codex / Claude 接到 OpenChatCut

如何通过本地 Streamable HTTP MCP 端点，让外部 Agent 读写 OpenChatCut 工程、操作时间线并保持可撤销。

2026年7月21日OpenChatCutOpenChatCut
用 MCP 把 Codex / Claude 接到 OpenChatCut

OpenChatCut 不只内置聊天 Agent。它还通过 Model Context Protocol (MCP) 暴露工程能力，让 Codex、Claude Code 或其他兼容客户端直接操作同一个多轨工程。

为什么需要 MCP

聊天面板适合快速迭代。MCP 适合：

  • 在你已经熟悉的 Agent CLI / IDE 里剪片
  • 把剪辑步骤写进可重复的脚本或会话
  • 让多种 Agent 共用同一套工程模型，而不是各自对接私有 API

Agent 读写的是结构化工程对象（素材、轨道、选区、字幕），不是屏幕坐标。

本地端点

开发服务与桌面内嵌服务默认提供 Streamable HTTP MCP：

http://localhost:5199/api/external-mcp/mcp

请先启动 OpenChatCut（源码 npm run dev 或桌面应用），确认本机端口可访问。鉴权与工程生命周期以当前版本服务端实现为准，密钥只应出现在服务侧。

推荐工作流

  1. 打开或创建工程，导入素材。
  2. 在 Agent 客户端中配置上述 MCP 服务器。
  3. 先让 Agent 读取工程状态：轨道、片段、文字稿、当前选区。
  4. 给出明确目标，例如：「删掉超过 0.5 秒的停顿，加中文字幕，BGM 在人声时自动闪避。」
  5. 在编辑器里预览，必要时撤销或继续对话微调。

与内置 Agent 的关系

  • 入口：内置 Agent 在应用内聊天；外部 MCP Agent 在 Codex / Claude Code 等客户端。
  • 改状态路径：两者都走同一套 Editor 命令。
  • 密钥：内置走本机应用配置；外部客户端各自配置密钥。
  • 适合场景：内置适合边预览边说；MCP 适合 IDE / CLI 深度工作流。

两者都不应绕过编辑器命令边界；这样才能保证校验、提案与撤销一致。

常见问题

端口不是 5199？
以你实际启动的开发/桌面服务为准，检查终端日志或应用设置。

工具列表为空？
确认 MCP 路由已启用、工程已打开，且客户端使用 Streamable HTTP 而非过时的 transport。

能不能远程连？
默认面向本机。远程暴露需要你自己处理网络隔离与鉴权，不建议把未加固的 MCP 端口直接暴露到公网。

下一步