如何將 QoderWake 與 2Slides 結合使用：AI 員工的 MCP 應用（2026）

Q: QoderWake 是否支援自訂 MCP 伺服器？

是的。每個 Waker 都可以透過 stdio、HTTP 或 SSE 掛載多個 MCP 伺服器，使用 qoderwake mcp add --waker-id 指令或控制台中的「自訂 MCP 連接器」畫面即可設定。

Q: 將 2Slides 加入 Waker 的精確指令為何？

qoderwake mcp add --waker-id agxxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR2SLIDESAPIKEY"。由於值當中包含空格，請務必將整個標頭鍵值對加上引號。

Q: 我應該將 2Slides API 金鑰儲存在 QoderWake 的哪裡？

請存放在 MCP 連接器的標頭（--header 或 --headers）中，或是 stdio 的 --env 裡。絕對不要放入任務、記憶、知識庫或角色檔案中，QoderWake 的文件已明確禁止此行為。

Q: Waker 可以每週自動製作簡報嗎？

可以。請使用 qoderwake automation create schedule 搭配 Cron 表達式建立排程自動化。在正式自動執行前，請先以 automation run-now 進行測試。

快速回答（60 字以內）： 先透過 qoderwake waker list --json 找到您的 Waker ID，接著執行 qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"。該 Waker 即可根據需求，從釘釘或飛書搜尋 2Slides 主題，或按排程產出可編輯的 .pptx。

來自阿里巴巴 Qoder 團隊的 QoderWake，將其產品定義為「在職的自主 AI 員工」。每個數位員工被稱為一個 Waker。Waker 可由即時通訊訊息、排程、Hook 事件或 API 呼叫觸發，並獨立完成工作。QoderWake 支援 macOS 13+、Linux 及 Windows 10+。它提供位於 127.0.0.1:19820 的本地網頁控制台與完整的 CLI 工具，並能連結釘釘與飛書。

MCP 伺服器與技能是按 Waker 進行掛載的。本指南將展示如何為特定的 Waker（例如您的「報告助理」）串接 2Slides 簡報引擎。本指南參考了官方 QoderWake CLI 說明文件，並使用我們在 2026 年 9 月 30 日於正式環境實測過的 2Slides 端點。

為什麼要為 Waker 串接 2Slides？

Waker 專為重複性工作而生，而「將本週數據轉化為簡報」正是這類工作的典型範例。
2Slides 負責產出檔案：包含基於範本且可編輯的 PowerPoint（Fast PPT，每頁 10 積分），或具備圖片設計感的投影片（Nano Banana，1K/2K 解析度每頁 100 積分），並可選配 AI 旁白。
按 Waker 劃分權限：這意味著只有需要製作簡報的 Waker 才會取得該工具與金鑰。

事前準備

安裝並登入 QoderWake。 在 macOS 或 Linux 上，CLI 說明文件提供了一行安裝指令：

curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
qoderwake login
qoderwake start      # daemon on 127.0.0.1:19820

Windows 與 macOS 安裝包可從 QoderWake 官網取得。如果終端機找不到 qoderwake，請改用 ~/.qoderwake/bin/qoderwake。

取得 2Slides API 金鑰：請至 2slides.com/api (sk-2slides-...) 取得。新帳號可獲得 500 免費積分，足以製作 50 頁 Fast PPT。
安裝 Node.js：僅在使用 stdio 模式時需要安裝於裝置上。

步驟 1：尋找 Waker ID

qoderwake waker list --json

Waker ID 以 ag_ 開頭。請複製該 ID 以供後續為特定 Waker 製作簡報。以下範例將使用 ag_xxx。

方法 1：透過 HTTP 使用託管型 MCP（推薦）

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --description "2Slides presentation generator" \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"

關於引號的說明： CLI 的語法為 --header KEY=VALUE（可重複）。此處的值 Bearer YOUR_2SLIDES_API_KEY 包含空格，因此請如範例所示，將整個 KEY=VALUE 配對用雙引號包起來。若不加引號，終端機會將其拆分為兩個參數，導致標頭（Header）僅接收到 Bearer。

想完全避免 = 和空格解析的問題嗎？請使用同一個選項的 JSON 格式 --headers <json>：

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --headers '{"Authorization":"Bearer YOUR_2SLIDES_API_KEY"}'

在 Windows PowerShell 中，單引號也有效，但在不同終端機間處理 JSON 引號可能較為繁瑣。在這種情況下，方法 2 中的檔案匯入方式會是更保險的選擇。

無標頭備案： 如果標頭仍無法傳遞（重新整理工具時出現 401 或 Authentication required），請完全跳過標頭設定。2Slides 也接受將金鑰作為 URL 查詢參數，我們已針對此形式完成端到端測試：

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

