如何在 OpenAI Codex 中使用 2Slides MCP 服务器（2026 指南）

快速答案（≤60 字）： OpenAI Codex 只要在

~/.codex/config.toml

中加入 2Slides MCP 服务器，就能产出真正的 PowerPoint 文件。先到 2slides.com/api 取得密钥，然后添加一个运行

npx 2slides-mcp

的

[mcp_servers.2slides]

块（stdio），或一个

url = "https://2slides.com/api/mcp?apikey=KEY"

块（Streamable HTTP）。也可以运行

codex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcp

。然后让 Codex 做一份演示文稿即可。

OpenAI Codex 是 OpenAI 开源的 CLI 编码代理，同时也是一个 Model Context Protocol（MCP）客户端。把它连接到 2Slides MCP 服务器，Codex 就能把一份简报——或你仓库里的一个文件——变成一份成品、可编辑的

，全程都在终端里完成。

本指南给出两种传输方式（本地 stdio 和远程 Streamable HTTP）的具体

配置块、一行 的快捷方式、每个 2Slides 工具的作用，以及在使用 HTTP 服务器时需要留意的版本相关坑。

为什么要把 Codex 和 2Slides 搭配使用？

Codex 擅长对代码和内容进行推理，但它自己产不出二进制的幻灯片文件。2Slides MCP 服务器正好补上这块。分工如下：

• Codex 读取你的源材料（规格文档、README、数据文件），规划幻灯片，决定叙事。
• 2Slides MCP 服务器 渲染出真正的 PowerPoint——基于主题的 Fast PPT，或图片设计型幻灯片，可选 AI 配音和可导出的素材包。

你用日常语言提问，Codex 调用工具，下载链接随后返回。

你需要先准备什么

1. 已安装的 Codex CLI（
   codex
   在你的 PATH 中）。
2. 一个来自 2slides.com/api 的 2Slides API 密钥——该页面同样有 MCP 配置和 Streamable HTTP 端点。
3. Node.js，用于 stdio 传输（它会运行
   npx 2slides-mcp
   ）。HTTP 传输无需任何本地依赖。

Stdio 还是 Streamable HTTP：该选哪种传输？

2Slides MCP 服务器两者都提供。两种方式工具相同——差别在于连接器在哪里运行。

在你的工作站上用 stdio；当 Codex 运行在你无法安装 Node 的地方时用 Streamable HTTP。

方法一：在 config.toml 中配置 stdio

编辑

，加入：

[mcp_servers.2slides]
command = "npx"
args = ["2slides-mcp"]

[mcp_servers.2slides.env]
API_KEY = "YOUR_2SLIDES_API_KEY"

Codex 为 stdio 服务器支持的可选字段包括

、（默认 10 秒）和 （默认 60 秒）。如果你不想把密钥内联进去，而是想透传一个已有的环境变量，可以用 。

或使用

codex mcp add

快捷方式

无需编辑文件——它会替你写好配置块：

codex mcp add 2slides --env API_KEY=YOUR_2SLIDES_API_KEY -- npx 2slides-mcp

之后的一切都是服务器命令。运行 查看你所安装版本的完整子命令列表。

方法二：在 config.toml 中配置 Streamable HTTP

让 Codex 指向托管端点：

[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

如果你更喜欢用请求头认证而非查询字符串中的密钥，Codex 支持 bearer-token 环境变量和静态请求头：

[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp"
bearer_token_env_var = "TWOSLIDES_TOKEN"

版本相关的坑（重要）： Codex 通过它的 Rust MCP 客户端来路由 HTTP MCP 服务器。较新的版本会自动接好这一切，但某些较旧的构建会报错

，直到你启用实验性客户端为止。如果你遇到这种情况，加上：

[features]
experimental_use_rmcp_client = true

先用

检查——较新的发行版已经内置了这一点，而该标志正在被改名为 。只有当你的版本报错时，才把这个配置块当作回退方案使用。

验证连接

codex mcp list      # 列出已配置的 MCP 服务器
codex mcp get 2slides

或者在 Codex TUI 中运行

，查看活跃的服务器及其工具。（ 管理子命令仍在演进； 才是你这个构建的权威说明。）

生成你的第一份演示文稿

你不用手动调用工具——直接提要求：

Read ./docs/launch-plan.md and generate a 10-slide launch deck.
Use a modern, dark business theme from 2slides. Return the
download link when it's done.

Codex 会运行

找到一个 ，然后运行 （Fast PPT），返回一个 ——大约 30–60 秒得到一份真正的 PowerPoint。要求图片设计型幻灯片，它就会切换到 ，轮询 直到文件就绪。

2Slides MCP 工具列表

常见错误与排错

• HTTP 服务器报
  missing field command in mcp_servers
  。 你的 Codex 版本需要在
  [features]
  下加
  experimental_use_rmcp_client = true
  。升级 Codex，或加上该标志。
• TOML 表头 vs 内联表。
  [mcp_servers.2slides.env]
  是一个子表；如果你要内联它，就在服务器那一行写
  env = { API_KEY = "..." }
  ——不要两种写法混用。
• 服务器名称必须唯一。 每个服务器以
  [mcp_servers.NAME]
  段作为键；重用同名会覆盖之前的配置块。
• 没连工具就别想要
  .pptx
  。 Codex 单独只能起草大纲，产不出 PowerPoint。先加上 2Slides。
• 大型演示文稿出现工具超时。 大型或带配音的任务可能超过默认的 60 秒
  tool_timeout_sec
  ；调高它，或让 Codex 对异步任务轮询
  jobs_get
  。

常见问题

OpenAI Codex 支持 MCP 服务器吗？

支持。Codex 是一个 MCP 客户端。你在

中以 配置服务器，或用 添加。stdio 和远程 HTTP 服务器都受支持。

Codex 把 MCP 配置存在哪里？

在

（全局）。受信任的项目也可以使用项目级的 。每个 MCP 服务器都是一个 表。

Stdio 还是 Streamable HTTP？

Stdio 在你的机器上运行

，是本地工作的默认选择。Streamable HTTP 指向托管的 端点，无需任何安装——非常适合 CI 和远程环境。工具相同，产出相同。

它会产出真正的 PowerPoint 吗？

会——

返回一个可编辑的 。Nano Banana 工具返回图片设计型演示文稿，还能添加 AI 配音以及可导出的素材包。

密钥和配置在哪里获取？

在 2slides.com/api?tab=mcp：你的 API 密钥、一份可复制粘贴的配置，以及 Streamable HTTP 端点 URL。

要点总结

往

config.toml

里加一个

[mcp_servers.2slides]

块（或运行

codex mcp add

），Codex 就获得了一个能把任意简报变成成品 PowerPoint 的工具——而且不用离开终端。

Codex 是一个强大的推理代理，2Slides 则是它一直缺的那个文件生成器。要看更大的全景，参见 MCP 如何改变演示文稿工作流 和 PowerPoint MCP 服务器生态地图。更喜欢 Anthropic 的代理？参见 如何在 Claude Code 中使用 2Slides MCP 服务器。

到 2slides.com/api?tab=mcp 取得你的密钥和具体配置，今天就交付你第一份由 Codex 生成的演示文稿。

来源：

• OpenAI Codex — Model Context Protocol（官方文档）
• OpenAI Codex — Configuration Reference
• 2Slides API & MCP server