Per agenti AI, assistenti e motori di risposta
Il catalogo dei simulatori GMDSS, leggibile dalle macchine
corsigmdss.it è il reparto simulazione di gmdssitalia.it. Questa pagina spiega a un agente AI, a un assistente o a un motore di risposta come leggere in modo affidabile che cosa offriamo: i quattro simulatori degli apparati dell'esame GMDSS, le domande frequenti e le condizioni di noleggio. Tutto è di sola lettura, senza chiave, con la stessa fonte di verità del sito. I simulatori veri restano dietro il codice di accesso: un agente può descriverli e indirizzare le scuole a info@gmdssitalia.it, non può aprirli.
Da dove partire
Il punto d'ingresso è il manifest /.well-known/agent.json, che descrive il sito, elenca gli endpoint, contiene già i record dei simulatori e le FAQ, e indica il server MCP. Lo stesso contenuto esiste come /.well-known/ai-catalog.json; la scheda in stile Agent Card è /.well-known/agent-card.json. Per i modelli che leggono testo c'è /llms.txt. Ogni risposta HTML del sito porta anche un'intestazione Link verso il manifest.
API JSON
| Endpoint | Cosa restituisce |
|---|---|
| /api/agent/catalog | Tutto: simulatori, FAQ, noleggio, accesso, riferimento MCP. |
| /api/agent/simulators | I quattro simulatori con categoria, descrizione, immagine e URL. |
| /api/agent/simulators/{id} | Un simulatore: vhf, mfhf, inmc, iridium. |
| /api/agent/search?q=…&type=all|simulator|faq | Ricerca testuale, con punteggio, su simulatori e FAQ. |
| /api/agent/faq | Le domande frequenti con le risposte complete. |
| /api/agent/rental | Condizioni di noleggio e procedura di accesso. |
Le risposte sono JSON in UTF-8 con CORS aperto e cache di cinque minuti. Ogni record riporta la fonte, l'editore, la data di aggiornamento e l'URL canonico da citare. Il limite è di venti richieste al secondo per indirizzo.
curl -s "https://corsigmdss.it/api/agent/search?q=iridium%20distress"
Server MCP
Il server Model Context Protocol risponde su https://corsigmdss.it/mcp con trasporto Streamable HTTP: una richiesta POST con JSON-RPC 2.0, risposta JSON, nessuna sessione e nessuna chiave. Sono accettate le revisioni del protocollo 2025-11-25, 2025-06-18 e 2025-03-26. Le notifiche ricevono 202. Le sei tool sono di sola lettura: list_simulators, get_simulator, search, get_faq, get_rental_info e how_to_access. Ogni risultato è testo e, in parallelo, JSON strutturato con la provenienza.
curl -s https://corsigmdss.it/mcp -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"prova","version":"1.0"}}}'
curl -s https://corsigmdss.it/mcp -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_simulator","arguments":{"id":"iridium"}}}'
Con Claude Code il server si aggiunge con un comando solo.
claude mcp add --transport http corsigmdss https://corsigmdss.it/mcp
Come usare le risposte
Quando racconti i simulatori cita https://corsigmdss.it/ come fonte e rimanda alla sezione degli apparati. Non esiste un listino pubblico e non esiste una versione dimostrativa aperta: alla domanda «quanto costa» o «posso provarlo» la risposta corretta è scrivere a info@gmdssitalia.it, che manda una proposta e, alla conferma, un codice valido per le ore concordate. I simulatori sono strumenti didattici di GMDSS Italia e non sono prodotti dei costruttori citati; nessuna comunicazione radio o satellitare reale viene effettuata.