OpenChatCut接入Codex与Claude Code外部AI Agent通过MCP剪辑视频工程完整教程【免费下载链接】OpenChatCutOpen-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.项目地址: https://gitcode.com/gh_mirrors/op/OpenChatCutOpenChatCut是一款开源、本地优先local-first的对话式 AI 视频编辑器内置专业多轨时间线、Agent Skills 与 MCP 集成并基于 Remotion 渲染导出。本教程完整讲解如何将Codex 与 Claude Code这两个外部 AI Agent 通过MCPModel Context Protocol接入 OpenChatCut让 AI 直接读取、剪辑并导出可继续编辑的真实视频工程——而不是一段不可修改的生成视频。为什么需要 MCP一套工具面两种 Agent传统做法是AI 生成视频 → 下载 → 手动重剪。OpenChatCut 的路径完全不同内置 Agent与外部 MCP AgentCodex、Claude Code、Cursor 等共用同一套编辑工具和EditorCore命令每次修改都落到真实工程的轨道、片段、转场、字幕和特效上可预览、可撤销、可继续手动调整外部 Agent 的修改先进入隔离草稿不会污染正式时间线。一句话Codex 或 Claude Code 不是替你生成视频而是替你操作剪辑软件。编辑器内打开外部 Agent 接入 (MCP)对话框可以看到统一端点和各客户端的一键连接入口准备工作启动 OpenChatCut 并获取 MCP 端点1. 安装并启动三种方式任选其一方式操作桌面安装包下载 macOS / Windows / Linux 构建并安装源码运行git clone https://gitcode.com/gh_mirrors/op/OpenChatCut→npm install→npm run dev继续开发桌面端用npm run desktop:dev源码运行需要 Node.js 24.x。启动后通过http://localhost:5199访问必须是本机回环地址否则浏览器会禁用 WebCrypto 等能力。2. 拿到端点与令牌OpenChatCut 暴露的 Streamable HTTP MCP 端点默认是http://localhost:5199/api/external-mcp/mcp令牌Bearer Token只在编辑器设置 → MCP页面展示即使本机连接也强制要求令牌服务重启后令牌会变化需要重新复制配置。工程列表界面就是外部 Agent 将要读取的目标工程池Codex / Claude Code 连接的正是这些数据接入 Codex两步完成连接在 Codex 的配置中加入 MCP 服务~/.codex/config.toml[mcp_servers.openchatcut] url http://localhost:5199/api/external-mcp/mcp或直接用 CLI 注册令牌建议放环境变量避免写入仓库或聊天历史export OPENCHATCUT_MCP_TOKEN从 设置 → MCP 复制的令牌 codex mcp add openchatcut \ --url http://localhost:5199/api/external-mcp/mcp \ --bearer-token-env-var OPENCHATCUT_MCP_TOKEN接入 Claude Code一条命令claude mcp add --transport http \ -H Authorization: Bearer 令牌 \ openchatcut http://localhost:5199/api/external-mcp/mcp如果你使用其他 MCP 客户端Qoder、Cursor、千问办公等把端点注册为 Streamable HTTP 服务、Authorization头设为Bearer 令牌即可。推荐安装官方 Agent Skill让 Agent 自动完成上面的注册、并学会正确的工作流npx skills add 0xsline/OpenChatCut安装后对 Agent 说设置 OpenChatCut即可。该 Skill 是一个单入口路由技能按需在编辑器内加载 26 个专项技能时间线、文字稿、字幕、音频、色彩、导出等避免技能列表爆炸。技能定义可查看 SKILL.md连接排障指南见 getting-started.md编辑工作流见 editing-workflow.md。核心工作流编辑会话四步法无论 Codex 还是 Claude Code剪辑工程都走同一套会话流程源码见 server/external-agent/begin_edit_session— 创建编辑会话保存返回的editSessionId选择approvalModemanual默认修改进入草稿由你在 OpenChatCut 界面内逐条审阅、预览、勾选应用或拒绝auto无人值守模式review_edit_session直接应用完整草稿。传入editSessionId执行读取/编辑— 会话中每个工程工具都带上该 id所有修改只写入隔离草稿。review_edit_session— 草稿完成提交审阅。get_edit_session— 轮询状态得到applied/rejected/discardedmanual会话需你在编辑器内点应用后才算生效。两个值得注意的安全设计会话只暴露可安全进入草稿的工程读取/编辑工具生成、导出、删除工程这类有即时副作用的工具不在会话内开放拒绝了也回滚不了两种模式下应用的操作都会原子提交为一个撤销节点——一次CtrlZ就能撤销 Agent 的全部修改。接入成功后Codex / Claude Code 操作工程的效果就像你在编辑器里让内置 Agent 干活一样素材、转场、字幕、BGM 全部落到多轨时间线上随时可以继续手动精修实战示例对 Agent 说人话就够了连接完成后直接描述编辑任务即可例如启动一个 OpenChatCut 编辑会话读取草稿在第二条音频轨的 8 秒处添加划盘音效 并给相邻视频添加故障转场。提交草稿供审阅等待我在 OpenChatCut 内应用后 再报告修改已经生效。Agent 会自动openchatcut_status探活 →list_projects定位工程 →target_project锁定 →begin_edit_session开会话 → 调用时间线工具写入草稿 →review_edit_session提交。常见问题速查症状处理连接报错 / 端点不通先确认 OpenChatCut 已启动并打开目标工程端口被占用时页面会显示备用端口服务重启后令牌失效回设置 → MCP复制新令牌重新注册客户端auto会话过期会直接报错而不降级为人工审批丢弃后重新创建会话只列出了工程、没有编辑器工程发现正常用get_editor_url返回的地址打开对应工程即可工具列表过大影响 Prompt使用?toolExposureprogressive渐进式暴露见 mcp-tool-exposure.ts更完整的错误恢复策略见 known-errors.md。小结用三条命令概括全文启动 OpenChatCut → 复制 MCP 端点与令牌 → 在 Codex / Claude Code 中注册。之后外部 AI Agent 就能和你共用同一个视频工程它负责粗剪、转场、字幕与配乐你负责审阅、精修与导出 MP4 / 字幕 / FCPXML。这就是 OpenChatCut Agent-native local-first 的核心体验——AI 参与剪辑但控制权始终在你手里。【免费下载链接】OpenChatCutOpen-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.项目地址: https://gitcode.com/gh_mirrors/op/OpenChatCut创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考