讓 AI 助理直接操作影片軟體：KwaFlux MCP 快速上手

快速解答

KwaFlux 內建本機 MCP 伺服器，Cursor、Claude、Codex 這類 AI 助理可以直接在你的電腦上執行真正的 KwaFlux 任務：修好打不開的影片、提升畫質、清理音訊、壓縮檔案，或是轉檔。你只要說出需求，處理交給 KwaFlux，每個任務也都會顯示在 KwaFlux 自己的視窗裡。

• KwaFlux 內建本機 MCP 伺服器，Cursor、Claude、Codex 這類 AI 助理可以直接在你的電腦上執行真正的 KwaFlux 任務，而不是寫一串 ffmpeg 指令讓你自己貼上。
• 設定只要三步：安裝 Node.js、從 KwaFlux 的設定複製一段設定檔內容，再到 AI 助理裡重新載入 MCP。
• KwaFlux 目前的 40 項功能中，有 31 項可以直接在對話裡啟動，包括 16 種 AI 增強工具、檔案修復、壓縮，以及 64 種格式的轉檔。
• 主導權在你手上：Agent 發起下載預設關閉，一個開關就能切斷所有 AI 控制，助理啟動的每個任務也都會顯示在 KwaFlux 裡。

設定只要三步，不必碰命令列。輸出檔會存在原始檔旁邊；沒有你的允許，不會從網路下載任何東西。

本文會說明：KwaFlux MCP 是什麼、怎麼連上你的 AI 助理、可以請它做哪些事，以及哪些操作仍留在桌面應用程式裡。

目錄

1. KwaFlux MCP 是什麼？
2. 可以請它做什麼
3. 第 1 步：安裝 Node.js
4. 第 2 步：從 KwaFlux 複製設定
5. 第 3 步：向 AI 助理下指令
6. 需要你親自核准的時候
7. 讓請求一次就成功的訣竅
8. 問題排解
9. 留在桌面應用程式裡的功能
10. 常見問題

KwaFlux MCP 是什麼？

KwaFlux MCP 是隨 KwaFlux 一起安裝的小型伺服器，讓同一台電腦上的 AI 助理透過 Model Context Protocol（模型上下文協定），把 KwaFlux 的功能當成工具來呼叫。

MCP 是 AI 應用程式用來連接外部工具的開放協定。AI 助理（也就是「宿主」）會在本機以處理程序的形式啟動 KwaFlux 伺服器，透過標準輸入輸出和它溝通。伺服器再把每個請求轉給正在執行的 KwaFlux 應用程式，由應用程式檢查後，放進和你手動點選的任務同一個佇列。

最後這一點很重要。AI 助理不必去猜命令列參數，只要填幾個有型別的欄位，例如檔案、模組和輸出尺寸，KwaFlux 就會用你按下匯出時的同一套規則，產生完整的任務。實際做法請見AI 助理能在 KwaFlux 裡做什麼。

可以請它做什麼

AI 助理也能列出任務、帶著即時進度條等待任務完成，並暫停、繼續、取消或重試它自己啟動的任務。

第 1 步：安裝 Node.js

AI 助理會用 Node.js 啟動 KwaFlux MCP 伺服器，大多數本機 MCP 伺服器也是這樣啟動的。KwaFlux 內含伺服器指令碼，但不含 Node.js 本身。

1. 在 KwaFlux 開啟 設定，進入 Agent（MCP）。
2. 如果頁面顯示找不到 Node.js 或版本太舊，請依頁面上的連結到 nodejs.org 下載目前的 LTS 版本並安裝。
3. 回到這個頁面，它會重新偵測，並顯示找到的版本。

補充： KwaFlux 給你的設定裡，寫的是 Node.js 的完整路徑。從 Dock 或「開始」功能表啟動的 AI 助理，常因為在自己的 PATH 裡找不到 Node 而出現「伺服器無法啟動」，寫明完整路徑就能避開這個常見問題。

第 2 步：從 KwaFlux 複製設定

一樣在 Agent（MCP） 頁面，在 MCP 宿主 底下選擇你的 AI 助理。KwaFlux 可以為六種宿主產生設定：Codex、Claude、OpenClaw、DeepSeek（DSH）、Hermes 和 Cursor。

1. 選擇宿主。
2. 複製設定片段；如果宿主提供安裝選項，也可以直接使用。
3. 把它加進宿主的 MCP 設定檔。只新增 kwaflux 這一項，不要覆蓋整個檔案。
4. 在 AI 助理裡重新載入 MCP，或開一個新的工作階段。

