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

Q: Claude Code 原生支援 MCP server 嗎？

支援。Claude Code 是一等公民的 MCP 用戶端。你用 claude mcp add 新增 server（stdio、SSE 或 HTTP 傳輸），用 claude mcp list 列出它們，並在工作階段中用 /mcp 檢視。2Slides server 全部都支援。

Q: Stdio 還是 Streamable HTTP —— 我該用哪個？

在你的本機用 stdio（它會幫你執行 npx -y 2slides-mcp@latest），在任何你無法或不想安裝 Node 的地方用 Streamable HTTP —— CI、容器、遠端伺服器。兩者提供相同的工具，產出也完全一致。

Q: 這真的會產生真正的 PowerPoint 檔案嗎？

會。Fast PPT 路徑（slides_generate）回傳一份帶有真實圖形與主題、可編輯的 .pptx。Nano Banana 路徑回傳以圖像設計的簡報，還能加上 AI 語音旁白與可匯出的素材。這些都是你可以開啟、編輯、上台報告的檔案 —— 不是截圖。

Q: 我可以把 2Slides server 分享給團隊嗎？

可以。用 --scope project 新增，會寫出一份共用的 .mcp.json，你可以提交進儲存庫。隊友首次使用時會被提示核准。若要私人、跨所有專案的設定，請用 --scope user。

快速解答（≤60 字）： Claude Code 只要連上 2Slides MCP server，就能產生真正的 PowerPoint 檔案。先到 2slides.com/api 取得 API key，本機 stdio 執行 claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest，或遠端 Streamable HTTP 執行 claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY，接著直接請 Claude Code 做一份簡報即可。

Claude Code 是 Anthropic 推出、以終端機為基礎的程式設計代理，原生支援 Model Context Protocol（MCP）。這代表你可以給它一項工具，把文字直接轉成完成的 .pptx 檔案，全程不必離開 shell。2Slides MCP server 就是這項工具：一個輕量連接器，把 2Slides 的投影片生成、套用主題、旁白與匯出 API 包裝成 Claude Code 可以直接呼叫的 MCP 工具。

本指南會示範兩種連接方式 —— 本機 stdio 與遠端 Streamable HTTP —— 該怎麼選、各個工具的用途，以及把一句話請求變成可下載 PowerPoint 的精確提示詞。

到底為什麼要把 Claude Code 連上 2Slides？

Claude Code 很擅長推理你的程式庫、草擬內容、組織論述結構。但它自己做不到的，是產出一份真正可編輯、帶有圖形、圖表、主題與講者備忘稿的 .pptx。這是檔案生成的問題，應該交給專屬工具處理。

分工很清楚：

Claude Code 讀取你的原始素材（一份 README、一份規格、一個 CSV、一則研究筆記），對它進行推理，決定每一頁投影片該放什麼。
2Slides MCP server 拿到這份規劃後，渲染出實際的 PowerPoint 檔案 —— 或是搭配 AI 語音旁白與 MP4 匯出的圖像式投影片。

整個過程你都待在終端機裡。提出請求、等大約 30–60 秒，就拿到下載連結。

你需要先準備什麼

已安裝並完成驗證的 Claude Code（claude 已在你的 PATH 中）。
一組 2Slides API key。 到 2slides.com/api 建立。同一個頁面也提供可直接複製貼上的 MCP 設定與 Streamable HTTP 端點。
Node.js（供 stdio 傳輸使用，會在本機執行 npx -y 2slides-mcp@latest）。HTTP 傳輸完全不需要任何本機相依套件。

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

2Slides MCP server 支援兩種傳輸方式。兩者提供的工具集完全相同，差別只在連接器在哪裡執行。

	Stdio 協定	Streamable HTTP 協定
在哪裡執行	本機，透過 `npx -y 2slides-mcp@latest`	遠端，由 2Slides 託管
本機是否需要 Node.js	需要	不需要
設定方式	新增 stdio server + `API_KEY` 環境變數	新增一個帶 `?apikey=` 的 URL
適用情境	本機開發、友善離線、完全掌控	容器、CI、輕量用戶端、零本機相依
驗證方式	`API_KEY` 環境變數	URL 查詢字串中的 API key（或 `Authorization` 標頭）

經驗法則： 日常工作在自己的機器上用 stdio；當 Claude Code 跑在你無法安裝 Node 的地方（遠端主機、CI 工作、受限制的容器）時用 Streamable HTTP。

方法一：透過 stdio 連接（本機）

執行這一行一次即可。-- 分隔符會把 Claude Code 自己的旗標跟它要啟動的指令分開：

claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest

有幾件事值得知道：

把 --transport stdio（或其他旗標）放在 --env 與 server 名稱之間。因為 --env 接受多組 KEY=value，若把名稱直接接在它後面，CLI 可能會把名稱當成另一個環境變數讀取。
-- 之後的所有內容都會原封不動傳給 server（npx -y 2slides-mcp@latest）。
加上 --scope user 讓 2Slides 在每個專案都可用，或加上 --scope project 把它寫進共用的 .mcp.json，供你的團隊使用。

