它看起來是什麼樣子

一段在日落時針對真實 711 張照片的拍攝所錄下的操作。編輯前後的影像都是真正的 imagic 渲染，調整數值也是實際套用的那些，而相片庫顯示的是這場拍攝的場景畫面，點選任何一個即可查看它的編輯。

即時操作 imagic

↵

Bypass permissions MCP

imagic 即時預覽 +

← →127.0.0.1:8765

imagic從你的 AI 代理即時傳來等待中

正在編輯—

正在等待你的代理開始編輯照片。

編輯前編輯後

相片庫

正在播放整個過程

動手設定

四個步驟，大約五分鐘。前兩個只需要做一次。

安裝 imagic 並啟用

MCP 伺服器是 imagic Max 的一部分。500 次匯出的免費試用也包含它，所以你在購買任何東西之前就能先做這件事。先啟動一次應用程式並輸入你的金鑰：代理會沿用那次啟用，在啟用完成前，無介面執行會被拒絕。

向你的代理註冊 imagic

一行指令。用 --mcp 旗標指向已安裝的應用程式。

macOS

claude mcp add imagic -- /Applications/imagic.app/Contents/MacOS/imagic --mcp

Windows

claude mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

pip install

claude mcp add imagic -- imagic-mcp

Cursor、Codex、Copilot 和 Claude Desktop 在各自的設定檔中使用相同的指令與參數，請見設定參考。

說出你想要的

用白話文就好。由代理挑選工具，你不必指名。

幫我替這場拍攝選片，依場地的燈光為留用的照片調色，
並匯出到原始檔旁邊的資料夾。

它會掃描、為每張照片評分、分成留用／待檢視／丟棄，然後編輯並匯出。如果是大型拍攝，可以請它先分析，並在動手之前先給你看各類的張數。

看著它進行

伺服器一啟動，就會開啟本機預覽。不會上傳任何東西，它是由你自己的電腦提供的。

http://127.0.0.1:8765

每一張照片都會以完整解析度顯示，附有編輯前後的滑桿，以及代理所呼叫工具的執行記錄。這是在還來得及修正方向時，最快發現某個編輯走偏的方法。

從 ChatGPT 或 Claude.ai 使用 imagic

這兩個不會執行本機設定檔：imagic 透過一個小型常駐中繼服務與它們配對，所以會多一個瀏覽器步驟，並使用 6 位數代碼。

在 imagic 中開啟遠端控制

在 imagic 的首頁畫面開啟遠端控制。會出現一組 6 位數代碼；工作時請保持 imagic 開啟。

把 imagic 新增為自訂應用程式或連接器

ChatGPT（網頁版，chatgpt.com）：設定 › 安全性與登入 › 開發人員模式，然後外掛程式 › 新增 › 以網址 https://mcp.imagic.ink/mcp 與驗證方式 OAuth 建立 MCP App。Claude.ai：設定 › 連接器 › 新增自訂連接器，網址相同。

輸入代碼

imagic 的頁面會開啟，並要求輸入第一步的 6 位數代碼。輸入後兩者就配對完成；ChatGPT 有時會在訊息之間丟掉這個應用程式，如果它說看不到 imagic，請在 + 選單中再勾選一次。

需要 imagic 1.4 或更新版本，以及 Max 方案或進行中的試用，與上述本機用戶端相同。完整步驟：ChatGPT 設定 · Claude.ai 設定。

你的代理能做什麼

二十一個工具，依用途分組。你很少需要指名呼叫它們，這是代理在挑選時的選項。

階段	工具	功能
匯入	`scan_directory`	把一個 RAW 或 JPEG 資料夾匯入相片庫。重新掃描是安全的。
選片	`analyze_photos`, `reselect_photos`	為銳利度、曝光與構圖評分，找出重複照片，分成留用／待檢視／丟棄。重新篩選時會根據儲存的分數立即重新排序。
檢視	`list_photos`, `get_photo`, `set_photo_status`, `get_library_stats`	檢查並覆寫。你手動的留用／丟棄決定，在重新選片後一律保留。
編輯	`apply_adjustments`, `apply_preset`, `list_presets`, `get_photo_edits`	逐張調整滑桿，或套用一個命名的風格。一切都會記錄在 imagic 一般的編輯記錄中，所以可以檢視，也可以復原。
風格	`start_style_calibration`, `record_style_calibration`, `learn_style_from_library`, `apply_my_style`, `get_style_profile`, `match_style_from_examples`	透過一次簡短的校準，或從你已編輯過的照片，教 imagic 你是怎麼修圖的。
品質	`check_score_freshness`, `reanalyze_stale_photos`	找出由舊版 AI 評分的照片，並重新執行。
匯出	`export_photos`	把編輯結果渲染到你指定的資料夾。

值得知道的事

沒有任何東西會離開你的電腦。MCP 伺服器、預覽與渲染全都在本機執行。你的代理傳送的是指令；你的照片留在原處。

編輯是非破壞性的。代理所做的每項調整，儲存方式都與桌面編輯器儲存你的調整相同。之後在 imagic 中開啟照片，就能修改任何你不同意的地方。

iCloud 中的照片要先下載。如果你的拍攝檔案放在與 iCloud 同步、且檔案已被移出本機的資料夾中，macOS 必須先抓取每個檔案才能讀取，這會讓大量匯入看起來像卡住了。請先在 Finder 中選取該資料夾，然後選擇立即下載。

自動化之前先啟用。無介面與 MCP 的執行需要已啟用的 imagic Max 授權。如果代理回報授權尚未啟用，請先開啟一次 imagic 應用程式並啟用，然後重試。

用一個提示操作你的相片庫