QoderWakeと2Slidesの連携方法：AI社員のためのMCP活用ガイド（2026年版）

Q: QoderWake はカスタム MCP サーバーをサポートしていますか？

はい。各 Waker は、qoderwake mcp add --waker-id またはコンソールの「Custom MCP Connectors」画面を使用して、stdio、HTTP、または SSE 経由で複数の MCP サーバーをマウントできます。

Q: Waker に 2Slides を追加する正確なコマンドは何ですか？

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"を実行。DingTalkやFeishuから編集可能な.pptxをオンデマンドで生成可能になります。

AlibabaのQoderチームが開発したQoderWakeは、「実務に従事する自律型AI社員」をコンセプトとしています。各デジタル社員はWakerと呼ばれます。Wakerはチャットツールのメッセージ、スケジュール設定、フックイベント、またはAPI呼び出しによって起動し、自律的に業務を遂行します。QoderWakeはmacOS 13以降、Linux、Windows 10以降で動作し、127.0.0.1:19820のローカルWebコンソールとフル機能のCLIを備え、DingTalkやFeishuと連携します。

MCPサーバーとスキルはWakerごとに紐付けられます。本ガイドでは、特定のWaker（例：「レポート作成アシスタント」）に2Slidesのプレゼン生成エンジンを実装する方法を解説します。内容は、2026年9月30日に本番環境で検証済みの公式QoderWake CLIリファレンスと2Slidesエンドポイントに基づいています。

Wakerに2Slidesを連携させるメリット

Wakerは反復業務に最適: 「今週の数値をスライド資料にまとめる」といったタスクは、まさにWakerが得意とする領域です。
2Slidesがファイルを生成: テーマに基づいた編集可能なPowerPoint（Fast PPT、1ページあたり10クレジット）、またはAIナレーション（オプション）付きの画像デザインスライド（Nano Banana、1K/2K解像度で1ページあたり100クレジット）を出力します。
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クレジットが付与され、Fast PPTなら50ページ分無料で試せます。
Node.js: stdio方式を利用する場合のみ、デバイスにインストールされている必要があります。

ステップ 1: Waker IDの確認

qoderwake waker list --json

Waker IDはag_から始まります。スライド作成を担当させるWakerのIDをコピーしてください。以下の例では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のペア全体をダブルクォーテーションで囲んでください。引用符がないと、シェルによって2つの引数に分割され、ヘッダーが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はOAuthではなくシンプルなAPIキーを使用するため、--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 スキルのアップロード

QoderWake のスキルは Git でバージョン管理された機能パックであり、差分の確認やロールバックが可能です。「SKILL.md を含む Markdown ファイルまたはアーカイブ」をアップロードして使用します。公式の 2Slides スキルは github.com/2slides/slides-generation-2slides-skills で公開されています。SKILL.md がアーカイブのルートに配置されるように ZIP 圧縮してください。

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 のドキュメントには、「タスク、メモリ、ナレッジベース、ロールファイル、スクリーンショットの中にシークレット、トークン、クッキーを絶対に含めないこと」と明記されています。認証情報は保護されたフィールドまたは環境変数に保存する必要があります。したがって、タスクのプロンプトにキーを貼り付けたり、Waker にキーを「覚える」よう指示したりしないでください。QoderWake にはスキルスクリプトに環境変数を渡す方法が明文化されていないため、以下の使い分けを推奨します。

実際の API 呼び出しには MCP コネクタ（方法 1） を使用する。キーはそのヘッダー内に保持されます。
スキル は、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 のドキュメントによると、ファイルの配信は「チャネルの機能に依存します。返されたリンクまたはタスクアーティファクトを使用してください」とされています。そのため、Waker にリンクをすぐに投稿させるか、.pptx をワークスペースにダウンロードさせるようにしてください。その後、qoderwake session artifacts --session-id sess_xxx を使用してセッションから取得できます。

AI 社員のユースケース

DingTalk や Feishu からのトリガー： Waker を DingTalk または Feishu チャネルと連携させると、チームメンバーが「@Reporting Assistant 第 4 四半期の採用計画について 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 にファイルをタスクアーティファクトとして保存させるようにしてください。

よくある質問

QoderWake はカスタム MCP サーバーをサポートしていますか？

はい。各 Waker は、qoderwake mcp add --waker-id <id> またはコンソールの「Custom MCP Connectors」画面を使用して、stdio、HTTP、または SSE 経由で複数の MCP サーバーをマウントできます。

Waker に 2Slides を追加する正確なコマンドは何ですか？

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 を DingTalk や Feishu に送信できますか？

Waker は常に 2Slides のダウンロードリンクを返信できます。ファイル自体が添付されるかどうかは、使用するチャネルの機能に依存します。QoderWake のドキュメントでは、返されたリンクまたはタスクアーティファクトを使用することが推奨されています。リンクの有効期限は 1 時間です。

Waker は毎週自動でデッキを作成できますか？

はい。qoderwake automation create schedule と cron 式を使用して、スケジュール化された自動化を作成できます。無人実行を開始する前に、automation run-now でテストを行ってください。

料金はいくらですか？

2Slides の新規アカウントには 500 クレジットが無料で付与されます。Fast PPT は 1 ページあたり 10 クレジットなので、毎週 8 ページのスライドを作成する場合、80 クレジット消費されます。テンプレート検索、ジョブのポーリング、エクスポートは無料です。

まとめ

qoderwake mcp add コマンドひとつで、Wakerは実際のプレゼン資料を納品するAI社員へと進化します。APIキーをMCPヘッダーに保持し、DingTalkやFeishu、あるいはcronスケジュールから実行することで、1時間以内に.pptxファイルを保存できます。

APIキーと設定ファイルは 2slides.com/api?tab=mcp で取得してください。

参照元：