搜索 WorkBuddy 的 MCP 指南，如今仍占据 Google 榜首的官方页面打开却是 404。设置入口也变了。在 WorkBuddy 5.9.4 中，WorkBuddy MCP 服务器位于桌面应用里的"自定义连接器"按钮之后。
我们用它接入了 Atlas Cloud MCP 服务器，然后请一位品牌策略专家把一张香水照片变成了 Seedance 2.5 片段。下文包含：确切的配置、旧指南跳过的那一步信任操作，以及连接器与技能、插件的区别。
要点速览
- WorkBuddy 连接器基于 MCP 运行，桌面端的"自定义连接器"按钮可添加任意 MCP 服务器。
- 网页版仅列出内置连接器，因此自定义 MCP 需在桌面客户端中设置。
- Atlas Cloud MCP 服务器为每个 WorkBuddy 任务提供 15 个工具，涵盖图像、视频、音频和支出追踪。
- 技能按需加载指令，连接器暴露实时工具，插件则可将两者打包在一起。
- 在我们的测试中，内置的"品牌策略专家"无需加载技能，就把一张产品照片变成了 Seedance 2.5 片段。
WorkBuddy 支持 MCP 吗？
支持。腾讯的连接器指南称，连接器"基于 MCP 等标准化协议"将外部服务引入 WorkBuddy。桌面端目录列出了 26 个连接器，从 Gmail、Notion 到 Kling AI 和 Tripo 3D，而"自定义连接器"按钮可添加未列出的服务器。
有两个细节容易让人踩坑：
- 仅限桌面端。 网页版 workbuddy.ai/app 的目录更短，且没有自定义选项。企业管理员也可关闭该功能，应用对此的提示为"您的管理员已停用添加自定义连接器"。
- 设置里没有 MCP 页面。 旧指南指向那里，但在 5.9.4 中 MCP 位于"专家 · 技能 · 连接器"之下。
腾讯正将同一协议推入企业系统。10 月 30 日，ComputerWeekly 援引腾讯高级执行副总裁汤道生的话称，孤立的业务系统"现在可以暴露模型上下文协议（MCP）接口给 WorkBuddy"。
将 Atlas Cloud 添加为 WorkBuddy 自定义连接器
目录中的创意类连接器各仅覆盖一家供应商。Atlas Cloud 将 400+ 个模型置于一个 MCP 服务器之后，因此一个连接器即可添加图像、视频和音频生成，以及报告每项任务成本的工具。WorkBuddy 通过 npx 在本地运行它，因此请先安装 Node.js 18 或更高版本。
方法一：在自定义连接器编辑器中向 WorkBuddy 添加 MCP 服务器
第 1 步：创建 Atlas Cloud API 密钥。 登录后打开"设置"，在"API 密钥"面板中点击"创建 API 密钥"。
第 2 步：粘贴服务器配置。 在侧边栏打开"专家 · 技能 · 连接器"，切换到"连接器"（1），点击"自定义连接器"（2）。在" MCP 服务器管理"窗口中点击"添加 MCP"（3），用下方配置替换编辑器中的所有内容（4），然后点击"保存"（5）。
plaintext1{ 2 "mcpServers": { 3 "atlascloud": { 4 "type": "stdio", 5 "command": "npx", 6 "args": ["-y", "atlascloud-mcp"], 7 "env": { 8 "ATLASCLOUD_API_KEY": "${ATLASCLOUD_API_KEY}" 9 } 10 } 11 } 12}
"${ATLASCLOUD_API_KEY}" 的值会从环境变量中读取密钥，因此它永远不会留在文件里。设置该变量并重启 WorkBuddy，或将密钥粘贴到引号之间。Atlas Cloud 的 MCP 设置指南涵盖了在其他客户端中配置同一服务器的方法。
第 3 步：信任该服务器。 点击"返回 MCP 列表"。新服务器会保持灰色，并显示提示"此 MCP 服务器在首次连接前需要您信任"。点击"信任"，半分钟内圆点会变绿，卡片显示"已启用 15/15 工具"。
方法二：改用 WorkBuddy MCP 配置文件
方法一中的编辑器会写入一个普通文件，其路径它也会显示出来：用户文件夹中的 .workbuddy-ai\mcp.json。直接编辑该文件可一次性添加多个服务器，或在另一台电脑上复用配置，然后在"MCP 服务器管理"中查看信任提示。
| 字段 | 作用 | Atlas Cloud 的取值 |
|---|---|---|
| type | 连接类型 | stdio，本地进程 |
| command 和 args | 启动服务器的命令 | npx 加 -y 和 atlascloud-mcp |
| env | 该进程的变量 | ATLASCLOUD_API_KEY，你的密钥或 ${...} 引用 |
| url 和 headers | 仅用于远程服务器 | 此处不需要 |
该格式遵循 WorkBuddy 的 MCP 参考，而我们的 Claude Code MCP 配置指南也讲解了相同的字段。
从任意 WorkBuddy 任务生成产品片段
只要开关开启，自定义服务器的工具就会加载到每个任务中。为验证这一点，我们召唤了"品牌策略专家"——这位专家列出的擅长领域是品牌策略、一致性和视觉识别——将模型保持在"自动"，并创建了一个包含一位模特肖像和一张无品牌香水瓶照片的工作区。然后我们发送了以下内容：
plaintext1We're launching an amber perfume called Golden Hour. In this workspace, model.jpg is our model and perfume.jpg is the bottle. Using the atlascloud tools: (1) upload both images, (2) make one 9:16 photo with Seedream 5.0 Pro Edit of her holding the bottle near her face by a sunlit window, keeping her face and the bottle unchanged, (3) animate it with Seedance 2.5 image-to-video, 5 seconds, 720p, with audio, as she turns toward the light and smiles while the camera slowly pushes in, (4) save both files here and write a two-line launch caption. Check my Atlas balance before and after and report the cost. Reply in English.
这位专家从未加载任何技能。它检查了余额、上传了两张照片、读取了模型架构，让 Seedream 将香水瓶放到她手中，并把那一帧传给 Seedance 2.5 图生视频。在默认权限下，没有任何 Atlas 调用因等待批准而中断，任务在 10 分 29 秒内完成，肖像、片段和文案均保存到了工作区。
片段以 720 x 1280、24 fps、五秒带音频的形式返回，在她转向光线时，她的面部和香水瓶保持稳定。若要在自己的画面上重跑这段动效，请使用 Seedance 2.5 图生视频操场。
每个 Atlas 工具在任务中的作用
我们的运行用到了服务器所添加的 15 个工具中的 7 个。
| 功能 | 工具 | 在我们的运行中使用 |
|---|---|---|
| 查找模型 | atlas_search_docs、atlas_list_models、atlas_get_model_info | list models、get model info |
| 创建媒体 | atlas_generate_image、atlas_generate_video、atlas_generate_audio、atlas_quick_generate | generate image、generate video |
| 处理文件和文本 | atlas_upload_media、atlas_transcribe_audio、atlas_chat | upload media |
| 追踪任务 | atlas_get_prediction、atlas_list_predictions | get prediction |
| 监控支出 | atlas_get_balance、atlas_get_model_usage、atlas_get_model_costs | get balance |
WorkBuddy 插件 vs 技能 vs 连接器
这三个名称容易混淆。区别在于 WorkBuddy 接收到什么：实时工具、书面指令，还是包含两者的打包。
| 连接器（MCP 服务器） | 技能 | 插件 | |
|---|---|---|---|
| WorkBuddy 获得什么 | 可调用的工具，例如视频生成工具 | 任务匹配时读取的 SKILL.md 操作手册 | 可容纳技能、代理、钩子和 MCP 服务器的捆绑包 |
| 如何添加 | 选择目录卡片，或桌面端的自定义连接器 | "技能"标签页，然后"添加技能"和"上传技能" | 通过插件市场分发 |
| 何时加载 | 开关开启时每个任务都加载 | 任务需要时，或用 / 选择时 | 随所含内容一同加载 |
| 适用场景 | 希望随处可用的服务 | 带内部规则的可重复工作流 | 团队想要作为一次安装共享的多个组件 |
插件是打包层。WorkBuddy 的插件文档称它们"用自定义技能、代理、钩子和 MCP 服务器"扩展代理。在 MCP 服务器管理中，Miora 画布服务器标注为"来自插件 mcp-miora"。
Atlas Cloud 两种方式都可行：在网页版上传其技能，如我们的 WorkBuddy AI 演练所示；或在桌面端添加连接器，从此不再向每次对话粘贴密钥。
修复常见的 WorkBuddy MCP 连接问题
大多数 WorkBuddy MCP 卡顿都发生在"保存"与首次工具调用之间。
| 症状 | 可能原因 | 修复 |
|---|---|---|
| 绿点始终不出现，或加载 0 个工具 | Node.js 缺失或低于版本 18 | 安装 Node.js 18+，然后点击服务器卡片上的刷新图标 |
| Atlas 工具因密钥错误失败 | ${ATLASCLOUD_API_KEY} 变量是在 WorkBuddy 启动后才设置的 | 重启 WorkBuddy，或将密钥粘贴到配置中 |
| "+ > 连接器"列表中没有 Atlas | 该列表仅显示目录连接器 | 在"自定义连接器"中查看；其工具仍会加载到任务中 |
| 托管的 Atlas URL 要求登录 | 该端点使用 OAuth 登录 | 在 WorkBuddy 中，使用带 API 密钥的 npm 服务器 |
常见问题
使用 MCP 连接器需要付费的 WorkBuddy 套餐吗？
不需要。本指南的每一步都在免费账户上运行，WorkBuddy 的定价页面将专家、技能和连接器包含在免费套餐中。额度才是你会注意到的限制，下面的额度问题会详细说明。
我可以通过 HTTP 添加远程服务器吗？
可以，根据 WorkBuddy 的 MCP 参考，它列出了 stdio、SSE 和 streamable HTTP。远程条目使用 "url" 和可选的 "headers"（Bearer 令牌放在此处）代替 "command"，在同一个 mcp.json 编辑器中编写。
WorkBuddy MCP 连接器会消耗额度吗？
添加是免费的，但代理的思考时间不是。我们在"自动"模式下 10 分钟的运行为此消耗了约 56 个 WorkBuddy 额度，其中大部分花在代理 30 多次检查渲染状态上。媒体费用计入你的 Atlas Cloud 账户：一次 Seedream 编辑加一段五秒 720p 的 Seedance 2.5 片段共 1.55 美元。按 2026 年 11 月列出的 20% 折扣，Atlas 估计五秒 720p 图生视频约为 1.52 美元，10 秒约为 3.04 美元。
其他 AI 代理能把 WorkBuddy 当作 MCP 服务器使用吗？
可以，通过一个社区项目。开源 workbuddy-mcp 服务器将 WorkBuddy 命令行包装为一个工具 run_workbuddy_task，因此 Claude Code、Codex 或 Cursor 都能把任务交给 WorkBuddy。它需要 CLI 已登录，且默认跳过权限提示，因此请先检查其设置。
结语
WorkBuddy 的 MCP 支持是真实存在的，只是藏得较深：桌面端的自定义连接器、一条 JSON 条目、一次保存和一次信任点击。之后，服务器的工具会跟随你进入每个任务和每个专家，哪怕是完全不懂视频的专家。
若要在 WorkBuddy 内处理图像和视频，连接一次 Atlas Cloud 服务器，然后用大白话提需求即可。对于任何其他服务器，同样的 workbuddy mcp 步骤都适用：粘贴到 mcp.json，保存，信任它，然后开始任务。
