1安裝 imagic 並開始試用

MCP 伺服器隨 imagic Max 提供，500 次匯出的免費試用會解鎖所有功能，無需信用卡。請先從桌面版頁面下載，因為 Claude Code 需要有東西可以對話。

2把 imagic 加入 Claude Code

雙連字號是必須的。少了它，Claude Code 會把 imagic 自己的旗標當成它自己的旗標。

claude mcp add imagic -- imagic-mcp

從本站安裝的是打包版應用程式嗎？那麼你的電腦上不會有 imagic-mcp 指令：應用程式本身就是伺服器（此處以 Windows 為例；在 macOS 上是 /Applications/imagic.app/Contents/MacOS/imagic）：

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

設定

Claude Code 會讀取 .mcp.json（專案）或 ~/.claude.json（使用者）。最上層的鍵是 mcpServers。

{
  "mcpServers": {
    "imagic": {
      "type": "stdio",
      "command": "imagic-mcp"
    }
  }
}

從本站安裝的是打包版應用程式嗎？那麼你的電腦上不會有 imagic-mcp 指令：應用程式本身就是伺服器。讓 command 指向它，並傳入 --mcp（此處以 Windows 為例；在 macOS 上，指令是 /Applications/imagic.app/Contents/MacOS/imagic）：

{
  "mcpServers": {
    "imagic": {
      "type": "stdio",
      "command": "C:\\Program Files\\imagic\\imagic.exe",
      "args": ["--mcp"]
    }
  }
}

那個檔案在哪裡

Windows	`%USERPROFILE%\.claude.json`
macOS	`~/.claude.json`
Linux	`~/.claude.json`

在介面中哪裡找

在工作階段中執行 /mcp，可以查看狀態並啟用或停用伺服器。

3請它選片

如果 Claude Code 已經在執行，請重新啟動它，然後讓它指向一場拍攝：

幫我替 D:/Shoots/eva_tom 裡的拍攝選片，套用我的風格，並匯出留用的照片。

Claude Code 會依序呼叫 scan_directory、analyze_photos、apply_my_style 和 export_photos。這些全都在你的電腦上執行：代理傳送的是指令，絕不是你的照片。

容易讓人踩雷的地方

範圍在你新增伺服器時就固定了。預設是 local，也就是只限這個專案；加上 --scope user 可讓 imagic 到處都能用。
Anthropic 的文件明確指出，~/.claude/mcp.json 和 %APPDATA%\Claude\mcp.json 不會被讀取。只有上面列出的路徑會被讀取。
專案範圍的伺服器在 Claude Code 第一次看到時，需要互動式核准。
手動編輯 .mcp.json 之後要重新啟動工作階段；它只在工作階段開始時讀取。

連上之後 imagic 能做什麼

scan_directory analyze_photos apply_my_style export_photos

總共有 30 個工具，涵蓋相片庫、選片、編輯與你學到的風格。請見完整工具參考，或參考工作流程，看看實際上該提出什麼要求。

要設定其他用戶端嗎？

Claude Desktop Cursor VS Code and GitHub Copilot Codex CLI Gemini CLI Windsurf (Devin Desktop)

用一場真實的拍攝試試

500 次匯出的試用包含 imagic Max、MCP 伺服器以及本頁的每個工具。無需信用卡。

開始免費試用閱讀 MCP 指南

設定已對照 Anthropic 的文件驗證。如果 Claude Code 更改了設定方式而本頁沒跟上，請告訴我們，我們會修正。

將 imagic 連接到 Claude Code