它是什么样子

一次真实的 711 张日落拍摄的录制会话。编辑前后的图像是 imagic 真实渲染的，调整数值是实际应用的数值，图库里显示的是这场拍摄的场景画面，点击任意一张即可查看它的编辑。

实时会话 imagic

↵

绕过权限 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）：Settings › Security and login › Developer mode，然后 Plugins › Add › Create MCP App，URL 填 https://mcp.imagic.ink/mcp，Authentication 选 OAuth。Claude.ai：Settings › Connectors › Add custom connector，URL 相同。

输入代码

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 会先逐个取回文件才能读取，这会让大批量导入看起来像卡住了。请先在访达中选中文件夹，选择立即下载。

先激活，再自动化。无界面和 MCP 运行需要已激活的 imagic Max 授权。如果智能体提示授权未激活，请打开一次 imagic 应用并激活，然后重试。

用一句提示词驱动你的照片库