MCP HTTP 端点

​

统一端点

• 端点: http://localhost:3000/mcp
• 方法: POST

​

特定群组的端点

• 端点: http://localhost:3000/mcp/{group}
• 方法: POST
• 参数:
  • {group}: 群组的 ID 或名称。

​

特定服务器的端点

• 端点: http://localhost:3000/mcp/{server}
• 方法: POST
• 参数:
  • {server}: 服务器的名称。

注意: 如果服务器名称和群组名称相同，则群组将优先。

​

协议兼容矩阵

​

Elicitation 转发

​

客户端迁移

1. 将旧 SSE 客户端传输改为 HTTP 传输，将 /sse 改为 /mcp，保留原有群组、 服务器或用户路由范围，以及 Bearer 凭据。旧版 HTTP 客户端可以先完成传输迁移， 继续使用原有初始化和会话生命周期。
2. 要采用 2026-07-28，需使用支持新版 HTTP 发现机制及逐请求元数据的客户端。 SDK v2 HTTP 客户端会自动设置协议和路由请求头。自定义客户端需发送常规 JSON-RPC 请求体，将 params._meta["io.modelcontextprotocol/protocolVersion"] 设为 2026-07-28，并在 params._meta["io.modelcontextprotocol/clientCapabilities"] 中声明客户端能力。 同时发送一致的 MCP-Protocol-Version 和 Mcp-Method 请求头；tools/call 和 prompts/get 需要与 params.name 一致的 Mcp-Name，resources/read 则需要与 params.uri 一致。工具名称应使用该路由列表响应中的名称。
3. 使用 perSessionClient 或 OpenAPI cookieSession 工具时，为每个独立工作流 生成 UUID v4，并通过工具调用的 X-MCPHub-State-Id 请求头发送。无法设置该 扩展的已认证 OpenAI/ChatGPT 工具调用，在显式请求头缺失时也可复用客户端声明的 _meta["openai/session"] 会话提示。MCPHub 会先对该提示做哈希；它只用于状态 关联，不用于认证。显式状态请求头一旦存在但非法，将直接失败而不会回退。无状态 工具无需这两个值。只有相同 Bearer 凭据、用户和路由才能复用状态。状态仅保存在 当前进程中，闲置 30 分钟后过期，多副本部署需要粘性路由。进程重启、状态过期或 凭据、路由变化后需要重新建立应用状态。参见 显式状态配置。
4. 使用实际权限验证工具列表和调用，再验证所用的资源读取及 MCP Apps 功能。 新版 Apps 宿主需在每次请求中声明 UI 能力。新版调用不依赖 Mcp-Session-Id 或 enableSessionRebuild，这两者仍属于旧版机制。

​

缓存行为

​

旧版 SSE 弃用计划

​

保留路由范围和认证

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'my-client', version: '1.0.0' });
await client.connect(
  new StreamableHTTPClientTransport(new URL('https://hub.example.com/alice/mcp/my-group-id'), {
    requestInit: { headers: { Authorization: 'Bearer YOUR_EXISTING_KEY' } },
  }),
);
const tools = await client.listTools();
// 使用返回的工具名；在整个工作流中复用此客户端。
await client.close();

​

就绪条件和移除边界

• 包含公开通知的版本、实际发布日期，以及移除时已满 12 个日历月的依据。
• 整个窗口内旧版 SSE 和 Streamable HTTP 兼容性测试持续通过，覆盖认证后的 全局、分组、服务器和用户路由，会话续接／重建及有状态工具隔离。
• 每个文档列出的客户端集成的迁移清单：HTTP transport、保留路由／认证、 列表和调用成功，以及实际使用的资源、Apps 或有状态工作流。记录测试版本 和未解决阻碍；阻碍发布的迁移缺陷必须为零。可补充部署者确认，不能把 缺少遥测当作无人使用 SSE 的证据。
• 中英双语发布说明和文档、提前 90 天和 30 天的提醒，以及仍使用 SSE 的 部署的支持渠道。