無狀態 MCP 伺服器到底改了什麼?
MCP 2026-07-28 修訂版移除工作階段與 initialize 交握,本文說明對反向代理、健康檢查、逾時設定及驗證機制的實際影響。
無狀態 MCP 伺服器的定義
無狀態 MCP 伺服器不會在請求之間保留每個用戶端的狀態。每個請求都會攜帶通訊協定版本、用戶端功能,以及伺服器回應該請求所需的認證資訊。因此,任何機器上的任何程序都能處理任何請求。MCP(Model Context Protocol,代理程式用來存取工具的線上格式)在修訂版 2026-07-28 中將此列為規則,並移除了 initialize 交握流程及其下層的 HTTP 工作階段。本節只說明該通訊流程的伺服器端;如果你還不熟悉代理程式端,循序學習 AI 代理程式的路徑會先說明代理程式決定呼叫工具的流程,再進入這些 HTTP 細節。
這就是它在操作上的全部意義。伺服器不保留每個用戶端的狀態,就能放在一般負載平衡器後方,不需要工作階段黏著;部署期間也能重新啟動而不會中斷用戶端,還能以 4 個相同的程序執行,而不是只能執行 1 個。以工作階段為核心的伺服器若沒有額外機制,無法具備上述任何一項特性。
Model Context Protocol 是無狀態通訊協定:處理請求所需的所有資訊都包含在請求本身。伺服器會獨立處理每個請求;不應根據先前的請求推斷狀態,即使這些請求使用相同的連線或串流。
無狀態不代表伺服器不儲存任何資料。你的資料庫、佇列與快取仍然存在。它表示連線上的通訊協定不攜帶狀態,因此伺服器不得將連線、程序或開啟的 socket 視為「這個用戶端目前正在進行中的對話」的替代物。若應用程式本身已管理資料,這種區分最容易理解:openGym 的唯讀 MCP 伺服器會回答關於訓練歷史的問題,而這些資料儲存在應用程式自己的資料庫中;該儲存內容與特定請求抵達時使用的連線無關。
2026-07-28 移除了哪些內容
截至 2026 年 8 月,2026-07-28 是規格的目前版本。與 2025-11-25 相比,它移除了 5 項原本用於支援工作階段的內容。
initialize請求與notifications/initialized通知。不再進行任何交握(SEP-2575)。Mcp-Session-Id標頭,以及使用 HTTPDELETE終止工作階段的機制(SEP-2567)。- 伺服器用來推送通知的獨立 HTTP
GET串流。現在改用subscriptions/listen,也就是回應為長時間存續串流的一般 POST。 - SSE(server-sent events)串流續接功能。
Last-Event-ID標頭與每個事件的 ID 已移除,因此串流中斷時,進行中的請求會遺失,客戶端必須以新的請求 ID 重新發出請求。 ping、logging/setLevel與notifications/roots/list_changed。記錄層級現在是每個請求的欄位,位於_meta中的io.modelcontextprotocol/logLevel。
規格新增了 1 個方法,而且每部伺服器都必須實作。server/discover 會在單次呼叫中回傳伺服器支援的通訊協定版本、功能與身分資訊。這是目前最接近交握的機制,但客戶端不一定要呼叫它。
為何 session transport 難以在正式環境中執行
在 2025-11-25 及更早版本中,伺服器可以在初始化時產生 session ID,並在 InitializeResult 的 Mcp-Session-Id 標頭中回傳。之後,客戶端必須在每個後續請求中傳送該標頭。協議協商版本與客戶端功能都儲存在伺服器記憶體中,並以該 ID 作為索引。這些設計各自都會增加維運成本。
- 重新啟動會清除 session table。規格要求伺服器對帶有失效 session ID 的請求回覆
404 Not Found,也要求客戶端以新的InitializeRequest重新開始。每次部署都會讓所有已連線的客戶端重新連線。 - 第二個 replica 不知道第一個 replica 的 sessions。擴充規模時,必須在 load balancer 上使用 sticky routing,或使用每個 replica 在每次請求中都讀取的共用 session store。
- session table 會隨著閒置客戶端增加而占用更多記憶體。
DELETE為選用項目;客戶端若在未傳送該項目時關閉連線,對應的項目就會殘留。 - 每個連線取得的清單結果可能不同,因此在伺服器前方加入快取並不安全。
移除 sessions 後,這 4 個問題會同時消失。在修改任何設定前,應先理解這項變更。
現在每個請求都會攜帶的內容
對 MCP endpoint 的每個 POST 都是獨立處理的。通訊協定版本與用戶端功能會放在請求主體的 _meta 中傳送,部分欄位也會複製到 HTTP 標頭,讓中介設備無須解析 JSON 即可依這些欄位進行路由。
POST /mcp HTTP/1.1
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: get_weather
Authorization: Bearer <access token>
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_weather",
"arguments": {"location": "Seattle, WA"},
"_meta": {
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": {"name": "ExampleClient", "version": "1.0.0"},
"io.modelcontextprotocol/clientCapabilities": {}
}
}
}每個請求都必須包含 io.modelcontextprotocol/protocolVersion 與 io.modelcontextprotocol/clientCapabilities。clientInfo 並非必要,但用戶端應傳送該欄位。缺少必要欄位的請求屬於格式錯誤,因此伺服器必須以 JSON-RPC 錯誤 -32602 和 HTTP 400 Bad Request 拒絕該請求。
每個請求都必須包含 Mcp-Method 標頭。Mcp-Name 必須出現在 tools/call、resources/read 和 prompts/get。標頭值必須與主體中的值一致。處理請求主體的伺服器若發現值不一致,必須以 400 Bad Request 和錯誤碼 -32020、HeaderMismatch 拒絕請求。這項規則是必要的,因為負載平衡器可能依標頭進行路由,而伺服器則依主體執行,兩者的資料來源並不相同。如果依這些標頭進行路由或速率限制,請先檢查 MCP-Protocol-Version:較早的修訂版本不會驗證標頭與主體是否一致,因此在這些版本中,標頭值不可信。
現在,版本不一致會成為一般的個別請求錯誤,不再造成交握失敗。未實作所要求版本的伺服器會以 400 Bad Request 回應,並附上錯誤 -32022、UnsupportedProtocolVersion,同時在 data.supported 列出支援的版本。用戶端會從該清單選擇一個版本,然後重試。
狀態去了哪裡:權杖、游標與訂閱
狀態並沒有消失,而是移到可查看及記錄的位置。
憑證會隨每個請求傳送。 沒有可附加身分的工作階段,因此存取權杖會隨每次 HTTP 呼叫傳送,並在每次呼叫時驗證。詳細資訊請參閱下方的驗證章節。
游標必須攜帶自己的位置。 tools/list、resources/list、prompts/list 與 resources/templates/list 的分頁使用不透明的游標字串,客戶端不得剖析或修改。單一程序伺服器通常會依工作階段將位移保存在記憶體中。沒有工作階段時,游標必須提供足夠資訊,讓任何複本都能繼續列出內容。因此,請將位置編碼至游標中並簽署,或將位置儲存在所有複本共用的儲存區中。無效的游標應回傳 -32602。之所以必須簽署,是因為不透明游標仍是由客戶端提供的輸入,而程式會解碼並信任其中內容。
訂閱屬於請求,而不是連線。 需要變更通知的客戶端會傳送 subscriptions/listen,並以篩選器指定所需類型:toolsListChanged、promptsListChanged、resourcesListChanged 與 resourceSubscriptions。伺服器會回覆 notifications/subscriptions/acknowledged,並保持該回應串流開啟。如果串流中斷,伺服器不會保留任何狀態,客戶端會重新傳送 subscriptions/listen 以恢復訂閱。
跨呼叫的應用程式狀態會變成明確的控制代碼。 當伺服器確實必須在呼叫之間記住某些內容時,規格提供的做法是由伺服器產生識別碼,再以一般工具引數傳回。該識別碼會出現在工具結構描述中,可寫入日誌,且不會由連線隱含提供。具有實際個別使用者資料的伺服器,例如 自行託管的 MCP 電子郵件伺服器,會採用此模式,而不是使用工作階段:信箱或草稿識別碼會作為工具引數,因此任何複本都能處理下一次呼叫。許多工具完全不需要控制代碼:由自有 SearXNG 執行個體支援的搜尋工具接收查詢並傳回結果,不需要為下一次呼叫保留任何狀態,也不必在意是哪個複本回應。
部署:反向代理、逾時與健康檢查
MCP endpoint 是一個接受 POST 的路徑。大多數流量都是短請求與 JSON 回應,任何代理都能處理。例外是串流回應,此時代理的預設值反而會造成問題。從筆記型電腦上的示範環境移至在 VPS 上執行的 MCP 伺服器時,這是需要調整的部分。
location /mcp {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_read_timeout 1h;
proxy_send_timeout 1h;
}proxy_buffering off 很重要,因為 nginx 預設會緩衝代理回應,直到緩衝區填滿或回應結束後,才傳送 SSE 事件。規格也要求伺服器在 SSE 回應中傳送 X-Accel-Buffering: no,而 nginx 會遵循該標頭,因此正確的伺服器會自行告知代理正確設定。不過仍應設定這項 directive,因為這是由你控制的另一半。
proxy_read_timeout 的預設值是 60 秒。閒置時間超過此值的 subscriptions/listen 串流會由 nginx 關閉,而不是由伺服器關閉,因此日誌會顯示程序正常運作,但用戶端會顯示串流中斷。只在 MCP location 上調高此值,不要套用到整台伺服器。伺服器也應在閒置期間傳送 SSE 註解行(以冒號開頭的行)作為 keep-alive,這樣可避免中介設備因逾時而關閉串流。
Caddy 需要的設定較少。為提高傳輸效率,Caddy 預設會進行部分緩衝;當回應帶有 Content-Type: text/event-stream 時,會立即 flush,因此不需額外 directive 即可支援串流。
mcp.example.com {
reverse_proxy 127.0.0.1:8080 {
health_uri /healthz
health_interval 10s
}
}請注意該健康檢查的目標。不要使用 GET 將主動檢查指向 MCP endpoint,因為只實作此修訂版的伺服器會對 GET 和 DELETE 回應 405 Method Not Allowed,而 Caddy 的預設健康檢查方法是 GET。如此一來,代理會將完全正常的後端標記為停機。請提供如 /healthz 這類單純路徑供代理檢查,並另外使用 POST 檢查協定。
curl -sS https://mcp.example.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2026-07-28' \
-H 'Mcp-Method: server/discover' \
-d '{"jsonrpc":"2.0","id":"health-1","method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'帶有 supportedVersions 清單的 200 表示程序正在運作,且能使用該協定。帶有 JSON-RPC 錯誤 -32601 的 404 表示程序正在運作,但不提供 server/discover;每個 2026-07-28 伺服器都必須實作此項功能。帶有 -32022 的 400 表示檢查程式要求的版本不受此建置支援;相依性升級後,這正是你要捕捉的問題。開源版 nginx 沒有主動健康檢查,因此請在 upstream 上使用被動的 max_fails 和 fail_timeout,並從監控系統執行協定檢查。
現在執行滾動重新啟動時,只會影響處理中的請求。先排空連線,讓開啟中的 POST 完成,再啟動新程序;失敗的請求由用戶端重新送出。仍會被中斷的只有開啟中的 subscriptions/listen 串流,因為該串流是連至特定程序的即時連線。無狀態設計移除了工作階段黏著性,但沒有移除目前已開啟串流的連線黏著性,也沒有任何路由規則能解決這點。用戶端可以辨識兩種情況:以空的 subscriptions/listen 結果結束的串流表示正常關閉;未提供該結果便結束的串流表示連線中斷,用戶端可以據此重新連線。
現在終於可以使用快取。清單方法的結果會帶有 ttlMs 和 cacheScope,而 cacheScope: "public" 會告知共用中介設備可以快取該回應。這只有在清單結果不再因連線而異時才安全,而這正是移除工作階段的直接結果。
沒有工作階段時,驗證方式為何改變
有工作階段時,可以在 initialize 進行一次驗證,之後將工作階段 ID 視為後續所有操作的憑證。這樣使用的工作階段 ID 是持有者憑證,沒有受眾、到期時間或撤銷途徑,且由你自己的伺服器簽發。移除工作階段後,這個捷徑也會消失,替代方案會更加嚴格。
受保護的 MCP 伺服器會作為 OAuth 2.1 資源伺服器運作。用戶端發出的每個 HTTP 要求都必須攜帶 Authorization: Bearer <access token>,伺服器也會在每次要求中驗證權杖。驗證內容包括受眾:伺服器必須依照 RFC 8707(Resource Indicators for OAuth 2.0),確認權杖是專門發給自己的,不能接受或轉送原本供其他用途使用的權杖。用戶端會在要求中傳送 resource 參數,並填入伺服器的標準 URI,以要求正確的受眾。
探索程序會由挑戰啟動。要求抵達時若沒有可用的權杖,伺服器會回應 401 Unauthorized。
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://mcp.example.com/.well-known/oauth-protected-resource",
scope="files:read"用戶端讀取 resource_metadata,擷取該文件(RFC 9728、OAuth 2.0 Protected Resource Metadata,MCP 伺服器必須實作),找出授權伺服器並執行流程。權限不足的有效權杖會收到 403 Forbidden,其中包含 error="insufficient_scope" 以及該操作所需的範圍。
這會影響兩項執行方式。權杖驗證現在會在每次要求中進行,而不是每個工作階段只進行一次。因此,每次呼叫都連線到 introspection endpoint 的網路往返時間會反映在延遲中。優先使用可透過簽章、受眾與到期時間在本機驗證的權杖,或以權杖為鍵,將驗證結果快取一小段時間。由於沒有工作階段保存身分,授權也必須在每次呼叫時根據權杖計算。這比工作階段模型更符合實際,也符合將憑證排除在 agent 程序之外的通行做法,詳見 避免將秘密資訊放入 AI agent。範圍只會限制要求抵達你的伺服器後,權杖可以執行哪些操作;在 agent 執行所在的機器上,加入工具權限規則與預算上限的 harness 外掛程式會決定實際發出的呼叫。
此修訂版哪些內容成立,哪些內容不成立
以上內容描述的是修訂版 2026-07-28。它不代表 MCP 永遠如此,也不代表你去年部署的伺服器。
使用 2025-11-25 及更早修訂版的用戶端與伺服器,仍採用握手模型。規格將這些修訂版稱為傳統修訂版,並將每個請求都攜帶中繼資料的修訂版稱為現代修訂版。僅支援此修訂版的伺服器遇到較舊的用戶端時,應在 MCP 端點對 GET 或 DELETE 回應 405 Method Not Allowed,忽略任何 Mcp-Session-Id 標頭,不產生或回傳該標頭,並忽略 Last-Event-ID,因為串流無法恢復。支援兩個時代的伺服器可以在同一個端點提供兩種模式:帶有現代 _meta 的請求採無狀態方式處理,而 initialize 請求則選擇較舊的工作階段語意。
因此,在採信上述內容前,請先確認修訂版字串。如果你的 SDK 仍傳送 initialize,工作階段對你的部署仍然存在,上述工作階段相關問題也仍需由你管理。用戶端亦同樣如此:在你自己的主機上執行的代理程式,例如 在 VPS 上執行程式碼代理程式,只有在其使用的程式庫採用現代修訂版時,才符合此處所稱的無狀態。請讀取執行環境協商出的版本,再閱讀相符的規格修訂版,並將本頁視為對某個指定修訂版的說明,而非對整個通訊協定的概括描述。
FAQ
無狀態 MCP 伺服器是否代表我無法儲存任何資料?
不是。無狀態描述的是通訊協定,而不是應用程式。資料庫、佇列與快取都能照常運作。變更之處在於,跨越多次呼叫的狀態必須以明確識別碼參照,並由用戶端在每次請求中傳送,例如放在工具引數中的伺服器產生 handle。不能做的是從連線推測內容。規格要求伺服器不得依賴同一連線上的先前請求來建立功能、通訊協定版本或用戶端身分,因為每個請求都會在 _meta 中提供這些資訊。
我仍需要在負載平衡器上設定工作階段黏著嗎?
一般請求不需要。在修訂版 2026-07-28 中,每個 POST 都會攜帶自己的通訊協定版本、功能與認證資料,因此任何副本都能處理任何請求,採用 round-robin 即可。唯一仍會長時間存在的是 subscriptions/listen 回應串流;它是連線至單一程序的單一開放連線。該程序結束時,連線也會結束;用戶端會重新傳送 subscriptions/listen 來建立連線。這屬於連線生命週期,而不是工作階段親和性,也沒有任何路由規則能阻止這種情況。
Mcp-Session-Id 和 HTTP GET 串流怎麼了?
兩者都已在修訂版 2026-07-28 中移除,依據 SEP-2567 和 SEP-2575。只實作此修訂版的伺服器,對 MCP 端點上的 GET 和 DELETE 應回應 405 Method Not Allowed,並應忽略 Mcp-Session-Id 標頭,而不是將其回傳。伺服器發起的變更通知現在會透過 subscriptions/listen 請求的回應串流傳送,而不是使用獨立的 GET 串流。必須繼續支援舊版用戶端的伺服器,會同時實作先前修訂版與本修訂版的行為。
沒有 handshake 時,如何對 MCP 伺服器執行健康檢查?
使用兩個層級。將代理的主動檢查指向應用程式提供的普通 HTTP 路徑,因為對 MCP 端點執行 GET 會正確回傳 405,並將健康的後端誤判為離線。接著透過 POST server/discover 檢查通訊協定本身;每個 2026-07-28 伺服器都必須實作此方法,並確認回應的 HTTP 狀態為 200,且列出用戶端使用的通訊協定版本。回應 404 且包含 JSON-RPC 錯誤 -32601,表示程序正在執行,但未提供該方法;回應 400 且包含 -32022,表示所要求的版本不受該建置支援。