浏览用户指南

Codex

一键或通过 config.toml 配置项,用 MCP 把 OpenAI Codex 连接到 Shotomatic,确认它能正常工作,并解决常见问题。

更新日期 2026年11月16日

查看 Markdown
本页内容

OpenAI Codex 可以通过 Shotomatic 的本地 MCP 服务器,在你的 Mac 或 Windows 电脑上使用 Shotomatic。Shotomatic 已用 Codex 测试。

一键连接

  1. 打开 Shotomatic,进入设置 > AI 智能体(Command + ,,Windows 上为 Ctrl + ,)。
  2. 在连接智能体下,选择 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 不会响应按键。接下来可以试试智能体能做什么中的请求。

Codex | 用户指南 | Shotomatic