En esta página
APIs externas y autorización
Especificación MCP 2026-07-28 · revisada el 2 de octubre de 2026
Envolver una API REST y GraphQL con plazos, reintentos, límites y errores útiles para el modelo; autorización OAuth de MCP 2026-07-28 de extremo a extremo, y su montaje en Cloudflare Workers.
Qué aprenderás
- Envolver una API REST y una consulta GraphQL con plazos, reintentos seguros, límites de tamaño y propagación de la cancelación
- Traducir cada fallo de la API a un resultado que le diga al modelo qué hacer a continuación, y a un registro que le sirva a plataforma
- Recorrer la autorización de MCP 2026-07-28 mensaje a mensaje: metadatos de recurso, descubrimiento, registro del cliente, validación de iss y scopes incrementales
- Justificar por qué el servidor MCP no reenvía el token del usuario a la API de fondo y qué envía en su lugar
- Montar el servidor de autorización y el servidor MCP en dos Workers y saber qué rechaza cada capa
Contenido de la lección
- 01 El problema
- 02 Un cliente de la API con plazos, reintentos y límites
- 03 Del error HTTP al error que el modelo puede usar
- 04 Quién llama: la autorización de extremo a extremo
- 05 El montaje en Cloudflare Workers
- 06 En producción
Además: quiz de comprobación y desafío práctico.
Extracto
En el nivel Básico, buscar_factura llamaba a un obtenerFactura() que dimos por hecho, y el servidor corría por stdio en el portátil de quien lo usaba. Ahora nortia-facturacion va a publicarse en https://mcp.nortia.example/facturacion/mcp, y detrás tiene una API interna que en cierre de mes tarda segundos en responder, limita peticiones y a veces devuelve un 503.
Aparecen tres preguntas que el protocolo no contesta por ti:
Fin del extracto · la lección sigue con 5 secciones más
Artículos relacionados
- Servidores Guías
- Servidores Ecosistema
Los servidores MCP de Inditex por dentro: qué hacen bien y qué no
- Servidores Seguridad
Seguridad en servidores MCP: lo que enseñan dos meses de avisos
Preguntas frecuentes
¿Puede un servidor MCP reenviar el token del usuario a la API que tiene detrás?
No: la especificación 2026-07-28 prohíbe lo que llama token passthrough, así que el servidor solo admite tokens emitidos para él y nunca los pasa tal cual a otro servicio. Es una de las decisiones menos intuitivas al envolver una API interna, porque reutilizar la credencial que llega parece el camino más corto. En la lección se explica el motivo de esa prohibición y con qué credencial se identifica el servidor ante la API de fondo.
¿Cómo funciona la autorización OAuth en un servidor MCP remoto?
El servidor MCP actúa como recurso protegido de OAuth 2.1: publica unos metadatos con los que el cliente descubre qué servidor de autorización usar, y solo acepta tokens cuya audiencia sea él mismo. La versión 2026-07-28 suma la comprobación del parámetro iss en la respuesta de autorización y la posibilidad de pedir más permisos cuando el token se queda corto. Conocer el flujo petición a petición es lo que permite averiguar por qué un cliente no logra conectarse o por qué se rechaza una llamada. En la lección se recorre de extremo a extremo y se monta en dos Workers de Cloudflare.
¿Qué debe hacer un servidor MCP cuando la API externa falla o tarda demasiado?
Convertir ese fallo en un resultado que el modelo pueda interpretar, en lugar de dejar escapar un error HTTP o que la llamada se quede colgada. Importa porque de ese texto depende que el agente espere, avise a la persona o deje de insistir, y porque repetir a ciegas una operación con efectos, como emitir un abono, puede duplicarla. En la lección se construye la capa que habla con la API, preparada para lentitud, límites de peticiones y caídas, y se decide qué recibe el modelo y qué queda registrado para el equipo de plataforma en cada caso.