[Content] 补充自定义 MCP 连接器的验证与故障定位流程

[ct-jaryn]

相关页面 / Related page

第 7 章「WorkBuddy 使用连接器」的「新建连接器」小节。

问题或建议 / Problem or suggestion

当前章节已经说明自定义连接器需要服务地址和鉴权方式，但读者仍缺少一条判断“配置保存了”是否等于“工具真的可用”的验证路径。希望补充从连接、工具发现到一次受控调用的排查表，帮助读者区分地址/传输错误、凭据问题、空工具列表和工具执行错误。

这是教程范围建议。我尚未完成 WorkBuddy 客户端的实际操作与截图验收，因此不把它作为已跑通的社区 Case，也不声称 WorkBuddy 的特定版本已经兼容下面的可选服务。

建议内容 / Proposed change

建议先确认以下内容是否适合放在现有小节，再准备文档：

1. 记录 WorkBuddy 版本和自定义连接器实际支持的传输、鉴权字段；区分 MCP 服务地址和第 9 章的模型 API 地址，不猜测界面字段或凭据插值方式。
2. 用一张检查表解释服务连接、工具列表、参数结构检查、用户确认的一次低风险调用和结果验收。工具名与参数以实际发现为准。
3. 给出失败时的停止条件：401/403 核对授权，超时或限流不自动循环调用；分享排错信息前移除 Key 和敏感参数。
4. 说明远端工具参数会发送给服务方、返回结果可能进入模型上下文，并在首次调用前确认计费和允许的数据范围。

正文以通用流程为主。如果社区接受一个可选的静态 Bearer 示例，可考虑百智云工具包的 Streamable HTTP 地址 https://agent-toolkit.app.baizhi.cloud/mcp；需要用户自己的 Key，调用可能收费。示例不能替代针对 WorkBuddy 的真实验证，正式教程需要补足版本、实际配置和脱敏结果证明。

我维护百智相关社区集成，正在参与百智集成的社区推广。这里不请求将其设为默认连接器，也不提交品牌介绍段落。我看到了 #28 的第三方模型网关说明未被合并；本提案希望确认的是 MCP 验证/排错教学范围，品牌示例是否需要省略也请维护者决定。

参考资料 / Sources

• 第 7 章当前源码，核对日期：2026-09-22。
• 贡献指南与Case 投稿条件。
• 百智公开客户端文档：地址、Bearer、费用和验证边界。这是其他宿主的公开集成资料，仅用于服务信息来源，不作为 WorkBuddy 兼容性证明。

[modelpath-dev]

It seems like there's a need for a clearer validation and troubleshooting guide for custom MCP connectors in the WorkBuddy documentation. I'd check the current section to see how it addresses these concerns and what might be missing.