在 Claude Code 和 Claude Desktop 裡使用 KwaFlux：MCP 設定教學

重點速覽

• Claude Code 只要執行一行 KwaFlux 替你產生的 claude mcp add 命令就能連上 KwaFlux；Claude Desktop 則是在 claude_desktop_config.json 裡加一筆項目。
• 在 Claude Code 裡請使用 user 範圍，這樣 KwaFlux 在每個專案裡都能用，而不只限於某一個資料夾。
• 編輯 Claude Desktop 的設定後，要把程式整個結束（包括系統匣裡的圖示），否則它不會載入伺服器。
• 兩個用戶端在執行 MCP 工具前都會先詢問；在 Claude Code 裡執行 /mcp，可以看到 KwaFlux 是否已連線，以及它提供幾個工具。

Claude 可以透過隨 KwaFlux 一起安裝的本機 MCP 伺服器，在你的電腦上操作 KwaFlux。如果用 Claude Code，KwaFlux 會給你一行現成的 claude mcp add 命令；如果用 Claude Desktop，它會給你一段 JSON 項目，讓你合併進 claude_desktop_config.json。不管用哪一個，Claude 工作時都要讓 KwaFlux 保持開啟。

本文會說明：兩種 Claude 用戶端各自怎麼連接、設定存在哪裡、如何確認連線、第一次可以下哪些指令，以及常見問題怎麼解決。

目錄

1. 用 Claude Code 還是 Claude Desktop？
2. 開始之前
3. Claude Code：一行命令搞定
4. Claude Code：和專案共用設定
5. Claude Desktop：編輯設定檔
6. 第一次可以下的指令
7. 長時間任務與逾時
8. 問題排解
9. 常見問題

用 Claude Code 還是 Claude Desktop？

Claude Code 是 Anthropic 在終端機和 IDE 裡使用的程式開發 Agent；Claude Desktop 是 Windows 和 macOS 上的 Claude 聊天應用程式。兩者都能執行本機 MCP 伺服器，也都能使用 KwaFlux。

如果你主要是想用聊天的方式請 Claude 處理影片，從 Claude Desktop 開始比較簡單。如果你本來就在終端機或 IDE 裡工作，Claude Code 可以直接融入你的工作環境。其他 AI 助理請見我們的比較。

開始之前

• KwaFlux 1.0.14 或更新版本，並保持開啟。 MCP 伺服器是和執行中的應用程式溝通。
• Node.js 18 或更新版本，並在 PATH 中。 KwaFlux 的設定卡片上寫著：「宿主透過 Node.js 18 或更新版本啟動該服務，請確認已安裝 Node 且在 PATH 中。」如果 node --version 執行失敗，請到 nodejs.org 安裝目前的 LTS 版本。KwaFlux 的設定卡片也會尋找 Node.js，並把它的完整路徑寫進設定，就像下面的範例那樣；如果找不到 Node.js，卡片會告訴你，並改寫成 node。
• 在 KwaFlux 中： 開啟 設定 › Agent（MCP），在 MCP 宿主 底下選擇 Claude，再選 Claude Code 或 Claude Desktop。

Claude Code：一行命令搞定

1. 選好 Claude Code 後，按下 複製安裝命令。
2. 貼到終端機裡執行。Windows 預設安裝位置的命令如下：

claude mcp add --scope user kwaflux -- "C:\Program Files\nodejs\node.exe" "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

3. 開一個新的 Claude Code 工作階段，執行 /mcp。你應該會看到 kwaflux 已連線，並顯示它的工具數量。

這行命令有兩個地方值得注意：

• **--scope user** 會把伺服器存進 ~/.claude.json，讓你所有的專案都能使用。Claude Code 的預設是 local 範圍，那樣 KwaFlux 只會出現在你執行命令的那個資料夾。
• **--** 用來把 Claude 自己的選項和啟動伺服器的命令分開。Claude Code 的文件說明：「-- 之後的所有內容都會原封不動地傳給伺服器。」

