手把手教学，在 WorkBuddy 桌面版中接入 Agent 工具包

手把手教学，在 WorkBuddy 桌面版中接入 Agent 工具包

本教程主要分享如何把远程 MCP 服务 agent-toolkit 配进桌面版，并确认工具可用。

WorkBuddy 桌面版 v4.24.1。不同小版本菜单文案可能略有差异，路径以「连接器 → 自定义连接器 → 配置 MCP」为准。

接入信息

项目	内容
客户端	WorkBuddy 桌面版
配置文件	~/.workbuddy/mcp.json
MCP 地址	https://agent-toolkit.app.baizhi.cloud/mcp
传输方式	HTTP / Streamable HTTP
鉴权	Authorization: Bearer <你的 API Key>
服务名称	agent-toolkit

URL 必须以 /mcp 结尾。不要把接入指南里的占位密钥 sk_****** 写进配置。

1. 准备 API Key

Agent 工具包的远程 MCP 需要真实 API Key。没有密钥时，WorkBuddy 连上地址也无法调工具。

1. 打开 Agent 工具包控制台的 API Key 页面：https://agent-toolkit.app.baizhi.cloud/api-keys
2. 创建新密钥并立即复制，创建密钥的时候可以基于当前场景选择不同的分组，每个分组包括不同的工具，我这里以视觉设计为例，主要用于帮我设计海报
3. 后续配置里，把 <你的 API Key> 整段替换成这把真实密钥，不要保留尖括号。

2. 在 WorkBuddy 中配置 MCP

WorkBuddy 不走命令行安装，而是编辑用户级配置文件 ~/.workbuddy/mcp.json。建议在客户端内的编辑器里改，避免手改路径写错。

第 1 步 打开连接器管理

在 WorkBuddy 左侧菜单进入「连接器」，点击页面右上角「自定义连接器」。

第 2 步 进入 MCP 配置

在 MCP 服务管理弹窗中点击「配置 MCP」，打开配置文件编辑页面。

第 3 步 写入并保存配置

在配置编辑器中把下面的 agent-toolkit 合并进去后保存，再返回 MCP 列表。

如果文件里已经有其他 MCP 服务，只新增或替换 agent-toolkit 这一段，不要用下面片段整文件覆盖。

需要写入 mcpServers 的片段：

{
  "agent-toolkit": {
    "url": "https://agent-toolkit.app.baizhi.cloud/mcp",
    "headers": {
      "Authorization": "Bearer <你的 API Key>"
    }
  }
}

完整文件结构应类似：

{
  "mcpServers": {
    "agent-toolkit": {
      "url": "https://agent-toolkit.app.baizhi.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <你的 API Key>"
      }
    }
  }
}

• 把 <你的 API Key> 整段替换成真实密钥，不要保留尖括号。
• JSON 必须合法：逗号、引号、括号都要配对。配置文件不支持注释。
• 点击右上角「保存」，再点「返回 MCP 列表」。

第 4 步 信任 MCP 服务

返回 MCP 列表后，首次连接时 WorkBuddy 会提示需要信任此 MCP 服务。列表里会出现 agent-toolkit，状态可能显示失败，并带黄色提示条。

• 提示文案通常是：「首次连接此 MCP 服务需要您的信任确认。」
• 点击提示条右侧的「信任」，允许 WorkBuddy 建立连接。
• 这一步是必选项。不点「信任」，服务会一直处于失败状态。

第 5 步 确认服务已启用

信任成功后，回到 MCP 服务管理列表，确认 agent-toolkit 显示绿色状态并已启用。

3. 接入后如何验证

1. 关闭 MCP 弹窗，回到 WorkBuddy 主界面。
2. 新建一个任务或打开助手会话。

测试一个提示词：

用我 agent-toolkit 这个MCP服务里的生图工具生成一张海报，高端 AI 产品发布海报，主题为 Jev，TypeSafe AI 的 System One decision model，视觉表达“从复杂信息到清晰判断”，中央是一条极简、精准的决策路径：左侧为无序文本、数据碎片与模糊信号，经过中央冷静克制的智能判断核心，右侧转化为清晰的结构化选项、概率节点与确定方向；深黑背景、银白文字、冰蓝光线，少量电光紫点缀，极简网格、精密数据可视化、现代科技品牌视觉、留白充足、强烈秩序感、高级编辑设计、理性、克制、未来感，premium AI product poster, cinematic lighting, Swiss typography layout, clean composition, vertical 4:5

可以查看执行过程，是否调用的工具包的工具，并查看生图效果：

4. 常见问题

现象	处理方式
保存后看不到服务	确认写入的是 mcpServers 下的 agent-toolkit，而不是把整份配置贴到文件最外层。保存后再点「返回 MCP 列表」。
一直显示失败	先点「信任」。若已信任仍失败，检查 API Key 是否完整、是否多了空格或引号，以及 URL 是否以 /mcp 结尾。
信任后仍无工具	确认右侧开关已打开。可先关掉再打开服务，或重启 WorkBuddy 后再看工具数量。
JSON 保存失败	检查是否漏了逗号、用了中文引号，或把注释写进了 JSON。WorkBuddy 配置文件不支持注释。
覆盖了其他 MCP	如果原来已有服务，应合并进 mcpServers，而不是用仅含 agent-toolkit 的片段整文件替换。
密钥泄露风险	API Key 具备调用额度。若已贴到聊天记录或截图里，到控制台作废并重新生成。

完成本文后，WorkBuddy 即可使用 Agent 工具包的远程 MCP 能力。后续若平台工具清单有增减，只需保持服务启用，不必重复填写配置。