> ## Documentation Index
> Fetch the complete documentation index at: https://www.bazhuayu.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# WorkBuddy：连接指定 App
> 先选择固定 Data App，再将该能力接入 WorkBuddy 并完成真实调用。
这篇教程适合**已经知道要使用哪个 Data App** 的用户。你会先在市场中选择并试跑具体 App，再复制这个 App 的安装提示词，把它作为固定连接器加入 WorkBuddy。
本文采用“先选 App，再连接”的指定 App 模式。如果你还不知道该选哪个 App，希望先连接 MCP、再让 Agent 搜索，请改用 通用连接：在 Agent 中选择 App。
WorkBuddy 与 Codex 使用的是同一套 DataHub MCP 能力。不同之处只是 WorkBuddy 会通过连接器界面展示启用和信任状态，Data App 的能力并没有变化。
## 完成后你能做什么
完成本教程后，你可以直接在 WorkBuddy 中描述数据需求，让它调用 DataHub 的 Data App 获取结构化数据。本文同时说明单个 Data App 和多个 Data App 的连接方法。
## 开始前
请准备好：
* 一个能够正常登录的八爪鱼账号。
* 已安装并登录的 WorkBuddy 客户端。
* 一个明确的小范围测试目标，例如目标平台、关键词和返回数量。
API Key 相当于账号凭证。不要把真实 Key 放进项目文件、代码仓库、公开截图或群聊，只在 WorkBuddy 的可信凭证输入或明确请求环节中使用。
## 第一步：选择并试跑 Data App
先在网页端确认 Data App 的输入和输出，再连接 WorkBuddy。这样后续出现问题时，可以快速区分是参数不正确，还是连接器没有配置好。
访问 Data Hub 市场，点击右上角账号入口完成登录。
使用搜索或分类找到目标应用。进入详情页后，认真查看能力说明、必填参数、返回字段和价格，确认它适合当前任务。
点击“立即体验”，按页面提示填写参数。第一次只请求少量数据，运行完成后检查状态、条数和关键字段。
如果网页端没有得到结果，请先调整参数或更换 Data App。网页端验证成功后，再继续连接 WorkBuddy。
## 第二步：复制 WorkBuddy 安装提示词
在 Data App 详情页打开“调用方式”，选择 MCP，然后复制“让 AI 自己完成配置”的完整提示词。也可以通过详情页侧边栏的 MCP 入口快速进入。
第一次连接建议只选择一个 Data App。工具越少，WorkBuddy 越容易识别正确能力，排查问题也更简单。
## 第三步：创建 DataHub API Key
按照 获取 API Key 教程进入八爪鱼用户中心，创建新的 API Key。
Key 通常只在创建时完整显示。请暂时保存在可信密码管理工具中，不要保存到项目目录或普通共享文档。
本篇从 Data App 详情页生成的指定 App 配置使用 API Key。配置中的 `Authorization: Bearer ` 是 API Key 的请求头传递格式。通用连接另支持 OAuth，请不要把两种教程中的配置片段混用。
## 第四步：在 WorkBuddy 中安装连接
新建一个 WorkBuddy 对话，粘贴刚才复制的完整安装提示词并发送。WorkBuddy 会读取服务地址和配置要求，并在需要时请求 API Key。
仅在可信的凭证输入环节或 WorkBuddy 明确请求时提供 API Key。确认连接地址来自 Data App 当前“调用方式”页面，不要使用来源不明的地址。
打开 WorkBuddy 的连接器管理界面，找到刚创建的 DataHub MCP 连接。核对名称和服务来源后，启用并信任该连接器。
如果连接器启用后没有立即出现工具，请重新加载 WorkBuddy；找不到重新加载入口时，关闭并重新打开客户端。
## 第五步：执行第一次真实调用
使用清楚、具体的自然语言提出需求，最好包含平台、筛选条件和数量。例如：
```text theme={null}
请使用刚才连接的 DataHub 工具，查询与“AI Agent”相关的数据，先返回 5 条，并列出标题、来源、发布时间和链接。
```
观察对话中的工具调用或连接器记录。只有出现对应 DataHub 工具调用，才说明 WorkBuddy 真正访问了 Data App。
检查返回条数、核心字段和内容是否符合预期。如果只得到普通说明文字，可以明确要求“请调用刚连接的 DataHub 工具”。
## 可选：让 WorkBuddy 使用多个 Data App
当同一个工作流确实需要多项能力时，可以创建自定义工具集，将多个 Data App 放入同一个 MCP 连接。
从 Data Hub 进入开放平台，打开“MCP 连接”，然后进入“自定义工具集”。
只选择当前流程真正需要的应用。工具过多会增加 WorkBuddy 选择错误工具的概率。
保存工具集后，复制页面当前生成的完整安装提示词。
将多 App 安装提示词发送给 WorkBuddy，按提示更新连接器并重新加载。然后先让 WorkBuddy 列出可用能力，再逐个测试所选 App。
## 常见问题
检查连接器是否已启用并信任，然后重新加载或重启 WorkBuddy。仍未出现时，重新核对安装提示词中的服务地址与请求头。
确认 Key 没有缺字符、空格或换行，并检查它是否仍然有效。本篇使用指定 App 页面生成的 API Key 配置；如果需要 OAuth，请改用通用连接页面生成的配置。
在问题中明确写出“请使用刚连接的 DataHub 工具”，并给出 Data App 支持的参数。也可以先让 WorkBuddy 列出当前可用连接器和工具。
使用网页端成功的同一组参数再次测试，逐项检查 API Key、连接地址、连接器信任状态和 WorkBuddy 日志。第一次请求保持数据量较小。
在开放平台保存工具集，重新复制当前提示词并更新 WorkBuddy 连接器，然后重新加载客户端。工具集变化不会自动同步。
## 完成检查
* 已在网页端用少量数据成功试跑 Data App。
* 已从 Data App 当前“调用方式”页面复制安装提示词。
* API Key 只保存在可信的本地配置或凭证工具中。
* WorkBuddy 连接器已启用并信任，且能看到对应工具。
* 已完成一次真实工具调用，并核对返回条数和关键字段。
不预选 App，连接后让 Agent 搜索并运行合适的数据能力。
如果你使用 Codex，请查看对应的固定 App 完整流程。