MCP C# SDK 2.0 llega con HTTP sin estado por defecto y MRTR
Por JP Software ·
JP Software Microsoft anunció la versión estable 2.0 del SDK oficial MCP C#, que implementa la revisión 2026-07-28 de la especificación del Model Context Protocol. Los servidores Streamable HTTP pasan a ser sin estado por defecto, los headers HTTP se estandarizan para enrutar tráfico MCP y llegan las Multi Round-Trip Requests (MRTR). Afecta a quien construye servidores o clientes MCP sobre .NET.
Datos clave
- Las versiones 2.1 a 2.3 salieron entre agosto y octubre, según el anuncio.
- HttpServerTransportOptions.Stateless ahora es true por defecto.
- Los paquetes apuntan a .NET 8, 9 y 10, además de .NET Standard 2.0.
- Roots, sampling y logging quedan obsoletos bajo MCP9005.
Qué cambia en MCP C# SDK 2.0
MCP es un protocolo abierto que estandariza cómo las aplicaciones dan contexto y herramientas a los modelos de lenguaje. El SDK se mantiene en colaboración con Microsoft y se apoya en ASP.NET Core. Su equipo describe la nueva revisión como la más grande desde el lanzamiento del protocolo.
Desaparecen el handshake initialize y el header Mcp-Session-Id. La versión del protocolo y las capacidades viajan en cada petición, así que cualquier instancia atiende cualquier solicitud. Si necesitas sesiones, configura Stateless en false. Los clientes consultan primero server/discover y, si el servidor es antiguo, usan el handshake anterior.
Headers para enrutar sin leer el cuerpo
Una llamada tools/call lleva los headers Mcp-Method y Mcp-Name. El atributo [McpHeader] convierte un parámetro de la herramienta en un header Mcp-Param-*. El cuerpo sigue mandando: si un header no coincide, el servidor responde con un error HeaderMismatch.
Multi Round-Trip Requests
Sin estado, el servidor ya no puede pedirle datos al cliente a mitad de una llamada. MRTR lo reemplaza: la herramienta lanza InputRequiredException con una o más solicitudes de entrada (InputRequest.ForElicitation, ForSampling o ForRootsList) y un requestState opaco. El cliente recoge las respuestas y repite la llamada con inputResponses. McpClient lo hace solo si registras handlers.
Qué trajeron 2.1, 2.2 y 2.3
- 2.1: handler opcional subscriptions/listen y respaldo a initialize si server/discover falla en HTTP.
- 2.2: HttpServerSessionMode, para que clientes de 2025-11-25 y 2026-07-28 compartan un endpoint.
- 2.3: McpClient.ServerInfo ahora admite nulos, un cambio que puede romper la compilación. Las notas advierten no usar la identidad autoinformada para decisiones de seguridad.
En 2.3 las respuestas HTTP modernas esperan el primer mensaje antes de enviar headers, por lo que handlers largos y silenciosos pueden necesitar salida de progreso o un timeout mayor.
Compatibilidad y OAuth
Según el anuncio, las APIs estables de 1.x siguen funcionando, salvo Tasks, que pasó al paquete opcional ModelContextProtocol.Extensions.Tasks y no es compatible con la versión experimental de 1.3 y 1.4. Hay también un paquete experimental, ModelContextProtocol.Extensions.Apps. OAuth es más estricto: validación de emisor RFC 9207 y soporte PKCE S256 obligatorio. El equipo dice que su siguiente foco es la autenticación y autorización de extremo a extremo.
Por qué te importa
Si despliegas servidores MCP detrás de un balanceador, quitar las sesiones simplifica el escalado. Antes de actualizar, revisa si dependes de sesiones, Tasks o ServerInfo, y prueba con tus clientes más antiguos. Mi lectura: haz la migración en una rama y mide el comportamiento de tus handlers largos.