在 Codex 裡使用 KwaFlux：MCP 設定、逾時與核准

用 codex mcp add 或 config.toml 把 KwaFlux 加進 OpenAI Codex，為長時間的影片任務調高工具逾時，並設定 Codex 執行工具前何時要先詢問你。

Joseph Williams 撰寫 · KwaFlux 編輯部審閱2026年10月27日7 分鐘

重點速覽

Codex 只要一行 codex mcp add 命令，或在 ~/.codex/config.toml 裡加一張 [mcp_servers.kwaflux] 表，就能連上 KwaFlux。兩種寫法 KwaFlux 都會替你產生。
Codex 預設每次 MCP 工具呼叫只等 60 秒，而 KwaFlux 的等待工具一次最多可以等 300 秒。把 tool_timeout_sec 調高，長時間的影片任務才不會被中途切斷。
用命令列加入時，不會帶上 KwaFlux 的 TOML 裡那行 20 秒的啟動逾時。如果伺服器啟動得慢，請自己補上。
善用 Codex 的核准模式，唯讀的 KwaFlux 工具可以直接執行，會寫入檔案的任務則照樣先問過你。

OpenAI 的 Codex 可以透過隨 KwaFlux 一起安裝的本機 MCP 伺服器來操作 KwaFlux。在 KwaFlux 的設定裡選擇 Codex，複製安裝命令或 TOML 表，加進 Codex，並讓 KwaFlux 保持開啟即可。處理影片時，有兩項設定值得調整：工具逾時和核准模式。

本文會說明：把 KwaFlux 加進 Codex 的兩種方法、長時間任務要注意的逾時設定、如何控制核准，以及一開始可以先問什麼。

Codex 如何執行 MCP 伺服器
開始之前
方法 1：codex mcp add
方法 2：編輯 config.toml
長時間影片任務的逾時
核准與工具清單
先試這幾個指令
問題排解
常見問題

Codex 如何執行 MCP 伺服器

每個工作階段開始時，Codex 會啟動設定檔裡列出的每一個本機 MCP 伺服器，並透過標準輸入與輸出和它溝通。接著，這個伺服器的工具就會和 Codex 自己的工具一起出現在模型面前。Codex CLI 和 Codex 桌面應用程式讀的是同一份設定。

KwaFlux 的伺服器是隨應用程式安裝的一支 Node.js 指令碼。它本身不處理任何東西，只是把請求轉交給執行中的 KwaFlux 應用程式，由應用程式檢查請求並執行任務。

開始之前

KwaFlux 1.0.14 或更新版本，並保持開啟。
Node.js 18 或更新版本，並在 PATH 中。 用 node --version 確認；如果沒有，請到 nodejs.org 安裝目前的 LTS 版本。KwaFlux 的設定卡片也會尋找 Node.js，並把它的完整路徑寫進設定，就像下面的範例那樣；如果找不到 Node.js，卡片會告訴你，並改寫成 node。
在 KwaFlux 中： 開啟設定 › Agent（MCP），在 MCP 宿主 底下選擇 Codex。

方法 1：codex mcp add

按下 複製安裝命令，貼到終端機裡執行。Windows 預設安裝位置的命令如下：

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

我們用 Codex CLI 0.118.0 實際執行，它輸出了 Added global MCP server 'kwaflux'.。接著確認一下：

codex mcp list

清單裡應該會看到 KwaFlux 顯示為已啟用。這行命令會在 ~/.codex/config.toml 裡寫入一張只有 command 和 args 的表。值得手動補上的兩行，請繼續往下看。

方法 2：編輯 config.toml

也可以改按 複製設定，把這張表附加到 ~/.codex/config.toml，或受信任專案裡的 .codex/config.toml：

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20

就像 KwaFlux 的提示寫的：「鍵名是 mcp_servers（底線）。」改好後重新啟動 Codex，或在工作階段裡執行 /mcp，就能看到這個伺服器。

補充： 路徑刻意用單引號括起來。在 TOML 裡，單引號字串是字面字串，Windows 的反斜線不需要跳脫；如果用雙引號，每個反斜線都得寫成 \\。

長時間影片任務的逾時

Codex 的 MCP 文件為每個伺服器列出兩種逾時：

設定	Codex 預設值	KwaFlux 建議值	原因
`startup_timeout_sec`	10	20（KwaFlux 的 TOML 已內含）	電腦忙碌時，Node.js 和伺服器可能要幾秒才能啟動
`tool_timeout_sec`	60	330	KwaFlux 的等待工具一次呼叫最多可以等 300 秒

第二項最要緊。Codex 請 KwaFlux 等待一個匯出任務時，等待工具會一直卡住，直到任務結束或碰到它自己的上限，最長 300 秒。如果 Codex 用的是 60 秒的預設值，超過的等待就會在 Codex 這一端被切斷，模型可能把它當成失敗。請這樣設定：

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20
tool_timeout_sec = 330

無論如何，任務都會在 KwaFlux 裡繼續執行。逾時只是結束了那一次等待，Codex 之後還可以再查詢任務狀態。

核准與工具清單

