Proposal: Baizhi Agent Toolkit 托管 MCP 接入与用户 API Key 配置

[ct-jaryn]

提案目的 / Proposal

Cherry Studio 维护者们好，我是百智云（Baizhi Cloud）Agent Toolkit 的维护及运营人员，通过 ct-jaryn 账号代表百智云团队提交此接入提案。

希望先征询维护者意见：是否接受为百智云 Agent Toolkit 增加一个默认关闭的托管 MCP 预设，让用户在 Cherry Studio 中选择服务、获取并填写自己的 API Key，再明确启用连接。若方向合适，我们愿意按项目规范贡献客户端实现、测试和文档，并配合后续兼容性维护。

This is a proposal from the Baizhi Cloud team for an opt-in hosted MCP integration with per-user API-key setup. We are seeking maintainer guidance before contributing implementation, tests, and documentation; this is not a claim of Cherry Studio endorsement or an already working built-in integration.

用户需求与申请范围

用户当前可以尝试通用远程 MCP 配置，但仍需手动填写地址和鉴权 Header。本提案希望减少这部分配置错误，提供清晰的 Key 获取、输入、验证、停用和撤销指引。

本次仅申请 MCP 工具服务接入，不申请模型供应商、OpenAI 兼容模型网关、默认模型或推荐排名。我们已阅读模型供应商接入政策 #13406；也理解已有托管 MCP 先例并不代表百智云自动符合收录条件。如该政策也覆盖此类 MCP 聚合工具服务，请维护者直接指出，我们会遵循项目选择。

服务信息与边界

项目	内容
名称	百智云 Agent Toolkit / Baizhi Agent Toolkit
产品介绍	https://baizhi.cloud/landing/agent-toolkit
控制台及 Key 获取入口	https://agent-toolkit.app.baizhi.cloud/
MCP 地址	https://agent-toolkit.app.baizhi.cloud/mcp
传输与鉴权	Streamable HTTP；Authorization: Bearer <用户自己的 API Key>
官方集成仓库	https://github.com/chaitin/baizhi-agent-toolkit

Agent Toolkit 是商业托管服务，需要百智云账号及用户自己的 Key，调用受账号额度、计费与权限限制。上述公开仓库提供集成清单、文档与验证代码，不包含托管服务后端源码。我们不会把集成代码开源表述为服务免费或后端开源。

初始接入文档及验收拟聚焦 websearch_search、web_scrape、web_extract 三个搜索和网页读取工具；工具实际可用性取决于服务与 Key 权限，调用也受相应费用规则约束。初始工具选择及限制方式将按维护者认可的机制实现；其他工具须由用户明确选择，并遵循相应权限与费用提示。

拟议用户流程

1. 用户在内置 MCP 列表中选择百智云，看到服务说明、收费提示和控制台链接；未配置时不建立连接。
2. 用户填写原始 API Key，无需自行拼接 Bearer；输入应遮罩显示。空值及纯空白值阻止启用。
3. 用户明确启用后，由客户端使用原生 Streamable HTTP 连接，在运行时生成鉴权 Header。不给现有服务器追加配置，不改变用户已有 MCP 连接。
4. 用户查看连接状态、发现工具并自主决定启用范围。鉴权失败、权限不足、额度不足和网络故障应有适当提示，避免日志或错误信息泄露 Key。
5. 提供停用、删除配置及在百智云撤销 Key 的说明；保留 Cherry Studio 的工具审批机制，不为此集成默认开放自动批准。

凭据保存应复用维护者认可的客户端机制。遮罩输入不等于加密存储，文档会准确说明实际存储、导出和备份行为，不提前承诺未验证的安全属性。请求参数和相关内容会发送到百智云托管服务，用户应了解费用与数据处理规则，并只授予需要的权限。

建议实现路径

我们检查了 main 的内置 MCP 预设及已合并的 QVeris 托管集成 #18354。固定核查版本为 17faa3cdcf07fcf80c36dbf72b41b12601bf159b。

建议采用固定端点的内置预设；目前不需要同步远程服务器目录。预期改动包括预设、Key 获取与输入说明、必要的运行时 Header 映射和启用校验、界面翻译、回归测试以及接入文档。具体结构以维护者对当前架构的建议为准。

QVeris 的存在只是可供讨论的技术先例；我们不会直接沿用其信任或自动批准策略，也不假设仅添加一个目录条目即可完成安全的凭据流程。

验证及文档计划

• 自动测试：默认关闭；未提供 Key、空白 Key；凭据到 Header 的映射；敏感信息脱敏；重复添加和已有配置保留；停用及删除。
• 客户端验收：在隔离测试配置中验证首次设置、重启后读取、工具发现、至少一次选定工具调用以及鉴权失败处理；区分 Windows、macOS、Linux 的实际验证范围。
• 文档：服务和收费说明、获取/撤销 Key、设置步骤、工具权限及审批、故障排查、凭据存储边界、卸载方式和支持入口。
• 测试仓库与公开 CI 只使用合成凭据或受控模拟服务。真实联调凭据不写入源码、Issue、PR、示例或日志。

当前阶段仅完成公开文档和源码路径调研，尚未实现或完成 Cherry Studio 的生产端到端验收。其他客户端的接入结果不会替代这里的验证。

替代方案及希望确认的问题

如果项目不接受新的内置托管 MCP 预设，我们也愿意先提供标准手动配置教程，或采用维护者认可的外部目录方式，不要求增加核心供应商负担。

希望确认：

1. 这一可选 MCP 预设是否符合当前项目方向？是否有额外的供应商审核或合作要求？
2. 建议复用现有内置预设与配置流程，还是应采用其他扩展入口？
3. 若可以推进，是否先按确认后的范围向 main 提交客户端 PR，并同步向文档仓库提交说明？

已检查公开 Issue、PR 与 Discussions 中的 baizhi 和服务地址，未找到同项申请。本讨论不是重复的上架请求，也不要求绕过审核。感谢维护者的时间，百智云团队希望在尊重项目架构、用户选择和安全要求的基础上开展友好合作。