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 没有发布针对 Windows 的 config.toml 路径。

连接之后 imagic 能做什么

scan_directory analyze_photos apply_my_style export_photos

一共 30 个工具，涵盖图库、选片、编辑和你学到的风格。见完整的工具参考，或者看工作流程了解该如何提要求。

要设置别的客户端？

Gemini CLI Windsurf (Devin Desktop) Zed Continue Goose Warp

在真实拍摄上试试

500 次导出的试用包含 imagic Max、MCP 服务器以及本页上的每个工具。无需绑卡。

开始免费试用阅读 MCP 指南

配置已对照 OpenAI 的文档核对。如果 Codex CLI 更改了设置方式而本页没有跟上，请告诉我们，我们会修正。

把 imagic 连接到 OpenAI Codex CLI