Codex 讓你為每個伺服器分別設定：工具執行前，什麼時候要先問你。它的文件為 default_tools_approval_mode 列出 auto、prompt、writes 和 approve 四種值，其中 writes 會「對未標記為唯讀的工具跳出提示」。這很適合 KwaFlux：查詢狀態、列出任務的呼叫直接放行，會寫入檔案的任務照樣先問。

你也可以用 enabled_tools（允許清單）或 disabled_tools（拒絕清單）縮小 Codex 載入的範圍。例如你只用 Codex 轉檔和修復，就只列出任務、轉檔和修復相關的工具。工具越少，模型的上下文也會騰出越多空間，詳情請見我們的工具設計文章。

先試這幾個指令

看看 KwaFlux 有沒有在執行，再列出我最近的 KwaFlux 任務。

接著可以試試：

對 Codex 說	KwaFlux 會做什麼
「診斷 D:\Phone\clip.mp4，再用建議的模式修復。」	先診斷，再建立修復任務；結果寫在原始檔旁邊
「列出 KwaFlux 裡 TikTok 的匯出格式，再用 HD 1080P 檔位匯出 D:\Clips\promo.mov。」	查詢這個格式的檔位，再把轉換器的匯出任務排進佇列
「把 D:\Rec 裡每個 .mkv 都用畫質優先的設定轉成 MP4，一次一個，每個都等它完成。」	在 KwaFlux 的速率限制內，依序把轉檔任務排進佇列
「對 D:\Walk\bridge.mp4 執行影片防抖。」	以應用程式的預設設定建立一個 AI 增強任務

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

問題排解

症狀	可能原因	解決方法
`/mcp` 裡沒有 kwaflux	鍵名寫錯（`mcp-servers` 或 `mcpServers`），或改錯了檔案	在 `~/.codex/config.toml` 裡使用 `[mcp_servers.kwaflux]`
伺服器啟動逾時	啟動較慢，碰上 10 秒的預設值	加上 `startup_timeout_sec = 20`
等待約一分鐘後就失敗	工具逾時是 60 秒	加上 `tool_timeout_sec = 330`
專案裡的設定沒有作用	這個專案不受信任	把專案設為受信任，或改用全域設定
每次呼叫都回傳 `app_not_running`	KwaFlux 沒有開啟	開啟 KwaFlux 後再問一次
路徑那一行出現 TOML 解析錯誤	反斜線寫在雙引號裡	改用單引號，或把每個反斜線都寫兩次

各個宿主都可能遇到的問題，請見 KwaFlux MCP 問題排解指南。

結語

用 KwaFlux 替你複製好的命令或 TOML 把它加進 Codex，再補上兩行：20 秒的啟動逾時，以及 330 秒的工具逾時。如果希望 Codex 只在會建立檔案的任務前詢問你，就選 writes 核准模式。讓 KwaFlux 保持開啟，先從查詢狀態開始。

在 Codex 裡操作 KwaFlux

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

下載 KwaFlux · 查看方案

用你自己的素材試試效果

下載 KwaFlux，付費前先用自己的素材免費預覽效果——無需註冊，在你的 GPU 上處理，處理不需要上傳媒體檔案。影片預覽可選 1、3或5 秒；防抖預覽可選 5、15或30 秒。

免費預覽 KwaFlux 瀏覽功能

常見問題

Codex 的 MCP 伺服器設定存在哪裡？

存在 ~/.codex/config.toml，每個伺服器各一張 [mcp_servers.<name>] 表。受信任的專案也可以有自己的 .codex/config.toml。CLI 和桌面應用程式都會讀取這兩個檔案。

Codex 的 tool_timeout_sec 是什麼？

它是 Codex 等待單次 MCP 工具呼叫的時間上限，超過就放棄，預設 60 秒。如果某個伺服器的工具可能卡得更久，例如等待影片匯出的工具，就把它調高。請見長時間任務怎麼處理。

config.toml 裡的 Windows 路徑為什麼要用單引號？

因為 TOML 的單引號字串是字面字串，反斜線會原樣保留。在雙引號字串裡，反斜線代表跳脫，所以 C:\Program Files 得寫成 C:\\Program Files。

Codex 可以不經詢問就執行 MCP 工具嗎？

要看你設定的核准模式。Codex 可以每個工具都問、只問非唯讀的工具，或都不問。對會建立檔案的工具來說，writes 模式是合理的折衷。

Codex 適合拿來處理影片嗎？

看你的工作方式。習慣用終端機、或本來就用 Codex 寫程式的人，用起來會很順手；其他人可能覺得聊天應用程式比較容易上手。各種選擇請見我們的AI 助理比較。

參考資料

OpenAI, Codex documentation, MCP page (codex mcp add; config.toml fields; startup_timeout_sec default 10; tool_timeout_sec default 60; approval modes; enabled_tools and disabled_tools; /mcp) （2026-10-26 查閱）
TOML v1.0.0, "String" (literal strings in single quotes) （2026-10-26 查閱）
Node.js, "Node.js Releases" （2026-10-25 查閱）

教學
MCP 協定

Joseph Williams

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