2Slides Team
4 min read
如何將 Qwen Code 串接 2Slides MCP Server（2026 完整指南）
快速解答（≤60 字）： 阿里巴巴的 Qwen Code CLI 能透過 2Slides MCP server 產生真正的 PowerPoint 檔案。先到 2slides.com/api 取得 key，再到
~/.qwen/settings.json加一筆mcpServers設定 —— stdio 用command: "npx"、args: ["2slides-mcp"]、env.API_KEY，Streamable HTTP 用httpUrl: "https://2slides.com/api/mcp?apikey=KEY"。或執行qwen mcp add。接著請 Qwen 做一份簡報即可。
Qwen Code 是阿里巴巴開源、以終端機為基礎的程式設計代理（fork 自 Gemini CLI），針對 Qwen 模型家族調校。它是原生的 Model Context Protocol（MCP）用戶端，所以接上 2Slides MCP server 後，Qwen Code 就能把一份簡報需求 —— 或你儲存庫裡的一個檔案 —— 變成完成、可編輯的 .pptx。
本指南提供兩種傳輸方式的精確 ~/.qwen/settings.json 設定區塊（本機 stdio 與遠端 Streamable HTTP）、qwen mcp add 捷徑，以及 2Slides 的工具總覽。
為什麼要把 Qwen Code 連上 2Slides？
Qwen Code 擅長推理程式碼與內容，但不負責產出二進位的投影片檔案。2Slides MCP server 正是那個負責生成的工具：
- Qwen Code 讀取你的原始素材、規劃簡報、撰寫文案 —— 中英文內容都很在行。
- 2Slides MCP server 渲染出真正的 PowerPoint —— 主題式的 Fast PPT，或是以圖像設計、可選配 AI 旁白與可匯出素材包的投影片。
2Slides 支援 20 種輸出語言，包含簡體與繁體中文，因此由 Qwen 規劃的中文簡報，渲染時能正確處理 CJK 斷行。
你需要先準備什麼
- 已安裝的 Qwen Code（
qwen已在你的 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、輕量設定 |
鍵名很重要： Qwen Code（與 Gemini CLI 相同）對 Streamable HTTP 使用
httpUrl，對舊版 SSE 使用url。2Slides 的 Streamable HTTP 端點請用httpUrl。
方法一：在 settings.json 設定 stdio
Qwen Code 會讀取 ~/.qwen/settings.json（全域）與 .qwen/settings.json（專案）。加上一個 mcpServers 區塊：
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}如果你想把 key 留在 shell 環境裡，env 值支援 $VAR_NAME 展開。
方法二：在 settings.json 設定 Streamable HTTP
對於託管端點，使用 httpUrl：
{
"mcpServers": {
"2slides-remote": {
"httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}選填的標頭驗證："headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }。
或使用 qwen mcp add 指令
# stdio
qwen mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest
# Streamable HTTP
qwen mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"相關指令：qwen mcp list、qwen mcp remove <name>，以及單獨執行 qwen mcp 進入互動式管理介面。
驗證連線
在互動式 qwen 工作階段中：
/mcp它會顯示每個 server 的連線狀態、設定細節，以及探測到的工具。對於受 OAuth 保護的 server，請使用 /mcp auth。
產生你的第一份簡報
直接開口請求 —— 用英文或中文都可以：
读取 ./季度总结.md，生成一个 10 页的季度业务回顾。
先从 2slides 搜索一个简洁的商务主题，再生成 PowerPoint，
最后把下载链接给我。Qwen Code 會執行 themes_search → slides_generate（Fast PPT，帶 responseLanguage: "Simplified Chinese"）→ 回傳 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。 Qwen Code 會把url當成 SSE。2Slides 的 Streamable HTTP 端點請用httpUrl。 - server 在
/mcp顯示 DISCONNECTED。 確認 API key；stdio 的情況請確認 Node.js 存在。 - 編輯後工具不見了。 重啟工作階段，或重新執行
qwen mcp add。 - 期待 Qwen 單獨產出
.pptx。 它負責規劃簡報；2Slides 才負責渲染檔案。 - 輸出語言錯誤。 明確設定簡報語言，CJK 內容才能正確渲染（Qwen 會把
responseLanguage傳給slides_generate）。
常見問題
Qwen Code 支援 MCP server 嗎？
支援。Qwen Code 是一個 MCP 用戶端（fork 自 Gemini CLI）。在 ~/.qwen/settings.json 的 mcpServers 下設定 server，或用 qwen mcp add 新增。stdio 與 Streamable HTTP 都支援。
Streamable HTTP server 的設定鍵是什麼？
httpUrl。url 只用於舊版 SSE。2Slides 的 Streamable HTTP 端點要放進 httpUrl。
Qwen Code 適合做中文簡報嗎？
適合 —— Qwen 模型的中文涵蓋度很強，而 2Slides 支援簡體與繁體中文輸出，並具備正確的 CJK 渲染。這個組合很適合中英雙語與中文商務簡報。
它會產生真正的 PowerPoint 嗎？
會 —— slides_generate 回傳可編輯的 .pptx。Nano Banana 工具回傳以圖像設計的簡報，並可選配 AI 旁白。
key 和設定要去哪裡取得？
到 2slides.com/api?tab=mcp：你的 key、一份可直接貼上的設定，以及 Streamable HTTP 端點。
重點整理
一筆
mcpServers設定 —— 本機用command、遠端用httpUrl—— 就能把 Qwen Code 變成投影片生成器，中英文都行。用/mcp驗證，接著直接開口請求。
想看更廣的全貌，請參閱 MCP 如何改變簡報工作流程 以及 PowerPoint MCP server 生態地圖。在用另一款代理？請參閱用同一個 server 的 Gemini CLI、Claude Code 與 OpenAI Codex。
到 2slides.com/api?tab=mcp 取得你的 key 與設定，今天就產生你第一份由 Qwen 建立的簡報。
來源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
