MCP 101: Tu primer servidor
¡Bienvenido a Rinoova! Esta guía te mostrará cómo tomar una API REST existente (descrita a través de OpenAPI) y convertirla en un servidor Model Context Protocol (MCP) completamente funcional en minutos.
Paso 1: Prepara tu Especificación OpenAPI
El corazón de la creación es tu especificación OpenAPI. Rinoova soporta los formatos JSON y YAML. Puedes subir el archivo directamente o pegar la URL pública donde reside tu especificación.
Paso 2: Crea un nuevo Servidor y Versión
Desde el panel, navega a Mis Servidores y haz clic en Crear Servidor. Dale un nombre a tu proyecto. Después, se te preguntará cómo generar las herramientas. Selecciona Importar desde URL OpenAPI o Subir archivo OpenAPI y proporciona tu especificación.
Paso 3: Selección del Modo de Despliegue
Una vez importada la especificación, Rinoova descubrirá automáticamente todos los endpoints disponibles y los convertirá en 'Herramientas' para los agentes de IA. Luego podrás elegir el modo de creación:
Modo Fast
Ideal si tienes una API pública. Solo requiere ingresar la API_BASE_URL (ej. https://api.tudominio.com). Rinoova automatizará la generación, construcción y despliegue de una sola vez.
Modo Manual
Selecciona esta opción si necesitas configurar variables de entorno complejas, definir la autenticación server-to-server (ej. Bearer, API Key) o si deseas excluir/modificar herramientas específicas antes del despliegue.
Paso 4: Configuración y Despliegue
Si elegiste el modo manual, podrás revisar y refinar las herramientas descubiertas. Luego configurarás las variables de entorno (la URL base de tu API es obligatoria, mientras que otras claves dependen de la autenticación necesaria). Haz clic en Desplegar y listo: Rinoova compilará el código en un Contenedor y lo subirá a la nube aislada, devolviendo un endpoint SSE listo para usarse.
Paso 5: Probar y Conectar
Puedes probar las herramientas recién descubiertas o generadas directamente desde la Cloud Dashboard a través del Playground Interactivo. Si todo funciona como se espera, el Endpoint SSE indicado en el despliegue es la clave para conectar tu servidor MCP recién importado con el Agente de IA de tu elección (como Cursor, Claude Desktop o la Rinoova App).