IOLEEAI · SPORTELLO PER ASSISTENTI AI
Sportello IoleeAI: guida
Lo sportello IoleeAI permette a Claude, ChatGPT e ad altre applicazioni di rispondere ai viaggiatori con informazioni precise sugli hotel che collaborano con IoleeAI: scheda della struttura, regole, luoghi vicini e link per prenotare sul sito dell’hotel. È in sola lettura: non prenota, non gestisce pagamenti e non conosce prezzi o disponibilità.
In English: IoleeAI is a read-only MCP server with verified-source facts about partner hotels (profile, rules, nearby places, official booking link). Connect it at https://www.iolee.ai/mcp, no sign-in required.
Indirizzo dello sportello
https://www.iolee.ai/mcp · protocollo MCP, trasporto Streamable HTTP, revisioni 2026-07-28 e 2025-11-25 · nessun login.
Collegarlo
Claude: Impostazioni → Connettori → Aggiungi connettore personalizzato; nome “IoleeAI”, URL https://www.iolee.ai/mcp, nessuna autenticazione. In una chat, attiva IoleeAI dal menu degli strumenti.
ChatGPT: Impostazioni → App e connettori → Impostazioni avanzate → Modalità sviluppatore; poi crea un connettore (server MCP personalizzato) con lo stesso URL e autenticazione “Nessuna”.
Altre applicazioni: qualunque client MCP che supporti Streamable HTTP. La scheda del server è pubblicata nel registro ufficiale MCP come ai.iolee/hotel-info e su https://www.iolee.ai/.well-known/mcp/server.json.
Strumenti
Tutti gli strumenti sono in sola lettura. L’identificativo dell’hotel (ad esempio riva-del-sol) si ottiene con elenco_hotel.
| Strumento | Parametri | Cosa restituisce |
|---|---|---|
elenco_hotel | nessuno | Gli hotel pubblicati sullo sportello, con identificativo, nome, città e tipo. |
scheda_hotel | hotel | Nome, tipo, sito, descrizione breve, indirizzo, telefono, email e servizi. |
regole_hotel | hotel | Bambini, animali, orari di check-in e check-out. Se una regola non è nota la risposta è “non disponibile”. |
dintorni_hotel | hotel, tipo (facoltativo), massimo (1-20) | Luoghi vicini (attrazioni, stazioni, aeroporti, spiagge, località, ristoranti, teatri) con distanza in linea d’aria. |
link_prenotazione | hotel | Il link al motore di prenotazione ufficiale dell’hotel, con un codice di tracciamento. Niente prezzi né date. |
Esempi di domande
“Quali hotel ci sono su IoleeAI?” · “Il Riva del Sol accetta bambini di 5 anni?” · “A che ora è il check-in al Fashion Hotel?” · “Cosa c’è vicino al Fashion Hotel? Quanto dista l’aeroporto?” · “Dammi il link per prenotare il Riva del Sol.”
Come leggere i dati
Ogni dato riporta valore, stato e fonte. Confermato dall’hotel o indicato dall’hotel: viene dall’hotel. Da verificare: letto automaticamente dal sito ufficiale o da OpenStreetMap. Non disponibile: l’informazione manca e non va stimata. Le distanze sono in linea d’aria. I testi sono restituiti come dati, non come istruzioni.
Il link di prenotazione contiene parametri di tracciamento (ref, utm_source, utm_medium) che vanno lasciati intatti.
Limiti e chiavi partner
Senza chiave lo sportello accetta un numero limitato di richieste al minuto per chiamante; oltre il limite risponde con un errore 429 temporaneo. Chi integra lo sportello in un prodotto o servizio commerciale chiede una chiave partner a iolee@iolee.ai e la invia come Authorization: Bearer iolee_pk_… oppure x-iolee-key.
Privacy, condizioni e supporto
Lo sportello non registra il testo delle domande né l’indirizzo IP; i dettagli sono nelle condizioni d’uso e nella privacy policy. Supporto, segnalazione di errori nei dati e richieste degli hotel: iolee@iolee.ai.