从 Codex、Claude、OpenClaw、DeepSeek、Hermes 和 Cursor 驱动 KwaFlux
KwaFlux 自带本地 MCP 服务。保持应用打开,接上 Codex、Claude、OpenClaw、DeepSeek、Hermes 或 Cursor。转换、修复、增强和下载需要登录和付费方案。
这是什么
可以,AI 助手能驱动 KwaFlux:桌面应用自带本地 MCP 服务,Codex、Claude、OpenClaw、DeepSeek(DSH)、Hermes 和 Cursor 都能连上。打开 设置 › 高级 / 诊断 › Agent(MCP),把配置复制到你的聊天应用里,并保持 KwaFlux 运行。连接走这台电脑上的本地 stdio,不需要 OAuth。

各宿主把配置放在哪里
| 宿主 | 放在哪里 |
|---|---|
| Codex | 追加到 ~/.codex/config.toml。键名是 mcp_servers。重启 Codex,或运行 /mcp。 |
| Claude Code | 项目里的 .mcp.json,或安装命令。改完后开一个新会话。 |
| Claude Desktop | 合并进 claude_desktop_config.json,然后把整个应用关掉,不要只关窗口。Windows 上该文件在 %APPDATA%\Claude\。 |
| OpenClaw | 合并进 ~/.openclaw/openclaw.json 的 mcp.servers,或运行 openclaw mcp set。 |
| DeepSeek 应用 | 一份 DSH 配置 YAML。改完后重启 DSH 会话。 |
| Hermes | 运行 hermes mcp add,或写入 config.yaml 的 mcp_servers(原生 Windows 版在 %LOCALAPPDATA%\hermes,其他系统在 ~/.hermes)。 |
| Cursor | 用应用内的安装,然后在 Cursor 里 Reload MCP。 |
助手能做什么
它能看应用是否在运行、是否已登录,列出任务,并等待某个任务结束。它也能暂停、继续、取消或重试自己发起的任务。修复之前可以先诊断损坏的文件。
- 转换:按画质档位导出 64 种格式,有 YouTube、TikTok 等平台预设,也能把一段时间做成 GIF。文件保存在输入文件旁边。
- 修复:可以先做诊断。
- 增强:画质修复、色彩、防抖、去隔行、智能效果和美颜。文件保存在输入文件旁边。
- 下载:先查询链接再保存。要在 Agent 授权 里选 每次确认 才能下载,之后每次下载前 KwaFlux 都会弹窗问你。
- 补帧仍在桌面应用里。
- 抠像,以及人物、物体和天空的背景替换,仍在桌面应用里。
- 在暂停画面上点选主体,仍在桌面应用里。
- 你在窗口里自己开始的任务,助手不能接管。
下载默认关闭,直到你自己打开
打开 设置 › 通用,找到 Agent 授权。允许 Agent 发起下载 有三档:关闭、每次确认,以及不再询问、直接放行的一档。选 每次确认 时,KwaFlux 会在桌面弹窗里列出链接、保存文件夹和格式,只有你点了才算批准。弹窗 120 秒内没人回应就自动作废。助手也会在对话里请你确认有权保存这个文件,但它自己说有权不算数。KwaFlux 不会代你登录网站,也不会绕过付费墙。
限制
路径必须写成本机上的完整路径,从盘符或根目录开始。转换和增强不允许助手自选输出文件夹。应用见下载。
Agent 这条路不用另买授权:一份授权就覆盖应用和它的 MCP 服务器,最多 2 台电脑,Windows 与 Mac 任意搭配。Agent 发起的任务在那台电脑上运行,处理不需要上传媒体文件。
留在窗口里的事
助手能做的就是上面列出的那些事,清单之外的都做不了。它能查看应用是否在运行、你是否已登录,也能列出任务,等某个任务完成。它能暂停、继续、取消或重试自己启动的任务,还能在修复前诊断损坏的文件。你自己在 KwaFlux 窗口里点开的任务,它控制不了。
转换可按画质档位导出 64 种格式,也能把一段时间做成 GIF。增强包括画质修复、色彩、防抖、去隔行、智能效果和美颜。文件保存在输入文件旁边,助手不能另选文件夹。你给它的路径必须是这台电脑上的完整路径。
有些功能只留在桌面应用里,助手不会运行:补帧、抠像和背景替换、在暂停画面上点选主体,以及免费的 1 秒、3 秒和 5 秒预览。
下载默认关闭,要在 Agent 授权 里设为 每次确认,之后每次下载前 KwaFlux 都会弹窗问你。助手说的一句话不算批准。KwaFlux 不会替你登录网站,也不会绕过付费墙。各应用把从设置里复制的配置放在哪里,见上面的宿主表。不要自编路径。聊天应用通过本地 stdio 连接时,请保持 KwaFlux 打开。
连不上,或者任务失败时
先看 KwaFlux 这一端。 打开 设置 › 通用,在 Agent 授权 里,允许 AI Agent 控制 KwaFlux 下面那一行会列出此刻连着的宿主。如果显示 当前没有 Agent 连接,说明聊天应用压根没连到 KwaFlux,问题出在聊天应用那边。
- 在终端里运行
node --version。这个服务需要 Node.js 18 或更新版本。版本太旧会在启动时直接退出,宿主的日志里会写明原因。 - Codex:在终端界面里输入
/mcp查看正在运行的服务,或者运行codex mcp list。 - Claude Code:
claude mcp list会在每个服务旁边标出状态,比如 Connected 或 Failed to connect。写在项目 .mcp.json 里的服务,第一次运行claude时要你先批准。 - Claude Desktop:日志在 Windows 的 %APPDATA%\Claude\logs,Mac 上是 ~/Library/Logs/Claude。mcp.log 记的是连接情况,mcp-server-kwaflux.log 是这个服务自己输出的信息。
- Cursor:按 Ctrl+Shift+U(Mac 上是 Cmd+Shift+U)打开 Output 面板,在下拉菜单里选 MCP Logs。
连上之后,失败的任务会带回一个简短的错误码,不过助手常常会换个说法转述。同一面板里的 最近的 Agent 操作 会列出每次调用的宿主和结果,你可以自己看那个错误码。
| 错误码 | 含义 | 怎么办 |
|---|---|---|
app_not_running(应用没开) | 这台电脑上没有打开 KwaFlux。 | 打开 KwaFlux,再重新加载 MCP 或重启聊天应用。 |
agent_control_disabled(控制已关闭) | 允许 AI Agent 控制 KwaFlux 被关掉了。 | 到 设置 › 通用 › Agent 授权里重新打开。 |
not_signed_in、entitlement_denied(未登录或无权益) | 这个任务需要登录和付费套餐。 | 在 KwaFlux 里登录,确认你的套餐。 |
app_busy(提交太频繁) | 短时间内发起的任务太多。 | 等一分钟再让助手做。 |
input_not_local(路径不在本机) | 路径以两个斜杠开头(比如 \\server\share),或者是一个网址。 | 把文件复制到本机文件夹,再给出完整路径。 |
model_not_installed(模型未下载) | 这项功能的 AI 模型还没下载到这台电脑上。 | 在 KwaFlux 里打开这项功能下载模型,或者去 设置 › 模型与存储。 |
agent_download_disabled(下载未开启) | Agent 下载还是关闭状态。 | 需要的话,在 Agent 授权 里选 每次确认。 |
user_declined、approval_expired(被拒绝或已超时) | 你拒绝了这次下载,或者弹窗 120 秒内没人回应。 | 等你在电脑前时再让助手下载。 |
助手提交的每个任务,KwaFlux 都会弹出一条带宿主名字的提示,比如“Codex 已提交任务”,任务也会和你自己的任务一起出现在任务中心。如果你怀疑访问令牌泄露了,点连接状态那一行末尾的 重置 Agent 访问令牌。现有连接会断开,已配置好的宿主下次调用时会用新令牌重连。
用你自己的素材试试效果
下载 KwaFlux,付费前先用自己的素材免费预览效果。无需注册账号。媒体文件在你的 GPU 上处理,不需要上传。 视频预览可选 1、3或5 秒;防抖预览可选 5、15或30 秒。
常见问题
能用 Claude、Cursor 或别的 AI 助手控制 KwaFlux 吗?
可以。KwaFlux 自带一个通过 stdio 运行的本地 MCP 服务,Codex、Claude、Cursor 等客户端都能驱动它。保持 KwaFlux 运行,从设置 → 高级 / 诊断 → Agent(MCP)把配置复制到 AI 应用里,并安装 Node.js 18 或更新版本。AI 应用要用 Node.js 来启动这个服务。
为什么 KwaFlux 没有 Authenticate 按钮?
因为 KwaFlux 的 MCP 服务走的是本机 stdio,不是远程网址,所以没有 OAuth 这一步。
助手能在 KwaFlux 里免费导出或转换吗?
不能,在 KwaFlux 里通过 MCP 做转换、修复、增强和下载,都需要登录并开通付费方案。免费的 1 秒、3 秒、5 秒预览仍在桌面应用里。
助手能在 KwaFlux 里发起下载吗?
可以,前提是把 允许 Agent 发起下载 设为 每次确认。之后每次下载前 KwaFlux 都会弹窗问你,助手没法替你批准。
KwaFlux 为什么不接受我给的文件路径?
路径必须是这台电脑上的完整路径,比如 C:\Videos\clip.mp4 或 /Users/you/Movies/clip.mp4。相对路径不行,以两个斜杠开头的路径(比如 \\server\share\clip.mp4)也不行。这类路径 KwaFlux 在打开任何东西之前就会拒绝,因为在 Windows 上,哪怕只是检查一下这个文件,也可能让电脑去和那台服务器做登录认证。先把文件复制到本机文件夹。
怎么查看助手在 KwaFlux 里做了什么?
在 KwaFlux 里打开 设置 › 通用 › Agent 授权,看 最近的 Agent 操作。每一行写着时间、宿主、调用和结果。助手提交的任务也都在任务中心里,提交时还会弹出带宿主名字的提示。
Cursor 的云端 Agent 能用本地 MCP 服务吗?
不能。本地 stdio 服务是你电脑上的一个程序。云端 Agent 跑在 Cursor 的基础设施上,没法启动它。请在同一台电脑上用 Cursor 桌面版里的 Agent。
为什么 mcp.json 里的 Windows 路径要写双反斜杠?
因为 JSON 把反斜杠当作转义的开头。C:\\Program Files 在 JSON 里表示 C:\Program Files。只写一个反斜杠,文件就解析不了。改用正斜杠也可以。
为什么 Claude Desktop 看不到新加的 MCP 服务?
通常是因为它还在后台运行。关掉窗口,再从系统托盘或菜单栏退出,然后重开。下一步再检查 JSON 是否有效,比如 Windows 路径里有没有单反斜杠。
网页上的 Claude Code 能看到本机的 KwaFlux 吗?
不能。KwaFlux 的服务器是宿主在你电脑上启动的本地程序。云端会话会加载项目 .mcp.json 里的远程服务器,不会启动 KwaFlux 旁边的 Node 进程。请在应用已打开的那台电脑上用 Claude Code 或 Claude Desktop。
Codex 的 tool_timeout_sec 是什么?
它是 Codex 等待一次 MCP 工具调用的最长时间,默认 60 秒。如果某个服务的工具会阻塞得更久,比如等待视频导出的工具,就把它调高。见长时间任务怎么处理。
为什么 config.toml 里的 Windows 路径要用单引号?
因为 TOML 的单引号字符串是字面量,反斜杠原样保留。在双引号字符串里,反斜杠表示转义,C:\Program Files 就得写成 C:\\Program Files。
ChatGPT 桌面应用里还要再配一遍 MCP 吗?
不用。OpenAI 的 MCP 页写了:ChatGPT 桌面应用、CLI 和 IDE 扩展共用 Codex 宿主配置。在 ~/.codex/config.toml 里加一次 KwaFlux,这些客户端里的 Codex 都能用。网页版 ChatGPT 不读这份文件。
在 DeepSeek Harness 里,MCP 服务加在哪儿?
加在 cordis.patch.yml 文件里,写成 @deepseek-ai/dsh-mcp-client 插件的一条 insert 行。只给某个配置档用,就写在它自己的文件里。给所有配置档用,就写在主目录的 ~/.dsh/cordis.patch.yml。
补丁文件是 `[]`,KwaFlux 那一行要贴在下面吗?
不要,用 KwaFlux 的 - insert: 整段换掉 []。文件里既有 [] 又有另一项,就不是合法 YAML,DSH 会解析失败退出。新 profile 的补丁经常一开始就是这个空列表。
跑在 VPS 上的 Agent 能用我电脑上的本地 MCP 服务吗?
不能,stdio 服务不行。stdio 服务是 Agent 在同一台机器上启动的子进程。要用你 PC 上的服务,Agent 也得跑在这台 PC 上。各部件怎么衔接,见什么是 AI Agent。
为什么 MCP 服务报“node 不是内部或外部命令”?
因为没装 Node.js,或者它不在宿主看到的 PATH 里。装好之后,退出并重启宿主。还不行,就在服务的 command 里写 node.exe 的完整路径。
为什么耗时长的 MCP 工具调用会超时?
因为有些宿主(比如 Codex 和 DeepSeek Harness)默认一次工具调用最多 60 秒,而 KwaFlux 有些工具本来就要等得更久。把宿主给这个服务的工具超时调高就行。任务本身通常还在继续跑。
Mac 上宿主报 `env: node: No such file or directory`,怎么办?
宿主多半是从程序坞或 Spotlight 打开的,拿不到“终端”里的 PATH,所以看不到 Homebrew 或 nvm 装的 Node.js。Mac 上 KwaFlux 的启动器用的就是这个 PATH 里的 node。先在“终端”跑 which node,再把该服务 env 里的 PATH 设成那个目录加上 /usr/bin:/bin,比如 /opt/homebrew/bin:/usr/bin:/bin。或者直接从“终端”启动宿主。更多 Mac 说明见 KwaFlux 的 Mac 版。
参考资料
- Model Context Protocol: What is the Model Context Protocol (MCP)? (2026-10-11 查阅)
- Model Context Protocol specification: Transports (stdio) (2026-10-11 查阅)
- Node.js: Node.js releases (2026-10-11 查阅)
- Model Context Protocol: Connect to local MCP servers (troubleshooting and Claude Desktop logs) (2026-11-08 查阅)
- Claude Code docs: Connect Claude Code to tools via MCP (claude mcp list and server status) (2026-11-08 查阅)
- OpenAI Codex docs: Model Context Protocol (codex mcp list and /mcp) (2026-11-08 查阅)


