Codex
一键或通过 config.toml 配置项,用 MCP 把 OpenAI Codex 连接到 Shotomatic,确认它能正常工作,并解决常见问题。
更新日期 2026年11月16日
OpenAI Codex 可以通过 Shotomatic 的本地 MCP 服务器,在你的 Mac 或 Windows 电脑上使用 Shotomatic。Shotomatic 已用 Codex 测试。
一键连接
- 打开 Shotomatic,进入设置 > AI 智能体(
Command + ,,Windows 上为Ctrl + ,)。 - 在连接智能体下,选择 Codex (ChatGPT) 旁边的连接。
Shotomatic 会把自己添加到 ~/.codex/config.toml,开启允许 AI 智能体使用 Shotomatic 并批准 Codex,因此不会出现批准卡片。开始新的 Codex 会话即可载入服务器。Codex 在你的电脑上创建设置文件夹之后,列表中才会出现 Codex (ChatGPT)。
手动添加
在设置 > AI 智能体中开启允许 AI 智能体使用 Shotomatic,安装 Node 18.3 或更高版本,然后把下面的内容添加到 ~/.codex/config.toml(Windows 上为 %USERPROFILE%\.codex\config.toml):
[mcp_servers.shotomatic]
command = "npx"
args = ["-y", "shotomatic", "mcp"]
开始新的会话。用这种方式添加的 Codex 首次连接时,Shotomatic 会显示批准卡片,选择允许即可。
确认能正常工作
向 Codex 这样请求:
“检查 Shotomatic 的状态,并告诉我你能用它做什么。”
设置正确时,智能体会回复 Shotomatic 版本、Mac 上是否已授予屏幕录制和辅助功能权限、你的版本以及今天还能使用的免费截图数、网页浏览器是否已安装,以及正在运行的截图任务。
看不到工具时
- Codex 没有列出 Shotomatic。 编辑
config.toml后开始新的会话,并检查文件中[mcp_servers.shotomatic]表是否只出现一次。 - 设置中没有 Codex (ChatGPT)。 打开一次 Codex,让它创建设置文件夹,然后重新打开设置 > AI 智能体。
- “MCP access is turned off.” 在设置 > AI 智能体中开启允许 AI 智能体使用 Shotomatic,然后开始新的会话。
- 智能体在等待批准。 打开 Shotomatic,在卡片上选择允许。
- 找不到
npx。 只适用于手动添加的情况。请参阅所有客户端的问题排查列表。
在 Windows 上,请 Codex 翻 Kindle 书页之前,先在书页内点击一次;在阅读界面被点击之前,Kindle 不会响应按键。接下来可以试试智能体能做什么中的请求。