# 手把手教学，在 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>` 整段替换成这把实密钥，不要保留尖括号。

![image](https://developer.qcloudimg.com/http-save/yehe-12778266/5bfc8a9e0d8d9a9e2f49551c8cfc2f50.png)

## 2. 在 WorkBuddy 中配置 MCP

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

### 第 1 步  打开连接器管理

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

![image](https://developer.qcloudimg.com/http-save/yehe-12778266/b6954dfeda6158eb5d9782f6ed5b25e1.png)

### 第 2 步  进入 MCP 配置

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

![image](https://developer.qcloudimg.com/http-save/yehe-12778266/e1eab0408d002e207466b5729aca1dc9.png)

### 第 3 步  写入并保存配置

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

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

需要写入 `mcpServers` 的片段：

```json
{
  "agent-toolkit": {
    "url": "https://agent-toolkit.app.baizhi.cloud/mcp",
    "headers": {
      "Authorization": "Bearer <你的 API Key>"
    }
  }
}
```
完整文件结构应类似：

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

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

![image](https://developer.qcloudimg.com/http-save/yehe-12778266/4ff228f696c25a0687e56b7d4a771388.png)
  
### 第 4 步  信任 MCP 服务

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

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

![image](https://developer.qcloudimg.com/http-save/yehe-12778266/9e9b2da4b5cb742b3d85d32dcd27df3a.png)

### 第 5 步  确认服务已启用

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

![image](https://developer.qcloudimg.com/http-save/yehe-12778266/238d5f3076ed714084b574b96595d2d8.png)

## 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

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

![image](https://developer.qcloudimg.com/http-save/yehe-12778266/7da0c4f36c2a8e5a5e7e0d0ae45f20f8.png)

## 4. 常见问题

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

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

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

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

人工智能

本教程指导用户将agent-toolkit远程MCP服务配置到WorkBuddy桌面版v4.24.1。步骤包括获取APIKey、编辑mcp.json配置文件、信任服务并验证工具可用性。配置路径为「连接器→自定义连接器→配置MCP」，需确保URL以/mcp结尾，正确使用Authorization Bearer鉴权，解决常见连接问题后即可调用海报生成等AI工具。

数据可视化

代码解释

WorkBuddy 

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

本教程指导用户将agent-toolkit远程MCP服务配置到WorkBuddy桌面版v4.24.1。步骤包括获取APIKey、编辑mcp.json配置文件、信任服务并验证工具可用性。配置路径为「连接器→自定义连接器→配置MCP」，需确保URL以/mcp结尾，正确使用Authorization Bearer鉴权，解决常...

手把手教学，在 WorkBuddy 桌面版中接入 Agent 工具包-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