R
Rinoova

MCP 101: Il tuo primo server

Benvenuto in Rinoova! Questa guida ti mostrerà come prendere un'API REST esistente (descritta tramite OpenAPI) e trasformarla in un server Model Context Protocol (MCP) completamente funzionale in pochi minuti.

1

Fase 1: Preparare la Specifica OpenAPI

Il cuore della creazione è la tua specifica OpenAPI. Rinoova supporta i formati JSON e YAML. Puoi caricare il file direttamente o incollare l'URL pubblico dove risiede la tua specifica.

2

Fase 2: Crea un nuovo Server e Versione

Dalla dashboard, naviga su I Miei Server e clicca su Crea Server. Dai un nome al tuo progetto. Dopodiché, ti verrà chiesto come vuoi generare i tool. Seleziona Importa da URL OpenAPI o Carica file OpenAPI e fornisci la tua specifica.

3

Fase 3: Selezione Modalità di Deploy

Una volta importata la specifica, Rinoova individuerà automaticamente tutti gli endpoint disponibili e li convertirà in 'Tool' per gli agenti AI. A questo punto potrai scegliere la modalità per creare la versione:

Modalità Fast

Ideale se hai un'API pubblica. Richiede solo di inserire l'API_BASE_URL (es. https://api.tuodominio.com). Rinoova automatizzerà la generazione, la build e il deploy in un colpo solo.

Modalità Manuale

Seleziona questa opzione se hai bisogno di configurare variabili d'ambiente complesse, definire l'autenticazione server-to-server (es. Bearer, API Key) o se vuoi escludere/modificare specifici tool prima del deploy.

4

Fase 4: Configurazione e Deploy

Se hai scelto la modalità manuale, potrai rivedere e affinare i tool scoperti. Successivamente, configurerai le variabili d'ambiente (il base URL della tua API è obbligatorio, mentre altre chiavi dipendono dall'autenticazione necessaria). Clicca su Deploy ed il gioco è fatto: Rinoova compilerà il codice in Container e lo caricherà sulla cloud isolata, restituendo un endpoint SSE pronto per l'uso.

5

Fase 5: Testa e Connetti

Puoi testare i tool appena scoperti o generati direttamente dalla Cloud Dashboard tramite il Playground Interattivo. Se tutto funziona come previsto, l'Endpoint SSE indicato nel deploy è la chiave per connettere il tuo server MCP fresco di stampa con l'Agente AI di tua scelta (come Cursor, Claude Desktop, o la Rinoova App).