2Slides Logo
如何將 Gemini CLI 串接 2Slides MCP Server(2026 完整指南)
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 旁白與可匯出素材包的投影片。

你需要先準備什麼

  1. 已安裝的 Gemini CLI
    gemini
    已在你的 PATH 中)。
  2. 一組 2Slides API key,到 2slides.com/api 取得。
  3. Node.js,供 stdio 傳輸使用(
    npx 2slides-mcp
    )。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": ["2slides-mcp"], "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 2slides-mcp # 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_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 CodeOpenAI CodexQwen 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