Claude Code：和專案共用設定

KwaFlux 的提示也提供了專案檔案的做法：「寫入專案根目錄 .mcp.json，或執行下方 CLI。」專案的 .mcp.json 用來透過版本控制，和所有在這個資料夾工作的人共用伺服器。如果團隊把影片專案放在儲存庫裡，而且每個人的 KwaFlux 都裝在同一個位置，就可以用這個方法。

選好 Claude Code 後，按下 複製設定，把內容存成專案根目錄下的 .mcp.json：

{
  "mcpServers": {
    "kwaflux": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
      ]
    }
  }
}

在互動式工作階段中，Claude Code 使用專案 .mcp.json 裡的伺服器之前，會先請你核准。在你核准之前，/mcp 會把這個伺服器顯示為等待中。

Claude Desktop：編輯設定檔

1. 在 KwaFlux 裡選擇 Claude › Claude Desktop，再按 複製設定。
2. 在 Claude Desktop 裡，從 Claude 選單開啟 Settings（設定），進入 Developer（開發者），再按 Edit Config（編輯設定）。這會開啟（或新建）下列檔案： - Windows：%APPDATA%\Claude\claude_desktop_config.json - macOS：~/Library/Application Support/Claude/claude_desktop_config.json
3. 把 kwaflux 項目合併進 mcpServers。不要刪掉原本已有的伺服器。
4. 把 Claude Desktop 整個結束，包括系統匣或選單列裡的圖示，然後再重新開啟。KwaFlux 的提示對這點講得很直接：修改後要把程式整個結束，再重新開啟。
5. 在對話中，開啟輸入框左下角的選單，進入 Connectors，確認 kwaflux 和它的工具都有列出來。

Claude Desktop 在每個工具執行前都會先請你核准，除非你在這段對話中允許了某個工具。

第一次可以下的指令

先從唯讀的檢查開始：

用 KwaFlux 的工具檢查一下 KwaFlux 有沒有在執行，以及我是否已經登入。

接著試試真正的任務，記得附上完整的本機路徑：

補幀，以及去背和替換類工具，都留在應用程式裡；遇到這些需求時，AI 助理會被告知請你回到應用程式操作。Agent 發起下載預設保持關閉，除非你在 Agent 授權 底下把 允許 Agent 發起下載 設為 每次確認。之後每次下載，KwaFlux 都會跳出視窗，AI 助理也會在對話裡請你確認自己有權下載該內容。

技巧： 在 Claude Code 裡，KwaFlux 的工具會以 mcp__kwaflux__<tool> 的形式出現，例如 mcp__kwaflux__kwaflux_get_app_status。在權限規則裡用這些名稱允許唯讀工具，Claude 每次查看任務清單時就不會再問你。

長時間任務與逾時

影片任務可能要花上好幾分鐘。KwaFlux 的等待工具每次呼叫最多等 300 秒，預設為 60 秒，之後會回報任務是否完成。如果還沒完成，Claude 再等一次就好。

如果電腦比較慢，連伺服器本身都啟動得慢，Claude Code 的文件提供了控制啟動時間的 MCP_TIMEOUT 環境變數，例如 MCP_TIMEOUT=10000 claude。至於工具呼叫，專案 .mcp.json 的項目可以加上以毫秒為單位的 timeout 欄位。如果你會要求長時間等待，請設成大於 300,000。

問題排解

所有宿主都會遇到的問題，請見 KwaFlux MCP 問題排解指南。

結語

在 Claude Code 裡，以 user 範圍執行 KwaFlux 替你複製好的命令，再用 /mcp 確認。在 Claude Desktop 裡，把項目合併進 claude_desktop_config.json，然後把程式整個結束再重新開啟。接著讓 KwaFlux 保持開啟，先從狀態檢查開始。

從 Claude 操作 KwaFlux

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

下載 KwaFlux · 查看方案