2Slides Team
4 min read
用任何 AI 代理串接 2Slides MCP Server：2026 完整指南
快速解答（≤60 字）： 2Slides MCP server 讓任何支援 MCP 的 AI 代理都能產生真正的 PowerPoint 檔案。它有兩種執行方式：stdio（
npx -y 2slides-mcp@latest搭配API_KEY環境變數）與 Streamable HTTP（https://2slides.com/api/mcp?apikey=KEY）。到 2slides.com/api 取得 key，把 server 加進你的代理 —— Claude Code、Codex、OpenClaw、Gemini CLI、Qwen Code 等等 —— 接著開口要一份簡報即可。
每一款現代 AI 代理都能寫出投影片大綱。但它們之中，沒有一個能憑自己交給你一份真正可編輯、帶主題、圖表、旁白與講者備忘稿的 .pptx。這是檔案生成的工作 —— 而 2Slides MCP server 正是那個通用連接器，讓任何 Model Context Protocol 用戶端都具備這項能力。
設定一次 server，同一套工具就會在你使用的任何代理裡亮起來。本指南會說明兩種傳輸方式、列出支援哪些用戶端，並連結到每一款的逐步設定教學。
什麼是 2Slides MCP server？
它是一個小型連接器，把 2Slides 的投影片生成 API 包裝成 MCP 工具。代理一旦連上，就能呼叫：
| 工具 | 功能 | 點數 |
|---|---|---|
themes_search | 為主題式簡報找出 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 | 輪詢非同步工作直到完成 | 免費 |
代理負責思考 —— 讀取你的檔案、組織論述、撰寫文案。server 負責產生檔案。你用白話提出需求，大約 30–60 秒後下載連結就回來了。
兩種傳輸方式：stdio vs Streamable HTTP
2Slides MCP server 兩種協定都支援。它們提供完全相同的工具，差別只在連接器在哪裡執行。
| Stdio 協定 | Streamable HTTP 協定 | |
|---|---|---|
| 在哪裡執行 | 本機，透過 npx -y 2slides-mcp@latest | 遠端，由 2Slides 託管 |
| 本機是否需要 Node.js | 需要 | 不需要 |
| 驗證方式 | API_KEY 環境變數 | URL 中的 ?apikey=（或 Authorization 標頭） |
| 端點／指令 | npx -y 2slides-mcp@latest | https://2slides.com/api/mcp?apikey=KEY |
| 適用情境 | 本機開發、完全掌控、友善離線 | CI、容器、遠端主機、輕量用戶端 |
通用 stdio 設定（多數用戶端接受的格式）：
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}通用 Streamable HTTP： 讓你的用戶端指向 https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY。（確切的鍵名各有不同 —— Gemini CLI 與 Qwen Code 用 httpUrl；OpenClaw 用 url + transport: "streamable-http"；Claude Code 與 Codex 用 --transport http 旗標或 url 欄位。）
到 2slides.com/api?tab=mcp 取得你的 key、一份可直接貼上的設定，以及端點。
支援的代理一覽
| 代理／用戶端 | 設定位置 | Stdio | Streamable HTTP | 設定教學 |
|---|---|---|---|---|
| Claude Code | .mcp.json / claude mcp add | ✅ | ✅（--transport http） | 指南 → |
| OpenAI Codex | ~/.codex/config.toml | ✅ | ✅（url） | 指南 → |
| OpenClaw | ~/.openclaw/openclaw.json（mcp.servers） | ✅ | ✅（transport: streamable-http） | 指南 → |
| Gemini CLI | ~/.gemini/settings.json | ✅ | ✅（httpUrl） | 指南 → |
| Qwen Code | ~/.qwen/settings.json | ✅ | ✅（httpUrl） | 指南 → |
| Claude Desktop | claude_desktop_config.json | ✅ | — | 指南 → |
| Kimi（Moonshot） | 透過 Kimi CLI 或 Claude Code | ✅ | ✅ | 見下方「Kimi 與 MiniMax」 |
| MiniMax | 透過 Mini-Agent 或 Claude Code | ✅ | ✅ | 見下方「Kimi 與 MiniMax」 |
每一篇連結的指南都附有精確的設定區塊、一行搞定的 ... mcp add 捷徑（若有的話），以及如何驗證連線。
挑選你的代理
- Claude Code —— Anthropic 的 CLI。
claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest，遠端則用--transport http。提供個人 vs 團隊使用的 scope。 - OpenAI Codex —— 在
config.toml加一個[mcp_servers.2slides]區塊，或執行codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest。遠端透過一個url區塊。 - OpenClaw —— 在
openclaw.json的mcp.servers下加一筆設定；用openclaw mcp probe 2slides --json驗證。工具會浮現在coding／messaging設定檔中。 - Gemini CLI —— 在
settings.json設定mcpServers（遠端用httpUrl），或執行gemini mcp add。 - Qwen Code —— 在
~/.qwen/settings.json用相同格式；做中文簡報很強。
Kimi 與 MiniMax：兩條額外的路徑
Kimi（Moonshot）與 MiniMax 都還不算是像上述代理那樣打磨完整的原生 MCP CLI，但兩者都能透過兩條可靠途徑接上 2Slides MCP server：
-
用它們的模型驅動一個程式設計代理。 兩者都提供與 Anthropic 相容的端點，所以你可以讓 Claude Code 跑在它們上面，並透過 Claude Code 自己的 MCP 設定掛上 2Slides：
# Kimi K2 via Moonshot export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_KEY" claude # then: claude mcp add ... 2slides -- npx -y 2slides-mcp@latest # MiniMax export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MINIMAX_KEY" claude -
使用它們自己的代理執行環境。 Moonshot 推出了 Kimi CLI（一個原生 MCP 用戶端，採用標準的
mcpServers／~/.kimi/mcp.json設定），而 MiniMax 發布了開源的 Mini-Agent，它會讀取標準的mcp.json。在這兩者中，加入 2Slides 的方式就跟上面的通用 stdio 或 Streamable HTTP 區塊完全一樣。
不論哪種方式，2Slides 的工具都相同 —— 改變的只是承載的代理。
實作範例（任何代理皆適用）
不論用哪個用戶端，互動方式都一樣。你開口請求：
Read ./Q3-report.md and build a 12-slide executive summary.
Find a clean business theme from 2slides, generate the
PowerPoint, then return the download link.代理會執行 themes_search → slides_generate（Fast PPT）→ 回傳 downloadUrl。想要客製化、以圖像設計、附 AI 配音的投影片？提出需求，代理就會串接 slides_create_pdf_slides → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices。
常見問題
什麼是 2Slides MCP server？
它是一個 Model Context Protocol 連接器，把 2Slides 的投影片生成、套用主題、旁白與匯出 API 包裝成工具。任何連上它、支援 MCP 的代理都能產生真正、可編輯的 PowerPoint 檔案（以及附 AI 旁白、以圖像設計的簡報）。
Stdio 還是 Streamable HTTP —— 我該用哪種傳輸方式？
在能執行 Node.js（npx -y 2slides-mcp@latest）的機器上用 stdio —— 這是本機工作的預設選項。當你的代理跑在 CI、容器，或什麼都沒安裝的遠端主機時，用 Streamable HTTP（https://2slides.com/api/mcp?apikey=KEY）。兩者提供完全相同的工具。
哪些 AI 代理可以用它？
任何 MCP 用戶端。本指南直接涵蓋 Claude Code、OpenAI Codex、OpenClaw、Gemini CLI、Qwen Code 與 Claude Desktop，外加透過 Claude Code 或自家代理執行環境的 Kimi 與 MiniMax。Cursor、Windsurf 等其他 MCP 用戶端則使用相同的通用設定。
每個代理都要用不同的 API key 嗎？
不用。一組 2Slides API key 適用於每個用戶端與兩種傳輸方式。在 2slides.com/api?tab=mcp 建立一次即可。
它會產生真正的 PowerPoint 檔案嗎？
會。slides_generate 回傳一份帶有真實圖形與主題、可編輯的 .pptx。Nano Banana 工具回傳以圖像設計的簡報，還能加上 AI 語音旁白與可匯出、供做影片用的素材包。
這個 MCP server 是免費的嗎？
連接器本身可免費安裝，而 themes_search／jobs_get／匯出呼叫都免費。投影片生成會消耗 2Slides 點數 —— Fast PPT 每頁 10 點，圖像式與附旁白的簡報則更多。
重點整理
設定 2Slides MCP server 一次 —— 本機用 stdio、遠端用 Streamable HTTP —— 你使用的每一個 MCP 代理就都獲得一條一句話直達完成 PowerPoint 的路徑。代理負責思考；2Slides 負責產生檔案。
2026 年的轉變在於：「幫我做一份簡報」不再是聊天小把戲 —— 它是你的代理代你執行的一次工具呼叫，回傳的是一份真正的檔案。在下方挑選你的用戶端，你還沒讀完它的設定教學，第一份簡報就已經到手：
想看更多脈絡，請參閱 PowerPoint MCP server 生態地圖 以及 如何打造一個 AI 簡報代理。
到 2slides.com/api?tab=mcp 取得你的 API key、可直接貼上的設定，以及 Streamable HTTP 端點 —— 一個 server，串接所有代理。
來源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
