· kaynak dev.to (home feed)
SDK 1.x HTTP sunucularındaki MCP 'Unsupported protocol version' 400 hatasını çözümlemek
TypeScript SDK 1.x üzerindeki MCP HTTP sunucuları, yeni 2026-07-28 protokol sürümü başlığını taşıyan istekleri 400 ile reddediyor. Bir dev.to rehberi bu hatanın ne zaman zararsız olduğunu ve ne zaman v2 paketine geçişin gerektiğini açıklıyor.

Ne oluyor
Model Context Protocol TypeScript SDK'sının (@modelcontextprotocol/sdk) 1.x sürümü üzerine kurulu HTTP sunucuları, bazı istemcileri HTTP 400 ve -32000 kodlu, "Unsupported protocol version" mesajlı bir JSON-RPC hata gövdesiyle reddediyor. dev.to'da yayımlanan ve runheed.com'da özgün olarak paylaşılan bir sorun giderme rehberine göre tetikleyici, MCP-Protocol-Version başlığının SDK'nın bilmediği bir protokol revizyonunu işaret ettiği istektir.
Sorunun merkezindeki revizyon, rehberin protokolün ilk stateless revizyonu olarak tanımladığı MCP 2026-07-28'dir: initialize el sıkışmasını ortadan kaldırır ve bunun yerine istemcilerin her istekte protokol sürümünü göndermesini öngörür. En yeni SDK'lar üzerine kurulu istemciler önce bunu dener; Python SDK 2.x zaten 2026-07-28'i en son sürümü olarak listeler.
1.x hattı buna yanıt veremez. Son 1.x sürümü olan SDK 1.32.2, 2025-11-25'te durur; tam desteklediği liste 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05 ve 2024-10-07'dir. Daha yeni bir şeyi işaret eden her başlık 400 alır.
Hata ne zaman zararsızdır
Rehberin ana noktası, bu 400'ün çoğu zaman hiçbir arıza olmadığıdır. Her iki protokol neslini destekleyen çift-çağ (dual-era) bir istemci, modern bir hata gövdesi içermeyen düz bir 400 görür, eski bir sunucuya ulaştığı sonucuna varır ve initialize el sıkışmasına geri döner; 1.x sunucu buna normal şekilde yanıt verir. İstemci reddi log'a yazar ve sonra çalışır, yani bugün düzeltilmesi gereken bir şey yoktur.
İlgili bir uyumluluk detayı: 1.x TypeScript sunucusuna bağlanan Python MCP istemcisi 2.x hâlâ çalışır, çünkü initialize sırasında sürüm başlığı göndermez ve iki taraf 2025-11-25 üzerinde anlaşır.
">Kimin etkilendiğini ölçmek
Herhangi bir şeyi değiştirmeden önce rehber, gerçekten kaç istemcinin yeni protokole ihtiyaç duyduğunun bulunmasını öneriyor. Sunucu transport'una bir hata işleyici ekleyin: SDK, 400 ile yanıt vermeden önce onerror'ü çağırır ve reddin nedeni hatanın mesajında gelir. Reddedilen istekteki MCP-Protocol-Version başlığını ve user agent'ı loglamak, yeni protokol istemcilerinin somut bir sayısını verir. Rehber bunu, stateless çalışma için session ID üreteci olmadan örneklendirilen WebStandardStreamableHTTPServerTransport üzerinde gösteriyor.
Yalnızca 2026 konuşan istemcilere hizmet vermek
Yalnızca 2026-07-28 konuşan bir istemci 1.x sunucuyu hiç kullanamaz. Çare, her iki protokol neslini destekleyen v2 paketi @modelcontextprotocol/server'a geçiştir.
Rehberin en keskin uyarısı cazip bir kısayolla ilgilidir: 1.x sunucudan modern protokolün UnsupportedProtocolVersionError hatasını, yani -32022 kodunu, taklit etmeyin. 2026-07-28 altında modern bir sunucu, desteklenmeyen bir sürüme -32022 artı desteklediği sürüm listesiyle yanıt verir; bu da istemcinin akıllıca yeniden denemesini sağlar. Eski bir sunucu bu kodu yayarsa, istemci modern bir sunucu bulduğu sonucuna varır ve initialize'a geri dönmeyi bırakır; kurtarılabilir bir uyuşmazlığı sert bir hataya dönüştürür. Geçiş gerçekleşene kadar tavsiye, 400'ü tam olduğu gibi bırakmak; ne başlığı ne de hata kodunu yeniden yazmaktır.
Hata tipik olarak nereden gelir
Rehber üç yaygın kaynak sayıyor: en yeni protokole dayalı bir istemci, ki her istekte sürümü gönderir ve önce onu dener; hâlâ SDK 1.x'te olan bir sunucu, ki yalnızca v2 paketleri 2025-11-25'in ötesine geçebilir; ve elle yazılmış bir istemci ya da test, örneğin sunucunun desteklemediği bir sürüm başlığını sabit kodlayan bir curl çağrısı.
Neden önemli
MCP'nin protokol revizyonları, birçok konuşlandırılmış sunucunun güncellendiğinden daha hızlı geliyor ve 1.x SDK ile v2 paketleri arasındaki sınır, pürüzsüz bir yükseltme değil gerçek bir uyumluluk uçurumudur. Loglarında bu 400'ü gören operatörlerin kozmetik gürültüyü gerçek kilitlenmelerden ayırması gerekir ve ucuz ilk adım, reddedilen sürüm başlığını loglamak, @modelcontextprotocol/server'a geçişin gerçekte ne kadar acil olduğunu tam olarak gösterir. En kötü yanıt sezgisel olanıdır: -32022 hatasını taklit ederek modern görünmek, şu anda çift-çağ istemcilerini çalışır tutan geri dönüş mekanizmasını sessizce devre dışı bırakır.
- #model-context-protocol
- #mcp
- #typescript
- #sdk
- #debugging