每個宿主的設定檔放在不同位置，逐一說明各宿主的設定教學列出了每一家該放在哪裡。其他支援本機 stdio MCP 伺服器的應用程式，也可以照著 MCP 設定頁面連上。

使用 AI 助理時，請讓 KwaFlux 保持開啟。MCP 伺服器只負責傳話，真正的處理在應用程式裡進行。

第 3 步：向 AI 助理下指令

先從只讀取資料的請求開始，確認連線正常：

KwaFlux 有在執行嗎？列出我最近的任務。

接著試一個真正的任務，記得附上檔案的完整路徑：

把 D:\Videos\trip.mp4 轉成 TikTok 格式，轉好再告訴我。

AI 助理會呼叫轉檔工具，然後等待這個任務。在 KwaFlux 的任務清單裡，這個任務會帶有一個標籤，註明是哪個助理提交的，方便你分辨哪些是它的任務、哪些是你自己的。完成後，新檔案會存在 trip.mp4 旁邊，AI 助理也會拿到它的檔名。

你的宿主可能還會把 KwaFlux 內建的四個工作流程顯示成 prompt 或斜線指令：修復損壞的影片、依平台匯出、先下載再轉檔，以及 AI 畫質修復。它們會帶著 AI 助理依正確順序使用各項工具。

需要你親自核准的時候

有些事應該由你決定，而不是由 AI 助理決定。KwaFlux 把這些事放在應用程式裡處理，只有你本人能點：

• 下載預設關閉。 在 Agent 授權 底下，允許 Agent 發起下載 可以維持 關閉、設為 每次確認（會跳出桌面視窗，顯示連結、資料夾和格式），或設為第三個選項，不詢問就直接放行下載。彈出視窗 120 秒內沒有回應就會失效。詳情請見為什麼 AI 不能替你核准下載。
• 一個開關就能關閉所有 AI 控制： 允許 AI Agent 控制 KwaFlux。同一個頁面也會列出目前連線的 AI 助理，並在 最近的 Agent 操作 底下列出它們最近的 200 次呼叫，但不顯示參數。
• AI 助理只能管理自己的任務。 你在視窗裡啟動的任務它看得到，但不能暫停、取消或重試。

讓請求一次就成功的訣竅

• 給完整路徑。 KwaFlux 只接受本機路徑，例如 D:\Videos\clip.mp4 或 /Users/you/Movies/clip.mov，不接受網路磁碟機。
• 說目標，不說參數。 像「小到能用 email 寄」或「Instagram 用」這樣說，AI 助理就能挑出對應的預設。
• 先診斷，再修復。 檢查一個損壞的檔案很快，之後的修復會採用診斷建議的模式。
• 請它等結果。 加一句「完成後告訴我」，AI 助理就會持續追蹤任務，而不是任務一進佇列就回報成功。

技巧： 如果你的宿主可以限制伺服器載入哪些工具，可以把環境變數 KWAFLUX_MCP_TOOLSETS 設成只包含你會用到的群組，例如 convert,repair。工具越少，模型的上下文就留下越多空間。

問題排解

留在桌面應用程式裡的功能

有九項功能需要你一邊看畫面一邊操作：框選範圍、點選主體，或判斷預覽效果。它們是刻意留在應用程式裡的，包括人像背景移除、天空替換、物體移除、補幀和字幕編輯。如果你要求做其中一項，AI 助理會被告知請你回到 KwaFlux 操作，而不是去猜你想點哪裡。

免費的 1 秒、3 秒和 5 秒預覽同樣留在應用程式裡。

結語

安裝 Node.js、複製設定，然後讓應用程式保持開啟。之後，修復、增強、壓縮、轉檔這些原本要一步步點選的工作，一句話就能啟動，而且每一個你都看得到、也停得下來。從損壞的檔案到可以直接上傳的成品，完整示範請見一套完整的 AI Agent 修復工作流程。

KwaFlux 內建本機 MCP 伺服器，支援 Codex、Claude、Cursor 和其他 MCP 應用程式。AI 處理在你自己的 GPU 上執行，媒體檔案不會為了處理而上傳。可在 Windows 10（64 位元，1809 或更新版本）、Windows 11，以及搭載 Apple Silicon 的 macOS 12 或更新版本上執行。匯入檔案和瀏覽應用程式都不需要帳號。僅在匯出、轉換、檔案修復和從連結下載檔案時需要登入並購買付費方案。

下載 KwaFlux · 查看方案