2Slides Team
4 min read
如何在 OpenAI Codex 中使用 2Slides MCP 服务器（2026 指南）
快速答案（≤60 字）： OpenAI Codex 只要在
~/.codex/config.toml中加入 2Slides MCP 服务器，就能产出真正的 PowerPoint 文件。先到 2slides.com/api 取得密钥，然后添加一个运行npx -y 2slides-mcp@latest的[mcp_servers.2slides]块（stdio），或一个url = "https://2slides.com/api/mcp?apikey=KEY"块（Streamable HTTP）。也可以运行codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest。然后让 Codex 做一份演示文稿即可。
OpenAI Codex 是 OpenAI 开源的 CLI 编码代理，同时也是一个 Model Context Protocol（MCP）客户端。把它连接到 2Slides MCP 服务器，Codex 就能把一份简报——或你仓库里的一个文件——变成一份成品、可编辑的 .pptx，全程都在终端里完成。
本指南给出两种传输方式（本地 stdio 和远程 Streamable HTTP）的具体 config.toml 配置块、一行 codex mcp add 的快捷方式、每个 2Slides 工具的作用，以及在使用 HTTP 服务器时需要留意的版本相关坑。
为什么要把 Codex 和 2Slides 搭配使用？
Codex 擅长对代码和内容进行推理，但它自己产不出二进制的幻灯片文件。2Slides MCP 服务器正好补上这块。分工如下：
- Codex 读取你的源材料（规格文档、README、数据文件），规划幻灯片，决定叙事。
- 2Slides MCP 服务器 渲染出真正的 PowerPoint——基于主题的 Fast PPT，或图片设计型幻灯片，可选 AI 配音和可导出的素材包。
你用日常语言提问，Codex 调用工具，下载链接随后返回。
你需要先准备什么
- 已安装的 Codex CLI（
codex在你的 PATH 中）。 - 一个来自 2slides.com/api 的 2Slides API 密钥——该页面同样有 MCP 配置和 Streamable HTTP 端点。
- Node.js，用于 stdio 传输（它会运行
npx -y 2slides-mcp@latest）。HTTP 传输无需任何本地依赖。
Stdio 还是 Streamable HTTP：该选哪种传输？
2Slides MCP 服务器两者都提供。两种方式工具相同——差别在于连接器在哪里运行。
| Stdio 协议 | Streamable HTTP 协议 | |
|---|---|---|
| 运行位置 | 本地，通过 npx -y 2slides-mcp@latest | 远程，由 2Slides 托管 |
| 本地 Node.js | 需要 | 不需要 |
| 配置风格 | command + args + env | url（可选 bearer_token_env_var） |
| 适用场景 | 本地开发、完全可控 | 远程/CI 主机、轻量配置 |
在你的工作站上用 stdio；当 Codex 运行在你无法安装 Node 的地方时用 Streamable HTTP。
方法一：在 config.toml 中配置 stdio
编辑 ~/.codex/config.toml，加入：
[mcp_servers.2slides]
command = "npx"
args = ["-y", "2slides-mcp@latest"]
[mcp_servers.2slides.env]
API_KEY = "YOUR_2SLIDES_API_KEY"Codex 为 stdio 服务器支持的可选字段包括 cwd、startup_timeout_sec（默认 10 秒）和 tool_timeout_sec（默认 60 秒）。如果你不想把密钥内联进去，而是想透传一个已有的环境变量，可以用 env_vars = ["API_KEY"]。
或使用 codex mcp add 快捷方式
无需编辑文件——它会替你写好配置块：
codex mcp add 2slides --env API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest-- 之后的一切都是服务器命令。运行 codex mcp --help 查看你所安装版本的完整子命令列表。
方法二：在 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 服务器。较新的版本会自动接好这一切，但某些较旧的构建会报错 missing field command in mcp_servers，直到你启用实验性客户端为止。如果你遇到这种情况，加上：
[features]
experimental_use_rmcp_client = true先用 codex --version 检查——较新的发行版已经内置了这一点，而该标志正在被改名为 [features].rmcp_client。只有当你的版本报错时，才把这个配置块当作回退方案使用。
验证连接
codex mcp list # 列出已配置的 MCP 服务器
codex mcp get 2slides或者在 Codex TUI 中运行 /mcp，查看活跃的服务器及其工具。（codex mcp 管理子命令仍在演进；codex mcp --help 才是你这个构建的权威说明。）
生成你的第一份演示文稿
你不用手动调用工具——直接提要求：
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 会运行 themes_search 找到一个 themeId，然后运行 slides_generate（Fast PPT），返回一个 downloadUrl——大约 30–60 秒得到一份真正的 PowerPoint。要求图片设计型幻灯片，它就会切换到 slides_create_pdf_slides，轮询 jobs_get 直到文件就绪。
2Slides MCP 工具列表
| 工具 | 作用 | 积分 |
|---|---|---|
themes_search | 为 Fast PPT 查找 themeId | 免费 |
slides_generate | 基于主题的 PowerPoint（Fast PPT），同步/异步 | 10 / 页 |
slides_create_pdf_slides | 由文字生成自定义图片设计型幻灯片（Nano Banana） | 100 / 页 (1K/2K), 200 (4K) |
slides_create_like_this | 匹配参考图片风格的幻灯片 | 100 / 页 (1K/2K), 200 (4K) |
slides_generate_narration | 为 Nano Banana 任务添加 AI 语音配音 | 210 / 页 |
slides_download_slides_pages_voices | 把页面 + 音频导出为 ZIP | 免费 |
jobs_get | 轮询异步任务直到完成 | 免费 |
常见错误与排错
- 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 客户端。你在 ~/.codex/config.toml 中以 [mcp_servers.NAME] 配置服务器，或用 codex mcp add 添加。stdio 和远程 HTTP 服务器都受支持。
Codex 把 MCP 配置存在哪里？
在 ~/.codex/config.toml（全局）。受信任的项目也可以使用项目级的 .codex/config.toml。每个 MCP 服务器都是一个 [mcp_servers.NAME] 表。
Stdio 还是 Streamable HTTP？
Stdio 在你的机器上运行 npx -y 2slides-mcp@latest，是本地工作的默认选择。Streamable HTTP 指向托管的 https://2slides.com/api/mcp 端点，无需任何安装——非常适合 CI 和远程环境。工具相同，产出相同。
它会产出真正的 PowerPoint 吗？
会——slides_generate 返回一个可编辑的 .pptx。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 生成的演示文稿。
来源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
