Skip to content

[tool] Document authenticated Streamable HTTP MCP setup #1003

Description

@ct-jaryn

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 页面?维护者更倾向保留通用示例,还是接受一个带上述披露的可选服务例子?

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions