2Slides Team
6 min read
QoderWake MCP 配置教程：让 AI 员工自动生成 PPT（2026）
快速回答（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"。这个 AI 员工就能调用 2Slides，按需、从钉钉或飞书、或按定时任务交付可编辑的 PPT。
QoderWake 是阿里 Qoder 团队推出的"AI 员工"产品，官方口号是 "Autonomous AI Employees, On the Job"。每个数字员工叫一个 Waker。IM 消息、定时计划、Hook 事件或 API 调用都能触发 Waker，然后它自己把活干完。QoderWake 支持 macOS 13+、Linux 和 Windows 10+，本地有 Web 控制台（127.0.0.1:19820）和一套完整的命令行，IM 渠道支持钉钉和飞书。
MCP 服务和技能都是按 Waker 单独挂载的。本文演示怎样给某一个 Waker（比如"汇报助理"）接上 2Slides 的 PPT 生成能力。命令全部来自 QoderWake 官方 CLI 文档，2Slides 接口已于 2026 年 9 月 30 日在生产环境实测通过。
为什么给 AI 员工接 2Slides？
- Waker 天生适合做重复性工作，"把这周的数据做成汇报 PPT"正是这类活。
- 2Slides 负责出文件：基于主题、可以继续编辑的 PPT（Fast PPT，每页 10 积分），或者图像级设计的幻灯片（Nano Banana，1K/2K 每页 100 积分），还能加 AI 配音。
- 按 Waker 授权：只有需要做 PPT 的那个员工拿到工具和 Key，权限最小化。
准备工作
- 安装并登录 QoderWake。macOS 和 Linux 可以用官方 CLI 文档里的一键安装命令：
curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
qoderwake login
qoderwake start # 守护进程默认监听 127.0.0.1:19820Windows 安装包和 macOS 安装包可以从 QoderWake 官网下载。如果终端提示找不到 qoderwake，可以用完整路径 ~/.qoderwake/bin/qoderwake。
- 2Slides API Key：在 2slides.com/api 创建（格式是
sk-2slides-...）。新账号送 500 积分，够生成 50 页 Fast PPT。 - Node.js：只有用 stdio 方式时，Waker 所在的设备才需要装。
第一步：查到 Waker ID
qoderwake waker list --jsonWaker ID 以 ag_ 开头。复制要负责做 PPT 的那个员工的 ID，下文用 ag_xxx 代替。
方式一：远程 HTTP MCP（推荐）
qoderwake mcp add --waker-id ag_xxx \
--name 2slides \
--description "2Slides PPT 生成" \
--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 包起来。不加引号的话，shell 会把它拆成两个参数，服务端收到的 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"}'免 Header 兜底方案：如果刷新工具时仍返回 401 或 Authentication required，说明请求头没有带上。可以干脆不用 Header——2Slides 也支持把 Key 作为 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 轮换 Key。
Windows PowerShell 下用单引号一般也能用。不过在不同 shell 里给 JSON 加引号容易出错，这时用方式二的文件导入更稳妥。
2Slides 用 API Key 鉴权，不是 OAuth，所有 --oauth-* 参数都不用填。
方式二：导入 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 格式，如果导入被拒，就回到方式一的命令行参数（这些参数文档里都有完整说明）。导入完成后删掉这个文件，至少别提交到 Git 仓库，因为里面有你的 Key。
方式三：本地 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 用英文逗号分隔，和官方文档里 filesystem 示例的写法一致。--env 填 JSON。QoderWake 默认在本机运行，所以这台设备上要装好 Node.js。
检查是否连接成功
qoderwake mcp list --waker-id ag_xxx # 应该能看到 2slides
qoderwake mcp refresh-tools --waker-id ag_xxx --mcp-id <mid>
qoderwake mcp get --waker-id ag_xxx --mcp-id <mid> # 查看这条配置<mid> 从 mcp list 的结果里取。然后给 Waker 发一个只读的测试任务（QoderWake 官方也建议新连接器先用只读调用验证）：
列出你能用的 2slides 工具，然后搜一个 "minimal" 主题，把 themeId 告诉我。themes_search 不收积分，这一步测试是免费的。连接器出问题时，用 qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false 可以先停用，不用删除。
方式四：上传 2Slides 技能
QoderWake 的技能是有 Git 版本管理的能力包，可以对比差异、随时回滚。上传的内容是"一个 Markdown 文件，或包含 SKILL.md 的压缩包"。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 读取 Key。
密钥规则：QoderWake 文档明确要求，不要把密钥、Token、Cookie 放进任务、记忆、知识库、角色文件或截图里，凭据应该放在受保护的字段或环境变量中。所以千万别把 Key 写进任务 Prompt，也别让 Waker "记住"它。另外，QoderWake 没有说明怎样给技能脚本传环境变量。我们建议这样分工：
- 真正调用接口走 MCP 连接器（方式一），Key 放在连接器的 Header 里。
- 技能只在 Waker 的运行环境里已经有
SLIDES_2SLIDES_API_KEY时才用。可以先发一个测试任务，让它运行scripts/search_themes.py --query minimal --limit 1确认一下。
生成第一份 PPT
读取项目里的 sales_week39.csv，总结本周的关键变化，
用 2slides 做一份 8 页的销售周报 PPT。先搜一个简洁的商务主题，
再生成 PPT，把下载链接发给我。Waker 会依次调用 themes_search 和 slides_generate，最后返回 downloadUrl。我们实测 3 页 Fast PPT 大约 22 秒生成。链接 1 小时后失效。 QoderWake 文档说，文件能不能直接发出去"取决于渠道能力，可使用返回的链接或任务产物"。所以要让 Waker 马上把链接发出来，或者把 .pptx 下载到工作区，之后用 qoderwake session artifacts --session-id sess_xxx 取回。
AI 员工的典型用法
钉钉 / 飞书消息触发：Waker 绑定钉钉或飞书渠道以后，同事在群里发一句"@汇报助理 做一份 6 页的四季度招聘计划汇报"，Waker 就会自己整理资料、调用 2Slides，再把链接回复到群里。
每周定时出一份 PPT：官方 CLI 文档提供了定时自动化命令：
qoderwake automation create schedule --waker-id ag_xxx \
--name "每周销售周报PPT" \
--schedule-type cron --cron "0 9 * * 1" \
--timezone Asia/Shanghai \
--prompt "用最新的销售 CSV，通过 2slides 生成本周 8 页销售周报 PPT，并发送下载链接"
qoderwake automation run-now --waker-id ag_xxx --automation-id tr_xxx # 先手动跑一次先用 run-now 跑一次，再用 qoderwake automation detail 看结果，确认没问题再让它按计划自动运行。
2Slides MCP 工具一览
| 工具 | 作用 | 积分 |
|---|---|---|
themes_search | 从 1,500 多套主题中查找 themeId | 免费 |
slides_generate | 基于主题生成可编辑 PPT（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 | 打包下载页面图片、音频和讲稿 | 免费 |
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 没带上 Key。用加了引号的
--header或--headersJSON 重新添加。 - 看不到工具：执行
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 可以挂多个 MCP 服务，stdio、HTTP、SSE 三种传输方式都行。可以用 qoderwake mcp add --waker-id <id> 添加，也可以在控制台的 Custom MCP Connectors 界面配置。
给 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"。值里有空格，所以要给整个 Header 参数加双引号。
2Slides 的 API Key 应该放在哪里？
放在 MCP 连接器的 Header（--header 或 --headers）里，stdio 方式放在 --env 里。不要写进任务、记忆、知识库或角色文件，QoderWake 文档明确禁止这样做。
AI 员工能把 PPT 直接发到钉钉或飞书吗？
Waker 一定可以回复 2Slides 的下载链接。能不能直接发文件取决于渠道能力，QoderWake 文档建议使用返回的链接或任务产物。注意链接 1 小时后失效。
能让 AI 员工每周自动做一份 PPT 吗？
能。用 qoderwake automation create schedule 加一个 cron 表达式创建定时自动化。正式启用前，先用 automation run-now 手动跑一次。
费用怎么算？
2Slides 新账号送 500 积分。Fast PPT 每页 10 积分，每周一份 8 页的周报是 80 积分。主题搜索、任务查询和导出都免费。
总结
一条
qoderwake mcp add，就能让 Waker 变成会交付真实 PPT 的 AI 员工。Key 放在 MCP Header 里，用钉钉、飞书或 cron 定时触发，拿到.pptx后在 1 小时内保存下来。
延伸阅读：能做 PPT 的个人 AI 智能体盘点、千问办公接入 2Slides、WorkBuddy 接入 2Slides、任意 AI 智能体接入 2Slides MCP、Agent Skills 与 MCP 服务器怎么选。
到 2slides.com/api?tab=mcp 获取 API Key 和配置。
参考来源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