請將此 URL 視同密碼妥善保管：切勿將其貼入任務說明或螢幕截圖中；若發生外洩，請立即在 2slides.com/api 重置金鑰。

2Slides 使用簡單的 API 金鑰而非 OAuth，因此請關閉所有 --oauth-* 旗標。

方法 2：匯入 MCP JSON 檔案

qoderwake mcp add 也支援透過 --json <json> 或 --json-file <path> 直接匯入 MCP JSON。請將以下內容儲存為 2slides-mcp.json：

{
  "mcpServers": {
    "2slides": {
      "type": "streamable-http",
      "url": "https://2slides.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

qoderwake mcp add --waker-id ag_xxx --json-file 2slides-mcp.json

CLI 說明文件並未詳細說明匯入器接受的 JSON 結構。上述區塊採用的是常見的 mcpServers 格式。如果匯入失敗，請改用方法 1 中已有完整說明的旗標設定。匯入完成後請刪除該檔案，或確保其不被納入 Git 儲存庫，因為其中包含您的金鑰。

方法 3：本地 stdio 伺服器

若要在 Waker 所在的裝置上執行開源的 2slides-mcp 套件：

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport stdio \
  --command npx \
  --args "-y,2slides-mcp@latest" \
  --env '{"API_KEY":"YOUR_2SLIDES_API_KEY"}'

--args 接受以逗號分隔的列表，格式與 CLI 說明文件中的官方檔案系統範例一致。--env 則接受 JSON。此方法需要在執行 Waker 的機器上安裝 Node.js，而 QoderWake 預設是駐留在裝置上的。

驗證連線

qoderwake mcp list --waker-id ag_xxx                      # 2slides should be listed
qoderwake mcp refresh-tools --waker-id ag_xxx --mcp-id <mid>
qoderwake mcp get --waker-id ag_xxx --mcp-id <mid>        # inspect the entry

從 mcp list 取得 <mid>。接著向 Waker 發送一個唯讀測試指令。根據 QoderWake 的官方指引，驗證新連接器的最佳做法是先進行唯讀呼叫：

List the tools you have from 2slides, then search for a "minimal" theme and show me the themeId.

themes_search 是免費功能，因此此測試不會消耗任何積分。如果連接器運作異常，可使用 qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false 將其關閉而不必刪除。

方法 4：上傳 2Slides 技能（Skill）

QoderWake 的技能是具備 Git 版本控制的功能包，您可以進行差異比對（diff）或版本還原。上傳方式為「包含 SKILL.md 的 Markdown 檔案或壓縮檔」。官方的 2Slides 技能位於 github.com/2slides/slides-generation-2slides-skills。請將其壓縮，並確保 SKILL.md 位於壓縮檔的根目錄：

git clone https://github.com/2slides/slides-generation-2slides-skills
cd slides-generation-2slides-skills
zip -r ../2slides-skill.zip SKILL.md scripts references
cd ..
qoderwake skill upload 2slides-skill.zip --waker-id ag_xxx

這樣做會排除儲存庫中較舊的 .skill 組合包。該技能的 Python 腳本（Python 3 與 requests）會從環境變數 SLIDES_2SLIDES_API_KEY 中讀取金鑰。

金鑰安全規則。 QoderWake 的文件指出：「切勿將秘密（secrets）、權杖（tokens）或 Cookie 放入任務、記憶、知識庫、角色檔案或螢幕截圖中。」憑證應存放於受保護的欄位或環境變數中。因此，絕對不要將金鑰貼入任務提示詞，或要求 Waker「記住」它。由於 QoderWake 尚未說明如何將環境變數傳遞給技能腳本，我們建議採取以下分工：

使用 MCP 連接器（方法 1） 進行實際的 API 呼叫。金鑰會存放在其標頭（header）中。
僅在執行 Waker 的環境中已設定 SLIDES_2SLIDES_API_KEY 變數時，才使用技能。請執行 scripts/search_themes.py --query minimal --limit 1 的測試任務來確認。

產生您的第一份簡報

Read sales_week39.csv in the project, summarize the key movements,
and build an 8-slide weekly sales review with 2slides. Search for a
clean business theme first, then generate the PowerPoint and send
me the download link.

Waker 應會依序呼叫 themes_search 與 slides_generate，並回傳一個 downloadUrl。在我們的正式環境測試中，一份 3 頁的 Fast PPT 簡報約在 22 秒內完成。連結將在 1 小時後失效。 QoderWake 文件提到，檔案傳遞「取決於管道功能。請使用回傳的連結或任務產出物（artifact）」。因此，請讓 Waker 立即發佈連結，或將 .pptx 下載至其工作區。之後您可以使用 qoderwake session artifacts --session-id sess_xxx 從工作階段中取得檔案。

AI 員工的應用情境

從釘釘（DingTalk）或飛書（Feishu）觸發。 當 Waker 與釘釘或飛書頻道配對後，團隊成員可以傳送訊息：「@報告助手製作一份 6 頁的第四季招募計畫更新簡報」。Waker 會收集背景資訊，呼叫 2Slides 並回傳連結。

定期的每週簡報。 CLI 參考文件說明了排程自動化的設定方式：

qoderwake automation create schedule --waker-id ag_xxx \
  --name "Weekly Sales Deck" \
  --schedule-type cron --cron "0 9 * * 1" \
  --timezone Asia/Shanghai \
  --prompt "Build this week's 8-slide sales review from the latest CSV with 2slides and post the download link"
qoderwake automation run-now --waker-id ag_xxx --automation-id tr_xxx   # test once

在讓它自動執行之前，請先使用 run-now 執行一次，並透過 qoderwake automation detail 檢查結果。

2Slides MCP 工具列表

工具	功能說明	積分消耗
`themes_search`	在 1,500 多個範本中尋找 `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`	輪詢非同步任務狀態（每 20 至 30 秒一次）	免費

已確認與尚未說明之事項（截至 2026 年 9 月 30 日）

項目	狀態
`waker list`, `mcp add` 旗標 (`--transport`, `--http-url`, `--header`, `--headers`, `--json`, `--command`, `--args`, `--env`), `skill upload`	已在 QoderWake CLI 參考文件中確認
MCP 與技能綁定於個別 Waker；秘密資訊不得進入任務或記憶	已在 QoderWake 文件中確認
2Slides 端點、Bearer 認證、7 項工具	已由 2Slides 完成實測
`mcp add --json` 接受的精確 JSON 格式	尚未說明；目前以 `mcpServers` 格式作為最佳實踐
`--header` 如何分割包含 `=` 的值	尚未說明；建議將整個鍵值對加上引號或使用 `--headers` JSON
如何將環境變數傳遞給技能腳本	尚未說明

疑難排解

「daemon unreachable」（守護行程無法連線）： 執行 qoderwake status。若守護行程未執行，請使用 qoderwake start。若連接埠被佔用，請使用 qoderwake start --port auto。
來自 QoderWake 本身的 401 錯誤： 執行 qoderwake whoami，必要時再次執行 qoderwake login。
來自 2Slides 的 401 錯誤： 標頭可能未包含金鑰。請使用帶引號的 --header 或 --headers JSON 格式重新加入。
找不到工具： 執行 qoderwake mcp refresh-tools，並透過 mcp toggle ... --enabled true 確認連接器已啟用。
stdio 失敗： 檢查 Waker 的裝置是否已安裝 Node.js，並確認 --args 是以逗號分隔。
執行過程出錯： 檢視 qoderwake log --level error --limit 100 或 qoderwake trace list --status failed。
連結失效： downloadUrl 僅維持 1 小時有效。請要求 Waker 將檔案儲存為任務產出物（artifact）。

常見問題

QoderWake 是否支援自訂 MCP 伺服器？

是的。每個 Waker 都可以透過 stdio、HTTP 或 SSE 掛載多個 MCP 伺服器，使用 qoderwake mcp add --waker-id <id> 指令或控制台中的「自訂 MCP 連接器」畫面即可設定。

將 2Slides 加入 Waker 的精確指令為何？

qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"。由於值當中包含空格，請務必將整個標頭鍵值對加上引號。

我應該將 2Slides API 金鑰儲存在 QoderWake 的哪裡？

請存放在 MCP 連接器的標頭（--header 或 --headers）中，或是 stdio 的 --env 裡。絕對不要放入任務、記憶、知識庫或角色檔案中，QoderWake 的文件已明確禁止此行為。

Waker 可以將 PowerPoint 傳送到釘釘或飛書嗎？

Waker 隨時可以回傳 2Slides 的下載連結。至於是否能以檔案附件形式傳送，則取決於通訊管道的功能。根據 QoderWake 文件建議，請使用回傳的連結或任務產出物。連結有效期為 1 小時。

Waker 可以每週自動製作簡報嗎？

可以。請使用 qoderwake automation create schedule 搭配 Cron 表達式建立排程自動化。在正式自動執行前，請先以 automation run-now 進行測試。

費用如何計算？

新的 2Slides 帳號可獲得 500 免費積分。Fast PPT 每頁消耗 10 積分，因此一份每週 8 頁的簡報需 80 積分。範本搜尋、任務輪詢與匯出功能皆為免費。

重點摘要

只要一個 qoderwake mcp add 指令，就能將 Waker 轉化為能交付實際簡報的 AI 員工。將金鑰保留在 MCP 標頭中，透過釘釘、飛書或 cron 排程觸發，並在一小時內儲存 .pptx。

請至 2slides.com/api?tab=mcp 取得您的金鑰與設定。

資料來源：