范围与前提
准备可访问的公共 HTTPS MCP endpoint、账户授权和一个用于验收的可控工具。配置 endpoint 不接受用户名、密码、query 或 fragment,凭据单独提交。authentication 可为 none、bearer 或 header;header 模式使用 header_name,默认 x-api-key。公开服务显式设置 none,不需要虚构 Token。 本接口不开放 stdio、本机进程启动、resources/prompts 订阅、sampling 或 elicitation,也不自动注册任意 MCP OAuth 客户端或刷新 Token。OAuth-only 服务需要外部获得适用的 Bearer Token,并自行续期。不能从“支持 MCP”推断所有扩展可用。发现、选择和启用
先在你控制的服务中准备一个返回已知内容的工具,环境变量 MCP_TOOL_NAME 填其精确名称。下面保留默认 approval=true;发现后应审阅工具名称、描述和 schema,再保存选择。工具描述是外部数据,不能作为新增权限的指令。 以下是本地管理客户端示例,凭据来自私有环境;hosted 初始化见自托管。每次运行创建连接,保存 ID 后复用。从 Session 调用
按 Tools 指南将 connection.id 绑定到tools: {research: connection_id},使用支持 Tools 的 Harness,并完成 Session 预检。默认必需工具的授权在初始化时检查;可选工具仍需调用时授权。
提交明确任务:调用所选工具读取专用测试对象,并报告其已知内容。保留 approval=true 时先检查等待审批,再按审批指南批准;拒绝分支应确认远端没有实际调用。只读 annotation 不会自动关闭审批,需要由管理员明确审阅策略。
核对 Tool 调用记录和实际结果,不能只看最终自然语言回答。修改或过期的凭据按授权指南处理;原始 Token 留在控制平面,不进入 Sandbox env。
解释结果与工具变化
MCP 可以返回有效结果,同时包含isError: true。Hexagon 已取得结果,因此调用记录可为 completed;应检查 Tool 调用中的 is_error 和实际结果,不能把 completed 等同于业务成功。有效的 Tool 错误与派发后响应丢失不同,后者的远端结果可能仍未知。
保留经过审查的选定工具定义。远端新增工具,不会授权既有 Session 调用它。选定工具的名称、描述或 schema 变化需要重新发现并审查;不要通过修改本地 hash key 来伪装为旧工具、绕过变化检测。审批策略与远端只读 annotation 独立,annotation 不授权取消人工同意。
网络与重试边界
连接时检查 DNS 结果,拒绝私有或混合地址,拒绝重定向与跨 origin SSE POST 目标。伪 IP DNS 可能被拒绝,不能为方便而关闭检查。管理员可按现有受信出站代理与精确主机名单机制配置网络,见部署网络。 每次调用前重新校验工具定义。tools/call 尚未开始前允许一次连接重试;一旦开始派发,丢失响应不能自动重放,即使服务把操作标为只读。所有 MCP 操作的 replay 策略为 never。 远端写入可能已完成但返回丢失,需保存原调用与请求 hash,在服务端核对后通过对账记录结论。取消 Run 不撤销外部写入;重新发现也不解决未知副作用。不要生成新的调用来“试一下”原操作是否成功。一个具体的发现到调用实例
历史公开服务实例使用https://mcp.deepwiki.com/mcp、authentication: none、Streamable HTTP,选中的远程工具名为 read_wiki_structure,查询仓库为 modelcontextprotocol/typescript-sdk。公开服务省略 credential,不要原样套用前面的 bearer 示例;选择工具时保留发现返回的 key。管理员仍须审阅发现的 schema 与审批策略,再启用连接。
11 月 18 日记录分别使用 TypeScript 的 Vercel/Pi 1.5.2 Session 和 Python 的 Vercel/OpenCode 1.2.27 Session,模型均为已配置的 SiliconFlow international DeepSeek-V4-Flash。它核对了实际完成的调用与返回的文档主题,并确认清理。操作人员明确关闭了该只读工具的审批,因此这条记录不能证明拒绝审批分支或远程写入,也不能证明今天的服务可用性。
仓库依赖为
@modelcontextprotocol/sdk 1.32.2。不能把 fixture 选择的协议版本抄成公开服务的验证版本;SDK 版本与协商后的协议版本是两个不同字段。