MCP 接入

MCP 是让支持 MCP 的 AI 直接调用 VideoFree 生成、查询和管理项目的连接方式。它随网关一起启动，不需要另外运行 MCP 服务。

connection path

AI 客户端支持 MCP

→JSON-RPC

/mcp随网关启动

→

VideoFree 网关能力 · 项目 · 任务

→

ComfyUI插件工作流

插件注册后自动出现在 list_capabilities，MCP 侧不需要任何额外配置

1确认网关地址

先启动 VideoFree。默认端口是 8765，MCP 地址固定为 /mcp。

同一台电脑：使用 http://127.0.0.1:8765/mcp。
局域网其他电脑：把 127.0.0.1 换成运行网关电脑的实际局域网 IP，例如 http://192.168.50.8:8765/mcp。不要填写 0.0.0.0，也不要把地址改成 /sse。

在 AI 客户端的 MCP 服务配置中新增一个服务，名称填 videofree，然后粘贴下面的 JSON。不同客户端可能要求把 type 改成 streamable-http，以客户端文档为准。

{
  "mcpServers": {
    "videofree": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

从另一台电脑连接时，只需要把 JSON 中的地址替换成网关电脑 IP：

{
  "mcpServers": {
    "videofree": {
      "type": "http",
      "url": "http://192.168.50.8:8765/mcp"
    }
  }
}

默认令牌为空，不需要认证请求头。如果你在工作台设置中配置了网关访问令牌，在服务配置中加入 headers，并把示例值替换为真实令牌：

{ "mcpServers": { "videofree": { "type": "http", "url": "http://127.0.0.1:8765/mcp", "headers": { "X-API-Token": "你的令牌" } } } }

不要把令牌写进公开提示词、截图或代码仓库。HTTP API 和 MCP 共用工作台中的同一个令牌。

保存配置后刷新 AI 客户端的 MCP 工具列表。先让 AI 调用 get_health、list_capabilities 和 list_voices，能正常返回结果才表示连接完成。

客户端必须支持 HTTP POST 的 JSON 响应。旧版只支持 SSE 的客户端不能直接使用这个地址；不要把 MCP 地址改成 /sse。

如果局域网连接失败，检查网关监听地址、防火墙和令牌是否一致。网关在线不代表 ComfyUI 已连接，生成失败时再检查工作台里的 ComfyUI 地址。

完整 MCP 有三十多个工具，覆盖全部工作台能力。跑全自动流水线时，可以基于 HTTP API 封装只包含所需几个工具的窄 MCP，见窄 MCP 封装。