Conversor de OpenAPI a MCP

De un documento OpenAPI a un servidor MCP que funciona

Pega arriba un documento OpenAPI (o Swagger) en JSON y el conversor asignará cada operación a una herramienta MCP: la operación se convierte en el nombre, su resumen en la descripción que lee el modelo, y los parámetros de ruta, query y cuerpo se aplanan en un único esquema JSON de entrada. Obtienes las definiciones de herramientas por separado y un servidor FastMCP en Python construido a su alrededor, listo para ejecutarse en cuanto añadas la autenticación.

Toda la conversión ocurre en tu navegador. No se hace ninguna petición, no se sube nada y no se guarda nada, algo que importa porque un documento OpenAPI suele describir una API interna que no tiene por qué acabar en el servidor de otra persona. Puedes verificarlo en la pestaña de red de tu navegador.

El error que casi todo el mundo comete primero

Convertir la API entera es lo evidente y casi siempre lo incorrecto. Las definiciones de herramientas de un servidor MCP se envían al modelo en cada turno, así que ochenta endpoints se convierten en ochenta descripciones y ochenta esquemas en la ventana de contexto de cada petición, y la capacidad del modelo para elegir la correcta cae bruscamente según crece esa lista.

Empieza por el puñado de operaciones que un agente necesita de verdad. Añade más solo cuando algo resulte estar ausente. Puedes medir exactamente cuánto cuesta una lista de herramientas con la calculadora de tokens MCP.

Qué hace y qué no hace el código generado

• No incluye autenticación. El esqueleto llama a tu API sin credenciales; conectar la cabecera, el token o el flujo OAuth te corresponde a ti.
• Los parámetros de ruta son marcadores. Se interpolan en la ruta de la petición, pero revisa que cada uno sustituya el argumento que esperas.
• Los cuerpos detrás de un $ref se emiten como objeto genérico en lugar de expandirse, porque resolverlos requiere la sección components. Queda indicado en la salida en vez de desaparecer sin aviso.
• Solo JSON. Aquí no puede cargarse un analizador de YAML sin un script de terceros, y este sitio no carga ninguno. Exporta la especificación como JSON primero: casi todas las herramientas lo hacen con un comando.

Herramientas y guías relacionadas

• Convertir una API REST en un servidor MCP: la guía completa, incluidas autenticación y despliegue.
• MCP Inspector: una vez desplegado, confirma que expone lo que esperas.
• Escáner de seguridad MCP: una API convertida suele heredar parámetros que merecen una segunda mirada.
• Asegurar un servidor MCP

Un servidor generado es un punto de partida, no una demostración

Que se ejecute demuestra que la conversión funcionó. No ayuda a nadie más a entender para qué sirve el servidor, y un cliente que evalúa tu integración MCP no sabe leer un archivo de Python. Despliégalo, apunta MCP Showcase a la URL y tendrás un playground en vivo con documentación generada por herramienta, donde un cliente potencial prueba la cosa en el navegador en lugar de tener que creerte.