MCP C#-SDK 2.0: ti bruddendringer, og Tasks må skrives om fra bunnen
Fjerner MCP C#-SDK 2.0 sesjonsstaten som standard, og tvinger fram omskriving for alle som tok i bruk den eksperimentelle Tasks-implementasjonen.
Ti bruddendringer står oppført i utgivelsesnotatene til versjon 2.0.0, som ble merket 28. juli 2026 i modelcontextprotocol/csharp-sdk. SDK-et implementerer spesifikasjonsrevisjonen 2026-07-28, og .NET-bloggen beskriver den som den største omskrivingen av protokollen siden lanseringen. Selve SDK-et bygger på ASP.NET Core, og argumentet fra Microsoft er at ruting, mellomvare og horisontal skalering allerede er hjemmebane for rammeverket.
Den ene endringen som faktisk river ned kode, er Tasks. Den eksperimentelle implementasjonen fra 1.3.x og 1.4.x er erstattet av en egen pakke, ModelContextProtocol.Extensions.Tasks, uten API- eller wire-kompatibilitet med forgjengeren. Du må legge til pakkereferansen, registrere med WithTasks, og bytte ut konstantene RequestMethods.Tasks mot medlemmer i TasksProtocol. Alt annet i v1-koden din kompilerer og kjører videre.
Resten av listen treffer mest i kantene, men noen av dem er stille feilkilder. Roots, Sampling og Logging er avviklet i spesifikasjonen og gir nå advarselen MCP9005. Verktøy med UseStructuredContent og en returtype som ikke er et objekt sender nå råverdien direkte, altså structuredContent: 72 i stedet for det innpakkede result-objektet, så klienter som leser en result-egenskap knekker. Deserialisering av et Tool-objekt uten inputSchema kaster JsonException i stedet for å defaulte stille, og et tomt objekt holder som verdi.
OAuth-siden er strammet i fire punkter samtidig. Utstedermismatch avvises nå etter RFC 9207 og RFC 8414, autorisasjon feiler hvis metadataene ikke annonserer PKCE med S256, dynamisk klientregistrering sender application_type, og en gjentatt insufficient_scope-utfordring som ikke legger til nye scopes kaster McpException i stedet for å forsøke i det uendelige. AuthorizationRedirectDelegate gir MCP9007 og skal byttes mot AuthorizationCallbackHandler.
Diagnostikkodene er selve migreringsguiden: MCP9004, MCP9005, MCP9006 og MCP9007 peker på hver sin avviklede flate, og kompilatoren sier fra der du fortsatt henger igjen i v1-oppførsel.
«Statsløs protokoll betyr ikke statsløs applikasjon» — .NET-bloggen om hvordan du selv skal føre tilstand videre
Rådet fra bloggen er å gjøre det HTTP-APIer alltid har gjort: la ett verktøy dele ut en eksplisitt referanse, en basketId eller browserId, og la modellen sende den tilbake som et vanlig argument senere. Det er ofte kraftigere enn skjult transporttilstand, fordi modellen kan sette sammen referanser på tvers av verktøy.
«Versjon 2.0.0 bringer C#-SDK-et i stabil linje med spesifikasjonen 2026-07-28» — utgivelsesnotatene på GitHub, signert Jeff Handley
Klienter prøver server/discover først og faller automatisk tilbake til det gamle initialize-håndtrykket mot servere som fortsatt kjører 2025-11-25 eller eldre. Neste steg for SDK-et er ende-til-ende-autentisering og autorisasjon med OAuth og OpenID Connect.
Hva bør du gjøre?
- Bygg med advarsler synlige og gå gjennom MCP9004 til MCP9007 før du oppgraderer produksjon. De peker direkte på koden som må flyttes.
- Sett Stateless til false midlertidig hvis serveren din er avhengig av uoppfordrede meldinger fra server til klient. Standarden er nå true.
- Sjekk klientkoden som leser structuredContent. Ikke-objekt-returverdier kommer nå rått, uten result-innpakking.
KI-kuratert — innholdet er generert av KI-agenter basert på originalkilden.