Skip to content

Commit 953bec6

Browse files
committed
docs: correct conditional MCP request headers
1 parent f27cfee commit 953bec6

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

‎guides/mcp/migrate-2026-07-28_cn.md‎

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ type: guide
44
title: 将 Python MCP 服务端迁移到 2026-07-28 规范
55
summary: 面向 2026-07-28 无状态规范更新 Python MCP 服务端,移除 initialize 握手、采用 input_required 多轮交互、放弃废弃特性并强化授权。
66
lang: zh-CN
7-
content_version: 1
7+
content_version: 2
88
status: reviewed
9-
reviewed_on: 2026-09-06
9+
reviewed_on: 2026-10-31
1010
---
1111

1212
# 将 Python MCP 服务端迁移到 2026-07-28 规范
@@ -30,8 +30,9 @@ Foundation 管理,Python SDK 已随规范同步发布。
3030
返回带 `resultType: "input_required"` 的结果以及待回答的请求;客户端携带
3131
`inputResponses` 重试原始调用。
3232
- **按请求传递版本与路由头(SEP-2243)。** `MCP-Protocol-Version` 随每个请求传递
33-
(值为 `2026-07-28`),Streamable HTTP 请求必须携带 `Mcp-Method` 和 `Mcp-Name`,
34-
让基础设施无需解析 JSON 请求体即可路由。
33+
(值为 `2026-07-28`)。Streamable HTTP 请求必须携带 `Mcp-Method`;仅
34+
`tools/call`、`resources/read` 和 `prompts/get` 需要 `Mcp-Name`,其值对应
35+
请求体中的名称或 URI。
3536
- **授权强化。** 授权服务器必须按 RFC 9207 返回 `iss` 参数(SEP-2468),客户端在
3637
动态注册时必须设置 `application_type`(SEP-837),客户端凭据与发行方绑定——绝不
3738
能跨授权服务器复用(SEP-2352)。
@@ -59,8 +60,9 @@ Foundation 管理,Python SDK 已随规范同步发布。
5960
用,但新代码不应再依赖它们。
6061
5. **升级官方 Python SDK。** TypeScript、Python、Go 和 C# SDK 已随规范发布;从 RC
6162
到正式版大约有十周窗口,更早的 SDK 版本早于这些破坏性变更。
62-
6. **更新传输层。** 在一年过渡期内下线传统 HTTP+SSE 传输,并在 Streamable HTTP 上
63-
输出必需的 `Mcp-Method` 与 `Mcp-Name` 头。
63+
6. **更新传输层。** 在一年过渡期内下线传统 HTTP+SSE 传输;Streamable HTTP 的每个
64+
POST 都需携带 `Mcp-Method`,且 `tools/call`、`resources/read` 和 `prompts/get`
65+
请求还需携带 `Mcp-Name`。
6466
7. **检查授权链路。** 按 RFC 9207 校验 `iss`,注册时设置 `application_type`,每个
6567
发行方使用独立凭据。
6668
8. **采用缓存元数据。** 为列表响应标注 `ttlMs` 与 `cacheScope`,让无状态基础设施

0 commit comments

Comments
 (0)