Cursor 接入 ChatCut 教程:mcp.json 配置详解

Cursor 接入 ChatCut 只需要在 mcp.json 里加一段配置:全局配置写在 ~/.cursor/mcp.json,项目级写在项目根目录的 .cursor/mcp.json,类型为 http,地址填 ChatCut 的 MCP 端点。 保存后在 Cursor 设置里看到绿色状态点即接入成功,之后就能用自然语言指挥 Cursor 剪辑你的视频工程。

前置准备

• 启动 ChatCut Online(下载桌面端),MCP 服务随应用自动启动。
• Cursor 建议使用较新版本(对 Streamable HTTP MCP 支持更完善)。
• 确认端点地址:默认 http://localhost:5199/api/external-mcp/mcp,端口被占用时以 ChatCut「设置 → MCP」页面为准。

全局配置(推荐)

编辑 ~/.cursor/mcp.json(Windows 为 %USERPROFILE%\.cursor\mcp.json),加入:

{
  "mcpServers": {
    "openchatcut": {
      "type": "http",
      "url": "http://localhost:5199/api/external-mcp/mcp"
    }
  }
}

全局配置对所有 Cursor 项目生效。如果只想在某个项目里使用,把同样的内容写进该项目根目录的 .cursor/mcp.json 即可,项目级配置优先级更高。

验证连接

打开 Cursor 设置,进入 MCP 面板:

1. openchatcut 应显示为已启用,状态点为绿色。
2. 点开可看到工具列表,包括 openchatcut_status、list_projects、create_project、begin_edit_session 等。
3. 在对话框里让 Cursor「列出我的 ChatCut 工程」,能返回工程列表即链路畅通。

如果状态是红色,先确认 ChatCut 正在运行,再核对端点地址是否与应用内「设置 → MCP」显示的一致。

接入后能做什么

Cursor 接入后与 ChatCut 内置 AI 共用同一套剪辑工具,典型用法:

• 批量处理课程录像:「把这批课时视频逐个剪掉停顿、加逐字字幕,导出 1080p。」
• 播客精剪:「删掉语气词和长停顿,说话人分开标注,生成shownotes时间戳。」
• 短视频流水线:「按这个脚本生成字幕和标题动效,配轻背景音乐,导出竖版 9:16。」

所有修改通过编辑会话提交,默认需要你在 ChatCut 窗口里审核确认才会应用,工程安全有保障。

常见问题

改了 mcp.json 没生效? 检查 JSON 语法(逗号、引号),然后在 Cursor 设置的 MCP 面板里点刷新或重启 Cursor。

能不能只读不写? 可以。不给 AI 发起编辑会话的指令,仅用 list_projects、openchatcut_status 等只读工具,适合做工程盘点和转录内容检索。

团队共用一台剪辑机? 在该机器上配置 OPENCHATCUT_MCP_TOKEN,团队成员的 mcp.json 里通过请求头携带令牌;令牌不要提交进项目仓库,建议用 Cursor 的私密环境变量管理。

总结

一段 JSON,Cursor 就能直接操作你的视频工程。现在下载 ChatCut 完成首次接入,更多工具配置见 AI 助手插件 页面,或继续读 Trae 接入教程、Claude Desktop 接入教程。