Skip to content

Commit f27cfee

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

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

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

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ type: guide
44
title: Migrate a Python MCP server to the 2026-07-28 specification
55
summary: Update a Python MCP server for the stateless 2026-07-28 specification by removing the initialize handshake, adopting the input_required round-trip, dropping deprecated features, and hardening authorization.
66
lang: en-US
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
# Migrate a Python MCP server to the 2026-07-28 specification
@@ -33,8 +33,9 @@ and your authorization path satisfies the new issuer rules.
3333
`resultType: "input_required"` plus the requests that need answers; the client retries
3434
the original call with the answers attached in `inputResponses`.
3535
- **Per-request version and routing headers (SEP-2243).** `MCP-Protocol-Version`
36-
travels with every request (`2026-07-28`), and Streamable HTTP requests must include
37-
`Mcp-Method` and `Mcp-Name` so infrastructure can route without parsing JSON bodies.
36+
travels with every request (`2026-07-28`). Streamable HTTP requests must include
37+
`Mcp-Method`; `Mcp-Name` is required only for `tools/call`, `resources/read`, and
38+
`prompts/get`, matching the named parameter in each request.
3839
- **Authorization hardening.** Authorization servers must return the `iss` parameter per
3940
RFC 9207 (SEP-2468), clients must set `application_type` during dynamic registration
4041
(SEP-837), and client credentials are issuer-bound — never reused across authorization
@@ -64,8 +65,9 @@ and your authorization path satisfies the new issuer rules.
6465
5. **Upgrade the official Python SDK.** The TypeScript, Python, Go, and C# SDKs shipped
6566
with the specification; the RC-to-final window was roughly ten weeks, so older SDK
6667
versions predate the breaking changes.
67-
6. **Update transports.** Drop the legacy HTTP+SSE transport on its one-year offramp and
68-
emit the required `Mcp-Method` and `Mcp-Name` headers on Streamable HTTP.
68+
6. **Update transports.** Drop the legacy HTTP+SSE transport on its one-year offramp. On
69+
Streamable HTTP, send `Mcp-Method` on every POST and `Mcp-Name` only on
70+
`tools/call`, `resources/read`, and `prompts/get`.
6971
7. **Check the authorization path.** Validate `iss` per RFC 9207, set `application_type`
7072
during registration, and keep one credential per issuer.
7173
8. **Adopt caching metadata.** Annotate list responses with `ttlMs` and `cacheScope` so

0 commit comments

Comments
 (0)