如何將 OpenAI Codex 串接 2Slides MCP Server（2026 完整指南）

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

~/.codex/config.toml

加上 2Slides MCP server，就能產出真正的 PowerPoint 檔案。先到 2slides.com/api 取得 key，再加上一個執行

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 server，Codex 就能把一份簡報需求 —— 或你儲存庫裡的一個檔案 —— 變成完成、可編輯的

，全程都在終端機完成。

本指南提供兩種傳輸方式的精確

設定區塊（本機 stdio 與遠端 Streamable HTTP）、一行搞定的 捷徑、各個 2Slides 工具的用途，以及使用 HTTP server 時要注意的版本陷阱。

為什麼要把 Codex 跟 2Slides 配在一起？

Codex 擅長推理程式碼與內容；但它自己無法產出二進位的投影片檔案。2Slides MCP server 正好補上這個缺口。分工如下：

• Codex 讀取你的原始素材（規格、README、資料檔），規劃投影片，並決定敘事走向。
• 2Slides MCP server 渲染出實際的 PowerPoint —— 主題式的 Fast PPT，或是以圖像設計、可選配 AI 旁白與可匯出素材包的投影片。

你用白話提出需求；Codex 呼叫工具；下載連結就回來了。

你需要先準備什麼

1. 已安裝的 Codex CLI（
   codex
   已在你的 PATH 中）。
2. 一組 2Slides API key，到 2slides.com/api 取得 —— 該頁面也提供 MCP 設定與 Streamable HTTP 端點。
3. Node.js，供 stdio 傳輸使用（它會執行
   npx 2slides-mcp
   ）。HTTP 傳輸不需要任何本機相依套件。

Stdio 還是 Streamable HTTP：該選哪種傳輸方式？

2Slides MCP server 兩種都提供。不論哪種，工具都一樣 —— 差別在連接器在哪裡執行。

工作站上用 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 server 支援的選填欄位包括

、（預設 10 秒）與 （預設 60 秒）。如果你想直接傳遞一個現有的環境變數，而不是把 key 內嵌進來，可用 。

或使用

codex mcp add

捷徑

不必編輯檔案 —— 這會幫你寫好設定區塊：

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

之後的所有內容都是 server 指令。在你安裝的版本上執行 可看到完整的子指令清單。

方法二：在 config.toml 設定 Streamable HTTP

讓 Codex 指向託管端點：

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

如果你偏好用標頭驗證而非查詢字串中的 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 server。較新版本會自動接好這套機制，但某些較舊的建置版本會回報

錯誤，直到你啟用實驗性用戶端為止。若你遇到這個狀況，加上：

[features]
experimental_use_rmcp_client = true

請先檢查

—— 較新的版本已內建這項機制，而這個旗標正被改名為 。只有在你的版本出現抱怨時，才把這段設定當成備案加上去。

驗證連線

codex mcp list      # 列出已設定的 MCP server
codex mcp get 2slides

或者，在 Codex 的 TUI 中執行

，查看作用中的 server 及其工具。（ 的管理子指令仍在演進中；以你的建置版本上的 為準。）

產生你的第一份簡報

你不必手動叫用工具 —— 直接開口請求：

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 server 出現
  missing field command in mcp_servers
  。 你的 Codex 版本需要在
  [features]
  下加上
  experimental_use_rmcp_client = true
  。升級 Codex，或加上這個旗標。
• TOML 的表頭 vs 行內表格。
  [mcp_servers.2slides.env]
  是一個子表格；如果你要行內寫，就在 server 那一行寫
  env = { API_KEY = "..." }
  —— 不要兩種寫法混用。
• server 名稱必須唯一。 每個 server 都以
  [mcp_servers.NAME]
  這一段為鍵；重複使用同一個名稱會覆蓋掉先前的區塊。
• 沒掛工具就生不出
  .pptx
  。 Codex 單獨只能草擬大綱，無法產出 PowerPoint。請先加上 2Slides。
• 大份簡報的工具逾時。 大型或附旁白的工作可能超過預設的 60 秒
  tool_timeout_sec
  ；把它調高，或讓 Codex 對非同步工作輪詢
  jobs_get
  。

常見問題

OpenAI Codex 支援 MCP server 嗎？

支援。Codex 是一個 MCP 用戶端。你可以在

的 下設定 server，或用 新增。stdio 與遠端 HTTP server 都支援。

Codex 把 MCP 設定存在哪裡？

存在

（全域）。受信任的專案也可以使用專案層級的 。每個 MCP server 都是一個 表格。

Stdio 還是 Streamable HTTP？

stdio 會在你的機器上執行

，是本機工作的預設選項。Streamable HTTP 指向託管的 端點，不需要安裝任何東西 —— 最適合 CI 與遠端環境。工具相同，產出相同。

它會產生真正的 PowerPoint 嗎？

會 ——

回傳可編輯的 。Nano Banana 工具回傳以圖像設計的簡報，還能加上 AI 旁白與可匯出的素材包。

key 和設定要去哪裡取得？

到 2slides.com/api?tab=mcp：你的 API key、一份可直接貼上的設定，以及 Streamable HTTP 端點 URL。

重點整理

在

config.toml

加上一個

[mcp_servers.2slides]

區塊（或執行

codex mcp add

），Codex 就獲得一項工具，能把任何簡報需求變成完成的 PowerPoint —— 完全不必離開終端機。

Codex 是強大的推理代理；2Slides 是它原本缺少的檔案生成器。想看更全面的脈絡，請參閱 MCP 如何改變簡報工作流程 以及 PowerPoint MCP server 生態地圖。偏好 Anthropic 的代理？請參閱 如何將 Claude Code 串接 2Slides MCP server。

到 2slides.com/api?tab=mcp 取得你的 key 與精確設定，今天就交出你第一份由 Codex 產生的簡報。

來源：

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