# Codex | 用户指南 | Shotomatic

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

- 类型: 公开网页
- 规范页面: [https://www.shotomatic.com/zh-cn/guide/ai-agents/clients/codex](https://www.shotomatic.com/zh-cn/guide/ai-agents/clients/codex)
- Markdown 页面: [https://www.shotomatic.com/zh-cn/guide/ai-agents/clients/codex.md](https://www.shotomatic.com/zh-cn/guide/ai-agents/clients/codex.md)

浏览用户指南

本页内容

1.  [一键连接](#一键连接)
2.  [手动添加](#手动添加)
3.  [确认能正常工作](#确认能正常工作)
4.  [看不到工具时](#看不到工具时)

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`）：

```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`。** 只适用于手动添加的情况。请参阅[所有客户端的问题排查列表](https://www.shotomatic.com/zh-cn/guide/ai-agents/other-agents#%E9%97%AE%E9%A2%98%E6%8E%92%E6%9F%A5)。

在 Windows 上，请 Codex 翻 Kindle 书页之前，先在书页内点击一次；在阅读界面被点击之前，Kindle 不会响应按键。接下来可以试试[智能体能做什么](https://www.shotomatic.com/zh-cn/guide/ai-agents/what-agents-can-do)中的请求。

## 本页内容

1.  [一键连接](#一键连接)
2.  [手动添加](#手动添加)
3.  [确认能正常工作](#确认能正常工作)
4.  [看不到工具时](#看不到工具时)

## 关于此版本

此 Markdown 页面根据 Shotomatic 服务端渲染的公开页面生成，不包含交互控件和网站导航。引用或分享时，请使用规范页面。
