Description
希望为现有“工具与 MCP”指南补一个需要 Bearer 鉴权的 Streamable HTTP 使用例子。先确认品牌示例的范围,避免将外部服务硬编码成内置 provider。
当前中文 MCP 小节主要展示 SSE 地址和 exclude,英文页对应同一入口。当前 MCPClient已能把 headers 传给 Streamable HTTP transport,并由 ToolManager 注册和调度工具。对带 Key 的远端服务,读者仍需要一个把配置、凭据来源、工具范围与清理串起来的具体例子。
拟议文档范围:
- 在现有中英文页面补同一份简短例子,使用现有
mcpServers / headers / include 接口;不增加 SDK 依赖、传输实现或搜索 provider。
- 明确由示例代码读取环境变量并组装 Bearer Header;不把原始 JSON 中的
${VAR} 写成自动插值,也不混淆 stdio 子进程 env 与远端 Header。
- 先发现当前服务工具及 Schema,再选择明确工具范围;展示一个中文公开资料检索任务,保留来源和未知项,不编造返回字段或日期。
- 说明发现成功、业务调用成功是两层验收;使用现有连接清理路径,并为认证拒绝、业务
isError 和超时保留失败结果,不循环重试付费调用。
关联披露:我在参与百智云 Agent Toolkit 的接入推广,希望以该服务作为可选例子。它需用户自己的账号和 Key,工具调用可能收费,参数会发送到托管服务;公开仓只描述集成,不代表服务端开源。也可以让上游页面保持通用占位例子,把百智配置放独立社区指南。
此次检查基于当前源码 a56afcc,没有调用真实 MCP 或模型,也没有宣称与已发布 PyPI 版本完成兼容验收。拟实现时先固定实际版本,以合成服务走 MCPClient → ToolManager 注册/调用/清理链路,再记录生产验证的独立边界。
这样的文档补充是否适合现有 Tools 页面?维护者更倾向保留通用示例,还是接受一个带上述披露的可选服务例子?
Description
希望为现有“工具与 MCP”指南补一个需要 Bearer 鉴权的 Streamable HTTP 使用例子。先确认品牌示例的范围,避免将外部服务硬编码成内置 provider。
当前中文 MCP 小节主要展示 SSE 地址和
exclude,英文页对应同一入口。当前MCPClient已能把headers传给 Streamable HTTP transport,并由 ToolManager 注册和调度工具。对带 Key 的远端服务,读者仍需要一个把配置、凭据来源、工具范围与清理串起来的具体例子。拟议文档范围:
mcpServers/headers/include接口;不增加 SDK 依赖、传输实现或搜索 provider。${VAR}写成自动插值,也不混淆 stdio 子进程env与远端 Header。isError和超时保留失败结果,不循环重试付费调用。关联披露:我在参与百智云 Agent Toolkit 的接入推广,希望以该服务作为可选例子。它需用户自己的账号和 Key,工具调用可能收费,参数会发送到托管服务;公开仓只描述集成,不代表服务端开源。也可以让上游页面保持通用占位例子,把百智配置放独立社区指南。
此次检查基于当前源码
a56afcc,没有调用真实 MCP 或模型,也没有宣称与已发布 PyPI 版本完成兼容验收。拟实现时先固定实际版本,以合成服务走 MCPClient → ToolManager 注册/调用/清理链路,再记录生产验证的独立边界。这样的文档补充是否适合现有 Tools 页面?维护者更倾向保留通用示例,还是接受一个带上述披露的可选服务例子?