

WorkBuddy 做PPT:接入 2Slides MCP 服务器与技能完整教程(2026)
快速回答(60 字内): 在 WorkBuddy 打开「插件 → MCP 服务器 → 配置 MCP」(或「连接器 → 自定义连接器」),粘贴一段用
npx -y 2slides-mcp@latest启动、env.API_KEY填 2Slides 密钥的mcpServers配置。看到绿色 ✓ 就算连上了。之后在微信里说一句「做个 PPT」,WorkBuddy 就会回你一个.pptx下载链接。
WorkBuddy 是腾讯 CodeBuddy 团队出品的桌面 AI 智能体工作台。它能读本地文件、在你的电脑上执行任务,能从微信、企业微信、飞书、钉钉、QQ 接收指令,还支持定时自动化。它自己不带专业的 PPT 排版引擎,接上 2Slides MCP 服务器之后,一份需求、一份报告或一条聊天消息都能直接变成可编辑的 PowerPoint 文件,文件以下载链接的形式交回给你。
本文给出三种接入方式,按官方文档覆盖程度从高到低排列:
- 本地 stdio MCP 服务器(推荐,和 WorkBuddy 官方 MCP 指南的配置格式完全一致)
- 远程 Streamable HTTP 地址(不需要装 Node.js)
- 2Slides Agent 技能(以技能包方式安装,不走 MCP)
为什么要让 WorkBuddy 接入 2Slides?
WorkBuddy 擅长规划、读文档、跨工具办事,但把内容渲染成一套设计好的幻灯片需要专门的工具。接入 2Slides 后分工很清楚:
- WorkBuddy 负责从你的文件、笔记或聊天需求里整理大纲、写每页内容;
- 2Slides 负责出成品:基于 1,500+ 模板的可编辑
.pptx(Fast PPT),或者 AI 设计的图片式幻灯片,还可以加 AI 配音。
再加上 WorkBuddy 本来就能接微信和定时任务,你可以在手机上随口要一份 PPT,也可以让它每周自动出一份周报 PPT,都不用打开电脑操作。
准备工作
- 安装并登录 WorkBuddy 桌面端(国内 workbuddy.cn,海外 workbuddy.ai)。
- 一个 2Slides API 密钥,在 2slides.com/api 创建,格式形如
sk-2slides-...。新账号送 500 积分,Fast PPT 每页 10 积分,够做 50 页。按量付费,积分永不过期。 - Node.js,仅方式一需要,装在运行 WorkBuddy 的同一台电脑上(终端执行
node -v能看到版本号即可)。方式二本地什么都不用装,方式三需要 Python 3 和requests。
哪些有官方文档、哪些还没有(截至 2026 年 9 月 30 日)
| 事项 | 状态 |
|---|---|
「插件 → MCP 服务器 → 配置 MCP」入口;用户级 ~/.workbuddy/mcp.json、项目级 <项目>/.workbuddy/mcp.json | WorkBuddy 官方 MCP 指南有写 |
stdio 配置使用 command / args / env;绿色表示连接成功,红色表示配置错误 | WorkBuddy 官方 MCP 指南有写 |
远程服务器写法 "type": "streamableHttp" + url | WorkBuddy 开放平台连接器文档和第三方接入教程里有,面向用户的 MCP 指南里没有 |
远程服务器加 headers(Authorization: Bearer ...) | 第三方厂商的 WorkBuddy 接入文档有示例,WorkBuddy 官方未写 |
| 技能:拖入本地技能包上传,或在对话中「查找技能」「创建技能」 | WorkBuddy 官方技能文档有写 |
| 给导入的技能单独设置环境变量 | 官方未说明,下文给出可行做法 |
| 2Slides MCP 地址、URL 带密钥鉴权、stdio 包 | 2Slides 已于 2026 年 9 月 30 日在生产环境实测 |
方式一:本地 stdio 服务器(推荐)
这种写法和 WorkBuddy 官方 MCP 指南里的示例结构一样(command、args、env),出问题的概率最低。
第 1 步:打开 MCP 配置编辑器。 下面两条路径都可以:
- 左侧边栏 插件 → 右上角 MCP 服务器 → 配置 MCP
- 连接器 页面 → 右上角 自定义连接器 → 配置 MCP
也可以直接编辑配置文件:~/.workbuddy/mcp.json 对所有项目生效,<项目>/.workbuddy/mcp.json 只对当前项目生效。
第 2 步:粘贴配置。 如果已经配过其他服务器,把 2slides 这一项合并进 mcpServers 即可:
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": {
"API_KEY": "YOUR_2SLIDES_API_KEY"
}
}
}
}第 3 步:保存后看状态。 2slides 旁边出现 绿色 ✓,说明 WorkBuddy 已经启动服务并加载了工具。出现 红色 ✗ 说明配置有问题,按文末排错清单逐项检查。
几点提醒:
- 环境变量名必须是
API_KEY,2slides-mcp这个 npm 包读的就是它。 - WorkBuddy 开放平台文档里的 stdio 示例多写了一行
"type": "stdio",加不加都行,用户指南的官方示例没有这一行。 - 服务是在你自己电脑上跑的。想从微信远程下单或者跑定时任务,电脑要保持开机、WorkBuddy 要开着。
方式二:远程 Streamable HTTP 地址
2Slides 提供托管的 MCP 服务:https://2slides.com/api/mcp,密钥可以放在 Bearer 请求头里,也可以直接拼在 URL 上。2Slides 不支持 OAuth,所以密钥要自己填。
WorkBuddy 面向用户的 MCP 指南只给了 stdio 示例。不过 WorkBuddy 开放平台的连接器文档 里,远程服务器用的是 "type": "streamableHttp",第三方厂商(比如威科先行)的 WorkBuddy 接入教程也是在「连接器 → 自定义连接器 → 配置 MCP」里用同样的写法。推荐这样配:
{
"mcpServers": {
"2slides": {
"type": "streamableHttp",
"url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY",
"timeout": 60000
}
}
}不想把密钥放进 URL 的话,可以改用请求头:
{
"mcpServers": {
"2slides": {
"type": "streamableHttp",
"url": "https://2slides.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_2SLIDES_API_KEY"
},
"timeout": 60000
}
}
}一直是红色怎么办: WorkBuddy 和腾讯 CodeBuddy 同属一个产品家族,CodeBuddy CLI 文档里远程服务器写的是 "type": "http" 加 url 和 headers。可以把 "streamableHttp" 改成 "http" 试一下。两种都不行,就回到方式一,那是官方文档明确给出的格式。
安全提示: 带
?apikey=的 URL 本身就等于密钥。不要发到群聊里,不要截图外传,也不要把含密钥的项目级.workbuddy/mcp.json提交到 Git 仓库。万一泄露,去 2slides.com/api 删掉旧密钥、重新生成一个。
方式三:安装 2Slides 技能
WorkBuddy 支持基于 SKILL.md 的技能。官方 2Slides 技能(name: 2slides)内置了调用 2Slides REST API 的 Python 脚本,不需要配置 MCP 服务器。
做法 A:上传技能包
- 打开 GitHub 仓库
2slides/slides-generation-2slides-skills,点 Code → Download ZIP; - 在 WorkBuddy 技能页面选择 上传技能,把 ZIP 拖进去,或者点 选择文件 选中它,WorkBuddy 会自动完成导入。
请用仓库最新代码打包的 ZIP,不要用仓库里那个较旧的 2slides.skill 文件。
做法 B:在对话里让它装。 直接说「查找技能:2Slides 生成 PPT」,或者把 GitHub 仓库链接发给 WorkBuddy,让它安装成技能。
配置密钥。 技能脚本读的环境变量是 SLIDES_2SLIDES_API_KEY,不是 API_KEY。WorkBuddy 目前没有文档说明怎么给单个技能配环境变量。比较稳妥的做法是写进系统环境:macOS 在 ~/.zshrc 里加一行 export SLIDES_2SLIDES_API_KEY=YOUR_2SLIDES_API_KEY,Windows 添加一个用户环境变量,然后重启 WorkBuddy。验证时说一句「用 2slides 技能搜一个 minimal 主题」,它会运行 search_themes.py,不消耗积分。
MCP 还是技能? MCP 给 WorkBuddy 的是结构化工具,还有状态灯可以看;技能不需要 Node.js,适合本来就在用技能管理工作流的人。二选一就够了,不用两个都装。详细对比见 Agent 技能 vs MCP 服务器:做演示文稿该选哪个。
验证是否接通
新建一个 WorkBuddy 任务,输入:
列出你从 2slides MCP 服务器拿到的工具,然后在 2slides 里
搜索 "business" 主题,给我前 3 个主题 ID。看到它调用 themes_search 并返回主题 ID,就说明接通了。搜索主题免费,这一步不花积分。
生成第一份 PPT
读取「文档」文件夹里的三季度报告,做一份 10 页的中文管理层汇报 PPT。
先在 2slides 里找一个简洁的商务主题,用 Fast PPT 生成,把下载链接发给我。WorkBuddy 会依次调用 themes_search、slides_generate,最后给出 .pptx 的 downloadUrl。2Slides 实测 3 页 Fast PPT 大约 22 秒生成完毕;10 页消耗 100 积分。
下载链接 1 小时后失效。 最好顺手让 WorkBuddy 把文件存到本地(比如「下载到 ~/Documents/Decks」),或者拿到链接后尽快打开。
WorkBuddy 最适合的两个场景
场景一:在微信 / 企业微信里要 PPT
WorkBuddy 可以接收微信、企业微信、飞书、钉钉、QQ 的指令。接好 2Slides 后,在手机上发一句:
帮我做一份 6 页的中文 PPT,介绍我们新推出的会员方案,用简约主题,做好把链接发我。WorkBuddy 在你的电脑上跑完任务,在同一个对话里回复下载链接。链接只有 1 小时有效,建议加一句「另外存一份到桌面」,事后也能找到文件。如果你用的渠道支持发文件,也可以让它直接把文件发过来。
场景二:用定时任务自动出 PPT
WorkBuddy 的自动化模块可以按时间表执行任务。比如每周一份周报:
每周一上午 9:00,读取 ~/Reports/weekly 里最新的文件,
用 2slides(Fast PPT)做一份 8 页总结 PPT,保存到 ~/Decks,并通过企业微信把链接发给我。WorkBuddy 官方定价页列出了各套餐的自动化任务上限:体验版(免费)3 个,标准版(¥99/月)15 个,高级版(¥199/月)30 个,旗舰版(¥999/月)99 个。注意 WorkBuddy 积分和 2Slides 积分是两套体系,每次生成 PPT 扣的是你 2Slides 密钥里的积分(Fast PPT 每页 10 积分)。
2Slides MCP 工具一览
| 工具 | 作用 | 积分 |
|---|---|---|
themes_search | 从 1,500+ 模板里查找 themeId | 免费 |
slides_generate | 基于主题生成可编辑 .pptx(Fast PPT),同步或异步 | 10 / 页 |
slides_create_pdf_slides | 根据文本生成 AI 设计的图片式幻灯片(Nano Banana) | 100 / 页(1K/2K),200(4K) |
slides_create_like_this | 参照一张图片的风格生成幻灯片 | 100 / 页(1K/2K),200(4K) |
slides_generate_narration | 为 Nano Banana 任务生成 AI 配音(不支持 Fast PPT) | 210 / 页 |
slides_download_slides_pages_voices | 打包下载页面图片、音频和讲稿(ZIP) | 免费 |
jobs_get | 查询异步任务进度(每 20–30 秒一次) | 免费 |
Nano Banana 和配音都是异步任务,一般 1–3 分钟完成,WorkBuddy 会自动轮询 jobs_get 直到出结果。
常见问题排查
- stdio 配置显示红色 ✗: 检查是否装了 Node.js(
node -v)、JSON 格式是否正确(别留多余的逗号)、env里有没有API_KEY。第一次运行时npx要下载包,网络慢的话变绿会慢一些。 - 远程配置显示红色 ✗: 把
"streamableHttp"换成"http"试试;确认地址是https://2slides.com/api/mcp(加上查询参数)。还不行就改用方式一。 - 401 / 未授权: 密钥填错了、已被删除,或者放错了字段。stdio 方式的变量名是
API_KEY,技能方式是SLIDES_2SLIDES_API_KEY。 - 积分不足: 到 2slides.com/pricing 充值,最低 $5 买 2,000 积分。
- 链接失效:
downloadUrl只有 1 小时有效。让 WorkBuddy 重新生成,并在以后的指令里要求它存一份到本地。 - 想给 Fast PPT 配音: 配音只支持 Nano Banana 任务,要先用
slides_create_pdf_slides生成。
常见问题
WorkBuddy 支持自定义 MCP 服务器吗?
支持。WorkBuddy 有「插件 → MCP 服务器 → 配置 MCP」编辑器,连接器页面也有「自定义连接器」入口。配置保存在 ~/.workbuddy/mcp.json(用户级)或 <项目>/.workbuddy/mcp.json(项目级),连接成功会显示绿色 ✓。
WorkBuddy 接入 2Slides 的 MCP 配置具体怎么写?
推荐在 mcpServers 里加入 "2slides": {"command": "npx", "args": ["-y", "2slides-mcp@latest"], "env": {"API_KEY": "YOUR_2SLIDES_API_KEY"}},需要本机装有 Node.js。远程写法是 "type": "streamableHttp" 加上 "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"。
能在微信里让 WorkBuddy 做 PPT 吗?
可以。WorkBuddy 绑定微信或企业微信、并接好 2Slides 之后,直接在聊天里提需求,它会在你的电脑上生成 PPT,然后回复下载链接。链接 1 小时后失效,建议同时让它存一份到本地。
不用 MCP,用 2Slides 技能可以吗?
可以。从 GitHub 下载技能仓库的 ZIP,拖进 WorkBuddy 的「上传技能」,或者让 WorkBuddy 通过「查找技能」帮你装。技能从环境变量 SLIDES_2SLIDES_API_KEY 读取密钥,需要 Python 3 和 requests。
用下来要花多少钱?
WorkBuddy 有免费的体验版(每月 500 积分、3 个自动化任务),付费套餐 ¥99/月起。2Slides 单独计费:新账号送 500 积分,Fast PPT 每页 10 积分,AI 设计的图片式幻灯片每页 100 积分。
远程配置是 WorkBuddy 官方支持的吗?
部分有官方依据。WorkBuddy 开放平台的连接器文档里远程服务器用的是 "type": "streamableHttp",但面向用户的 MCP 指南只给了 stdio 示例。所以本文把 stdio 作为首选,远程方式备注了 "type": "http" 作为兜底写法。
总结
在
mcpServers里加一段运行npx -y 2slides-mcp@latest的配置,WorkBuddy 就成了一个能从微信、企业微信或周一早上的定时任务里调用的 PPT 生成器。看到绿色 ✓ 就算接好了;链接 1 小时内记得保存;不想装 Node.js,就用技能方式。
同系列教程:个人 AI 智能体做演示文稿总览、千问办公 QwenWork 接入 2Slides、QoderWake、Manus、OpenClaw。其他 MCP 客户端可参考 任意 AI 智能体接入 2Slides MCP 服务器。
到 2slides.com/api?tab=mcp 获取密钥和可直接复制的配置。
参考来源:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free