MCP TypeScript SDK
Alcance y línea de versión
El SDK oficial de MCP para TypeScript aporta bibliotecas para implementar clientes y servidores del protocolo. La consulta del 2026-11-09 toma como referencia la documentación v2, que declara implementar MCP 2026-07-28. El concepto protocolar permanece en model-context-protocol; esta nota describe una implementación y decisiones de integración.
El repositorio oficial identifica v2 como línea estable con paquetes separados: @modelcontextprotocol/server y @modelcontextprotocol/client. La línea v1 usa @modelcontextprotocol/sdk y conserva documentación propia. El proyecto mantiene esa línea para correcciones, pero su documentación v1 indica que no incorporará la revisión 2026-07-28.
Por tanto, un ejemplo que importa el paquete v1 y otro que utiliza las APIs v2 pueden representar contratos distintos. Antes de copiar código, registrar paquete, versión resuelta, revisión MCP y capacidades del host concreto. Un número de SDK y una fecha de protocolo son identidades diferentes.
Cliente, servidor e integración con el host
El servidor adapta capacidades de una aplicación: herramientas, recursos o prompts. El cliente se incorpora al host que decide cuándo usar esas capacidades y qué información compartir. Las bibliotecas no sustituyen esas decisiones ni convierten automáticamente al servidor en agente.
La documentación v2 presenta construcción de servidores y clientes, transports y adapters para runtimes. Elegir stdio o una integración HTTP afecta lanzamiento, conectividad y operación. La combinación admitida debe verificarse en los dos participantes; disponer del mismo lenguaje de programación no prueba compatibilidad wire.
Un recorrido ilustrativo del Atlas para una herramienta de consulta es:
aplicación define consulta, schema y límites
→ servidor registra la capacidad
→ host incorpora un cliente compatible
→ cliente obtiene la descripción que necesita
→ host decide invocar dentro del encargo
→ servidor valida, autoriza y ejecuta
→ host interpreta el resultado como informaciónEste esquema omite mensajes y detalles de transporte a propósito. No exige un handshake inicial heredado: la guía de soporte de 2026-07-28 es la referencia para migrar el comportamiento de versiones anteriores. Un tutorial de la línea v1 debe evaluarse dentro de su propio contrato.
Schemas, autorización y confianza
Un schema describe argumentos esperados; no demuestra autorización sobre el recurso solicitado. Para una consulta de facturas, un customerId válido necesita además comprobarse contra la identidad y el alcance del solicitante. tool-calling explica la representación y tool-abuse el riesgo de utilizar capacidades fuera del encargo.
La guía de autorización del SDK documenta la integración correspondiente. La aplicación debe seleccionar y configurar los controles adecuados: helpers de autenticación no diseñan por sí solos el acceso a cada operación de negocio. least-privilege-for-agents y trust-boundaries permiten revisar ese límite.
El resultado también puede contener texto externo con apariencia de instrucción. El host necesita conservar la distinción entre contenido recuperado y autoridad, incluso cuando el SDK haya validado el mensaje. prompt-injection continúa siendo relevante después de una comunicación protocolariamente correcta.
Prueba mínima de integración
Como ejercicio propuesto por el Atlas, exponer una consulta sobre fixtures sin credenciales reales ni efectos externos. Probar descubrimiento, invocación válida, argumentos inválidos, acceso rechazado y errores de la aplicación. Registrar por separado fallos de transporte, protocolo y negocio.
Añadir un participante con revisión o capacidad no admitida y comprobar el resultado observable. Después, probar el host que realmente se utilizará: un cliente de ejemplo exitoso no demuestra soporte de otro producto ni activación automática de extensiones. Para operaciones mutables, evaluar repetición y recuperación mediante idempotency.
Esta nota no instala SDKs ni configura servidores MCP en el Atlas. No se ejecutó una prueba de interoperabilidad. ai-technology-catalog conserva la selección tecnológica y ai-supply-chain-risk encuadra adquisición, actualización y activación de dependencias o servidores.