2Slides Team
4 min read
如何將 Gemini CLI 串接 2Slides MCP Server（2026 完整指南）
快速解答（≤60 字）： Google 的 Gemini CLI 能透過 2Slides MCP server 產生真正的 PowerPoint 檔案。先到 2slides.com/api 取得 key，再到
~/.gemini/settings.json加一筆mcpServers設定 —— stdio 用command: "npx"、args: ["2slides-mcp"]、env.API_KEY，Streamable HTTP 用httpUrl: "https://2slides.com/api/mcp?apikey=KEY"。或執行gemini mcp add。接著請 Gemini 做一份簡報即可。
Gemini CLI 是 Google 開源、以終端機為基礎的 AI 代理，並支援 Model Context Protocol（MCP）。把它連上 2Slides MCP server，Gemini 就能把一段提示詞 —— 或你工作目錄裡的一個檔案 —— 變成完成、可編輯的 .pptx。
本指南提供兩種傳輸方式的精確 settings.json 設定區塊（本機 stdio 與遠端 Streamable HTTP）、gemini mcp add 捷徑，以及各個 2Slides 工具的用途。
為什麼要把 Gemini CLI 連上 2Slides？
Gemini 是強大的多模態推理器，但它自己無法產出二進位的 .pptx 檔案。2Slides MCP server 正是那個專屬生成器：
- Gemini CLI 讀取你的原始素材、規劃投影片、撰寫文案。
- 2Slides MCP server 渲染出真正的 PowerPoint —— 主題式的 Fast PPT，或是以圖像設計、可選配 AI 旁白與可匯出素材包的投影片。
你需要先準備什麼
- 已安裝的 Gemini CLI（
gemini已在你的 PATH 中）。 - 一組 2Slides API key，到 2slides.com/api 取得。
- Node.js，供 stdio 傳輸使用（
npx -y 2slides-mcp@latest）。HTTP 傳輸不需要任何本機相依套件。
Stdio 還是 Streamable HTTP：該選哪種傳輸方式？
兩者提供相同的工具；差別在於設定鍵以及連接器在哪裡執行。
| Stdio（本機） | Streamable HTTP（遠端） | |
|---|---|---|
| 設定鍵 | command / args / env | httpUrl |
| 本機 Node.js | 必要 | 不必要 |
| 適用情境 | 本機開發 | 遠端／CI、輕量設定 |
鍵名很重要： Gemini CLI 對 Streamable HTTP 使用
httpUrl，對舊版 SSE 使用url。要連 2Slides 的 Streamable HTTP 端點，請用httpUrl。
方法一：在 settings.json 設定 stdio
Gemini CLI 會讀取 ~/.gemini/settings.json（全域）與 .gemini/settings.json（專案）。加上一個 mcpServers 區塊：
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}如果你不想把 key 內嵌進去，env 值也可以參照 shell 變數（例如 "API_KEY": "$TWOSLIDES_API_KEY"）。
方法二：在 settings.json 設定 Streamable HTTP
對於託管端點，使用 httpUrl：
{
"mcpServers": {
"2slides-remote": {
"httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}偏好用標頭驗證？加上一個 headers 物件："headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }。
或使用 gemini mcp add 指令
# stdio (-e sets env vars)
gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest
# Streamable HTTP
gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"這些指令會把相同的 mcpServers 設定寫進 settings.json。可用旗標包括 -t, --transport（stdio | sse | http）、-e, --env、-H, --header 與 --timeout。
驗證連線
在互動式 gemini 工作階段中執行：
/mcp它會顯示每個 server 的狀態（CONNECTED / CONNECTING / DISCONNECTED）以及探測到的工具。若遠端 server 需要 OAuth，請使用 /mcp auth。
產生你的第一份簡報
直接開口請求：
Read ./notes/market-update.md and generate a 9-slide briefing.
Find a professional theme from 2slides, build the PowerPoint,
and give me the download link.Gemini CLI 會執行 themes_search → slides_generate（Fast PPT）→ 回傳 downloadUrl。對於客製化的圖像式投影片，它會使用 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 | 輪詢非同步工作直到完成 | 免費 |
常見錯誤與疑難排解
- 對 Streamable HTTP 端點用了
url。 Gemini CLI 會把url當成 SSE。2Slides 的 Streamable HTTP 請用httpUrl。 - server 在
/mcp顯示 DISCONNECTED。 檢查 API key，stdio 的情況請確認已安裝 Node.js。 - 沒列出任何工具。 編輯
settings.json後重啟工作階段，或重新執行gemini mcp add。 - 沒掛工具就生不出
.pptx。 Gemini 單獨只能草擬大綱；2Slides 才負責產出檔案。 - 輪詢太頻繁。 對非同步的 Nano Banana／旁白工作，讓 Gemini 每隔約 20 秒輪詢一次
jobs_get。
常見問題
Gemini CLI 支援 MCP server 嗎？
支援。Gemini CLI 是一個 MCP 用戶端。在 ~/.gemini/settings.json 的 mcpServers 下設定 server，或用 gemini mcp add 新增。stdio、SSE 與 Streamable HTTP 傳輸全部支援。
Streamable HTTP server 的設定鍵是什麼？
httpUrl。url 只用於舊版 SSE server。2Slides 的 Streamable HTTP 端點要放進 httpUrl。
Gemini CLI 把 MCP 設定存在哪裡？
~/.gemini/settings.json（全域）或 .gemini/settings.json（專案）。MCP 設定區塊是頂層的 mcpServers 鍵。
它會產生真正的 PowerPoint 嗎？
會 —— slides_generate 回傳可編輯的 .pptx。Nano Banana 工具回傳以圖像設計的簡報，並可選配 AI 旁白。
key 和設定要去哪裡取得？
到 2slides.com/api?tab=mcp：你的 key、一份可直接貼上的設定，以及 Streamable HTTP 端點 URL。
重點整理
一筆
mcpServers設定 —— 本機用command、遠端用httpUrl—— 就能把 Gemini CLI 變成投影片生成器。用/mcp驗證，接著直接開口要一份簡報。
想看更廣的全貌，請參閱 MCP 如何改變簡報工作流程 以及 PowerPoint MCP server 生態地圖。在用另一款終端機代理？請參閱用同一個 server 的 Claude Code、OpenAI Codex 與 Qwen Code。
到 2slides.com/api?tab=mcp 取得你的 key 與設定，一分鐘內就能從 Gemini CLI 產生第一份簡報。
來源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
