2Slides Logo
用任何 AI 代理串接 2Slides MCP Server:2026 完整指南
2Slides Team
4 min read

用任何 AI 代理串接 2Slides MCP Server:2026 完整指南

快速解答(≤60 字): 2Slides MCP server 讓任何支援 MCP 的 AI 代理都能產生真正的 PowerPoint 檔案。它有兩種執行方式:stdio

npx 2slides-mcp
搭配
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_pages_voices
把頁面 + 音訊匯出成 ZIP免費
jobs_get
輪詢非同步工作直到完成免費

代理負責思考 —— 讀取你的檔案、組織論述、撰寫文案。server 負責產生檔案。你用白話提出需求,大約 30–60 秒後下載連結就回來了。

兩種傳輸方式:stdio vs Streamable HTTP

2Slides MCP server 兩種協定都支援。它們提供完全相同的工具,差別只在連接器在哪裡執行。

Stdio 協定Streamable HTTP 協定
在哪裡執行本機,透過
npx 2slides-mcp
遠端,由 2Slides 託管
本機是否需要 Node.js需要不需要
驗證方式
API_KEY
環境變數
URL 中的
?apikey=
(或
Authorization
標頭)
端點/指令
npx 2slides-mcp
https://2slides.com/api/mcp?apikey=KEY
適用情境本機開發、完全掌控、友善離線CI、容器、遠端主機、輕量用戶端

通用 stdio 設定(多數用戶端接受的格式):

{ "mcpServers": { "2slides": { "command": "npx", "args": ["2slides-mcp"], "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、一份可直接貼上的設定,以及端點。

支援的代理一覽

代理/用戶端設定位置StdioStreamable 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 --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp
    ,遠端則用
    --transport http
    。提供個人 vs 團隊使用的 scope。
  • OpenAI Codex —— 在
    config.toml
    加一個
    [mcp_servers.2slides]
    區塊,或執行
    codex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcp
    。遠端透過一個
    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:

  1. 用它們的模型驅動一個程式設計代理。 兩者都提供與 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 2slides-mcp # MiniMax export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MINIMAX_KEY" claude
  2. 使用它們自己的代理執行環境。 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_pages_voices

常見問題

什麼是 2Slides MCP server?

它是一個 Model Context Protocol 連接器,把 2Slides 的投影片生成、套用主題、旁白與匯出 API 包裝成工具。任何連上它、支援 MCP 的代理都能產生真正、可編輯的 PowerPoint 檔案(以及附 AI 旁白、以圖像設計的簡報)。

Stdio 還是 Streamable HTTP —— 我該用哪種傳輸方式?

在能執行 Node.js(

npx 2slides-mcp
)的機器上用 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