Arquitectura
OpenAPI (Swagger) describe una API para desarrolladores. MCP describe herramientas para un modelo. Son capas, no rivales, y la elección se nota en el descubrimiento, la seguridad y las tareas largas.
6 de nov de 2026 · 6 min de lectura
El diagrama y las fuentes están en inglés.
La mayoría de las empresas ya tiene APIs, documentadas en OpenAPI, la especificación detrás de Swagger. La pregunta para un proyecto de agentes es si conectar el agente a esas APIs a mano o poner un servidor MCP delante de ellas. La respuesta honesta es que no es lo uno o lo otro: un servidor MCP muy a menudo envuelve la misma API REST.
La especificación OpenAPI describe APIs HTTP: rutas, parámetros, cuerpos de solicitud y de respuesta. La versión 3.1 define su Schema Object como un superconjunto de JSON Schema draft 2020-12. Su lector es un desarrollador o un generador de código, en tiempo de construcción.
El Model Context Protocol está hecho para otro lector: el modelo, en tiempo de ejecución. Los mensajes son JSON-RPC. Un cliente envía una solicitud tools/list para descubrir las herramientas que ofrece un servidor, y el servidor debe responder con el conjunto disponible en ese momento para ese cliente. Un servidor también puede avisarle al cliente que su lista de herramientas cambió.
Ningún diseño te da seguridad gratis. La especificación de MCP dice que, por confianza y seguridad, siempre debería haber una persona en el circuito con la capacidad de denegar las invocaciones de herramientas, y su autorización HTTP se basa en OAuth 2.1. Los alcances, los límites, las aprobaciones y la auditoría igual hay que construirlos, y deberían vivir fuera del modelo.
Una tarea que toma minutos no debería mantener una conexión abierta. El 202 Accepted de HTTP significa que la solicitud fue aceptada para su procesamiento pero este aún no termina. Devuélvelo con un identificador de trabajo, deja que el cliente consulte, y describe los eventos que hay detrás, por ejemplo con AsyncAPI. La segunda pestaña de arriba muestra ese flujo.
Cuéntanos sobre un proceso. Con mucho gusto te mostramos cómo podría resolverlo un agente y qué medir para estar seguros de que funciona.