從 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、Claude、OpenClaw、DeepSeek、Hermes 和 Cursor 透過本機 stdio 連到同一台電腦上正在執行的 KwaFlux,檔案不上傳到雲端。

各宿主把設定放在哪裡

宿主放在哪裡
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。
從設定裡複製片段。不要手打儲存庫路徑。

AI 助理能做什麼

它能看應用程式是否在執行、是否已登入,列出任務,並等待某個任務結束。它也能暫停、繼續、取消或重試自己發起的任務。修復之前可以先診斷損壞的檔案。

  • 轉換:依畫質檔位匯出 64 種格式,有 YouTube、TikTok 等平台預設,也能把一段時間做成 GIF。檔案會存在輸入檔旁邊。
  • 修復:可以先做診斷。
  • 增強:畫質修復、色彩、防抖、去交錯、智慧效果和美顏。檔案會存在輸入檔旁邊。
  • 下載:先查詢連結再儲存。要在 Agent 授權 裡選 每次確認 才能下載,之後每次下載前 KwaFlux 都會跳出視窗問你。
  • 補幀仍在桌面應用程式裡。
  • 摳像,以及人物、物體和天空的背景替換,仍在桌面應用程式裡。
  • 在暫停畫面上點選主體,仍在桌面應用程式裡。
  • 你在視窗裡自己開始的任務,AI 助理不能接管。

下載預設關閉,直到你自己打開

打開 設定 › 一般,找到 Agent 授權。允許 Agent 發起下載 有三種模式:關閉、每次確認,以及不再詢問、直接放行的模式。選 每次確認 時,KwaFlux 會在桌面跳出視窗,列出連結、儲存資料夾和格式,只有你按下才算核准。視窗 120 秒內沒有回應就會失效。AI 助理也會在對話裡請你確認有權儲存這個檔案,但它自己說有權並不算數。KwaFlux 不會代你登入網站,也不會繞過付費牆。

限制

路徑必須寫成本機上的完整路徑,從磁碟機代號或根目錄開始。轉換和增強不允許 AI 助理自選輸出資料夾。應用程式見下載。

Agent 這條路不用另外買授權:一份授權就涵蓋應用程式和它的 MCP 伺服器,最多 2 台電腦,Windows 與 Mac 可以混搭。Agent 發起的工作在那台電腦上執行,處理不需要上傳媒體檔案。

留在視窗裡的事

AI 助理能做的就是上面列出的那些事,清單之外的都做不了。它能查看應用程式是否在執行、你是否已登入,也能列出任務、等某個任務完成。它能暫停、繼續、取消或重試自己啟動的任務,還能在修復前診斷損壞的檔案。你自己在 KwaFlux 視窗裡點開的任務,它控制不了。

轉換可依畫質檔位匯出 64 種格式,也能把一段時間做成 GIF。增強包括畫質修復、色彩、防抖、去交錯、智慧效果和美顏。檔案會存在輸入檔旁邊,AI 助理不能另選資料夾。你給它的路徑必須是這台電腦上的完整路徑。

有些功能只留在桌面應用程式裡,AI 助理不會執行:補幀、摳像和背景替換、在暫停畫面上點選主體,以及免費的 1 秒、3 秒和 5 秒預覽。

下載預設關閉,要在 Agent 授權 裡設為 每次確認,之後每次下載前 KwaFlux 都會跳出視窗問你。AI 助理說的一句話不算核准。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。

連上之後,失敗的任務會帶回一個簡短的錯誤碼,不過 AI 助理常常換個說法轉述。同一個面板裡的 最近的 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 MCP 服務常見的錯誤碼

AI 助理送出的每個任務,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 這一步。

AI 助理能在 KwaFlux 裡免費匯出或轉換嗎?

不能,在 KwaFlux 裡透過 MCP 做轉換、修復、增強和下載,都需要登入並開通付費方案。免費的 1 秒、3 秒、5 秒預覽仍在桌面應用程式裡。

AI 助理能在 KwaFlux 裡發起下載嗎?

可以,前提是把 允許 Agent 發起下載 設為 每次確認。之後每次下載前 KwaFlux 都會跳出視窗問你,AI 助理無法替你核准。

KwaFlux 為什麼不接受我給的檔案路徑?

路徑必須是這台電腦上的完整路徑,例如 C:\Videos\clip.mp4 或 /Users/you/Movies/clip.mp4。相對路徑不行,以兩個斜線開頭的路徑(例如 \\server\share\clip.mp4)也不行。這類路徑 KwaFlux 在開啟任何東西之前就會拒絕,因為在 Windows 上,就算只是檢查這個檔案,也可能讓電腦去跟那台伺服器做登入驗證。先把檔案複製到本機資料夾。

怎麼查看 AI 助理在 KwaFlux 裡做了什麼?

在 KwaFlux 裡打開 設定 › 一般 › Agent 授權,看 最近的 Agent 操作。每一行都寫著時間、宿主、呼叫和結果。AI 助理送出的任務也都在任務中心裡,送出時還會跳出帶有宿主名稱的提示。

Cursor 的 Cloud Agent 能使用本機 MCP 伺服器嗎?

不能。本機 stdio 伺服器是你電腦上的程式。Cloud Agent 在 Cursor 的基礎設施上執行,所以無法啟動它。請在同一台電腦上使用 Cursor 桌面應用程式裡的 Agent。

為什麼 mcp.json 裡的 Windows 路徑要用雙反斜線?

因為 JSON 會把反斜線視為跳脫序列的開頭。C:\\Program Files 是 C:\Program Files 在 JSON 裡的正確寫法。只用單一反斜線,檔案就會解析失敗。改用正斜線也可以。

為什麼 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 可以使用我 PC 上的本機 MCP 伺服器嗎?

不行,stdio 伺服器做不到。stdio 伺服器是 Agent 的子處理程序,跑在同一台機器上。想用你 PC 上的伺服器,Agent 也得在那台 PC 上執行。各個部分怎麼串接,請見AI Agent 是什麼。

MCP 伺服器出現「node is not recognized」(不是內部或外部命令)錯誤是怎麼回事?

這是因為 Node.js 沒有安裝,或不在宿主看得到的 PATH 中。安裝好之後,結束並重新啟動宿主。如果還是不行,就在伺服器的 command 裡填入 node.exe 的完整路徑。

MCP 工具呼叫為什麼一久就逾時?

因為有些宿主(例如 Codex 和 DeepSeek Harness)預設單次工具呼叫最多 60 秒,而 KwaFlux 有些工具本來就要等更久。請調高宿主為這個伺服器設定的工具逾時。任務本身通常會繼續執行。

Mac 上宿主回報 `env: node: No such file or directory`,怎麼辦?

宿主多半是從 Dock 或 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 版。

參考資料

  1. Model Context Protocol: What is the Model Context Protocol (MCP)? (2026-10-11 查閱)
  2. Model Context Protocol specification: Transports (stdio) (2026-10-11 查閱)
  3. Node.js: Node.js releases (2026-10-11 查閱)
  4. Model Context Protocol: Connect to local MCP servers (troubleshooting and Claude Desktop logs) (2026-11-08 查閱)
  5. Claude Code docs: Connect Claude Code to tools via MCP (claude mcp list and server status) (2026-11-08 查閱)
  6. OpenAI Codex docs: Model Context Protocol (codex mcp list and /mcp) (2026-11-08 查閱)
  • 教學
  • 本機 AI
  • 桌面軟體
  • MCP

相關文章

KwaFlux 作者兼編輯。文章經 KwaFlux 編輯部審閱,依據產品研究紀錄與公開發布的規格。