1安裝 imagic 並開始試用
MCP 伺服器隨 imagic Max 提供,500 次匯出的免費試用會解鎖所有功能,無需信用卡。請先從桌面版頁面下載,因為 Codex CLI 需要有東西可以對話。
2把 imagic 加入 Codex CLI
Codex CLI 直接執行本機 MCP 伺服器,不需要通道,也沒有遠端端點。
codex mcp add imagic -- imagic-mcp
從本站安裝的是打包版應用程式嗎?那麼你的電腦上不會有 imagic-mcp 指令:應用程式本身就是伺服器(此處以 Windows 為例;在 macOS 上是 /Applications/imagic.app/Contents/MacOS/imagic):
codex mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp
設定
Codex CLI 會讀取 ~/.codex/config.toml。
最上層的鍵是 mcp_servers,不是大多數其他用戶端使用的 mcpServers 鍵。
[mcp_servers.imagic] command = "imagic-mcp"
從本站安裝的是打包版應用程式嗎?那麼你的電腦上不會有 imagic-mcp 指令:應用程式本身就是伺服器。讓 command 指向它,並傳入 --mcp(此處以 Windows 為例;在 macOS 上,指令是 /Applications/imagic.app/Contents/MacOS/imagic):
[mcp_servers.imagic] command = "C:\\Program Files\\imagic\\imagic.exe" args = ["--mcp"]
那個檔案在哪裡
| macOS | ~/.codex/config.toml |
|---|---|
| Linux | ~/.codex/config.toml |
OpenAI 只以 ~ 形式公布這個路徑,也沒有說明 Windows 上如何展開,所以請使用上方的指令或介面,不要自己猜它落在哪裡。
3請它選片
如果 Codex CLI 已經在執行,請重新啟動它,然後讓它指向一場拍攝:
幫我替 D:/Shoots/eva_tom 裡的拍攝選片,套用我的風格,並匯出留用的照片。
Codex CLI 會依序呼叫 scan_directory、analyze_photos、apply_my_style 和 export_photos。這些全都在你的電腦上執行:代理傳送的是指令,絕不是你的照片。
容易讓人踩雷的地方
- 這是 TOML,不是 JSON,而且鍵名是 mcp_servers,中間有底線。
- 專案範圍的 .codex/config.toml 只有在你信任該專案時才會載入。
- 啟動逾時預設為 10 秒,工具逾時預設為 60 秒;如果大型圖庫開得很慢,可以調高 startup_timeout_sec。
- OpenAI 沒有公布 config.toml 的 Windows 專用路徑。
連上之後 imagic 能做什麼
總共有 30 個工具,涵蓋相片庫、選片、編輯與你學到的風格。請見完整工具參考,或參考工作流程,看看實際上該提出什麼要求。
要設定其他用戶端嗎?
設定已對照 OpenAI 的文件驗證。如果 Codex CLI 更改了設定方式而本頁沒跟上,請告訴我們,我們會修正。