產生出來的 .mcp.json（專案範圍）長這樣 —— 你也可以手動編輯：

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": ["-y", "2slides-mcp@latest"],
      "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
    }
  }
}

方法二：透過 Streamable HTTP 連接（遠端）

不需要任何本機安裝 —— 直接讓 Claude Code 指向託管端點：

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY

想把 key 留在 URL 之外？改用標頭傳送：

claude mcp add --transport http 2slides https://2slides.com/api/mcp \
  --header "Authorization: Bearer YOUR_2SLIDES_API_KEY"

驗證連線

claude mcp list          # 2slides 應該會出現並成功連線
claude mcp get 2slides   # 顯示其設定與探測到的工具

或者，在互動式工作階段中執行 /mcp 斜線指令，查看已連線的 server、工具數量，以及（對遠端 server 而言）驗證狀態。

產生你的第一份簡報

連線之後，你不必手動呼叫工具 —— 直接開口請求即可。Claude Code 會自動串接 2Slides 的工具：

Search the 2slides themes for a clean "business" style, then
generate a 7-slide deck introducing our Q3 roadmap. Pull the
content from ./ROADMAP.md. Return the download link.

幕後，Claude Code 會執行 themes_search 找出 themeId，接著執行 slides_generate（Fast PPT），並把 downloadUrl 交給你。總耗時：套用主題的 PowerPoint 大約 30–60 秒。

想要客製化、以圖像設計的投影片，而不是套模板？提出這個需求，Claude Code 就會走 Nano Banana 路徑（slides_create_pdf_slides），輪詢 jobs_get 直到完成，再回傳連結。

2Slides MCP 工具總覽

連線之後，Claude Code 會看到以下這些工具：

工具	功能	點數
`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`	輪詢非同步工作直到 `success`	免費

三種典型的工具串接：

Fast PPT： themes_search → slides_generate（同步）→ 下載。
Nano Banana： slides_create_pdf_slides（非同步）→ jobs_get → 下載。
附旁白的影片素材： 建立投影片 → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices。

常見錯誤與疑難排解

claude mcp list 中找不到 server。 若使用 stdio，請檢查 --env／名稱的順序是否正確（在 --env 與名稱之間保留一個旗標）。若使用 HTTP，請重新確認 URL 以及 API key 是否有效。
缺少 API_KEY。 stdio server 需要環境變數；HTTP server 需要 ?apikey= 或 Authorization 標頭。別搞混了。
沒掛工具就要求產生 .pptx。 沒連上 2Slides 時，Claude Code 能寫出大綱，但無法產出真正的 PowerPoint。請先連上 server。
忘了指定主題。 如果你沒執行 themes_search 或指名某種風格，Fast PPT 會自動幫你挑一個。要掌控外觀就明確指定。
輪詢太頻繁。 非同步工作（Nano Banana、旁白）應每隔約 20 秒用 jobs_get 輪詢一次，不要塞在緊密迴圈裡狂打。

常見問題

Claude Code 原生支援 MCP server 嗎？

支援。Claude Code 是一等公民的 MCP 用戶端。你用 claude mcp add 新增 server（stdio、SSE 或 HTTP 傳輸），用 claude mcp list 列出它們，並在工作階段中用 /mcp 檢視。2Slides server 全部都支援。

Stdio 還是 Streamable HTTP —— 我該用哪個？

在你的本機用 stdio（它會幫你執行 npx -y 2slides-mcp@latest），在任何你無法或不想安裝 Node 的地方用 Streamable HTTP —— CI、容器、遠端伺服器。兩者提供相同的工具，產出也完全一致。

這真的會產生真正的 PowerPoint 檔案嗎？

會。Fast PPT 路徑（slides_generate）回傳一份帶有真實圖形與主題、可編輯的 .pptx。Nano Banana 路徑回傳以圖像設計的簡報，還能加上 AI 語音旁白與可匯出的素材。這些都是你可以開啟、編輯、上台報告的檔案 —— 不是截圖。

API key 和設定要去哪裡取得？

到 2slides.com/api?tab=mcp。該頁面會顯示你的 key、一份可直接貼上的 stdio 設定，以及 Streamable HTTP 端點 URL。

我可以把 2Slides server 分享給團隊嗎？

可以。用 --scope project 新增，會寫出一份共用的 .mcp.json，你可以提交進儲存庫。隊友首次使用時會被提示核准。若要私人、跨所有專案的設定，請用 --scope user。

重點整理

Claude Code 負責思考；2Slides MCP server 負責產生檔案。連接一次 —— 本機用 stdio、遠端用 Streamable HTTP —— 「幫我做一份簡報」就成了你在終端機裡的一句話。

如果你長住在 Claude Code 裡，這是從一個想法（或你儲存庫裡的一個檔案）走到完成、可編輯 PowerPoint 的最快路徑。想更全面了解如何把投影片接進代理，請參閱 MCP 如何改變簡報工作流程以及完整的 PowerPoint MCP server 生態地圖。用桌面版而不是 CLI？請參閱如何用 Claude MCP 產生簡報。

到 2slides.com/api?tab=mcp 取得你的 key 與設定，一分鐘內就能從終端機產生第一份簡報。

來源：