BookingDesigner per Claude e ChatGPT

Chiedi a parole i numeri della tua struttura. Il connettore collega Claude o ChatGPT ai dati di BookingDesigner: occupazione, ADR, produzione, canali, richieste e, se l'amministratore lo consente, le singole prenotazioni. Sempre in sola lettura.

Indirizzo del connettore https://api.bookingdesigner.com/mcp Accesso con il tuo account BookingDesigner (OAuth). Non servono chiavi né password da copiare.

Cosa fa

Legge, non scrive. Tutti gli strumenti sono in sola lettura: l'assistente non può modificare prenotazioni, tariffe, disponibilità né altro.
Gli stessi numeri del BMS. Le risposte vengono dalle stesse funzioni che calcolano i pannelli Analytics e il PMS, non da stime.
Mai più di quello che vedi già. L'assistente vede solo le strutture su cui hai il permesso Analytics, e solo le aree di dati che l'amministratore ti ha concesso.
Revocabile subito. Puoi scollegarlo in qualunque momento, da Claude o ChatGPT e dal BMS.

Prima di iniziare

Un account BookingDesigner con il permesso Analytics su almeno una struttura.
Il servizio MCP Analytics attivo per la tua organizzazione. Lo attiva l'assistenza BookingDesigner: scrivi a support@ionet.it.
L'abilitazione da parte dell'amministratore della tua organizzazione, nel BMS in Impostazioni organizzazione › Integrazioni › MCP Analytics. È lì che sceglie quali aree di dati puoi interrogare.
Un piano di Claude o di ChatGPT che permette di aggiungere connettori personalizzati.

Collegare Claude

Piani Pro e Max

Apri Personalizza › Connettori e scegli + › Aggiungi connettore personalizzato.
Incolla l'indirizzo https://api.bookingdesigner.com/mcp e conferma con Aggiungi. Le impostazioni avanzate OAuth vanno lasciate vuote.
Premi Connetti: si apre la pagina di accesso di BookingDesigner (vedi Il consenso).

Piani Team ed Enterprise

Il proprietario dell'organizzazione Claude apre Impostazioni organizzazione › Connettori, sceglie Aggiungi › Personalizzato › Web e incolla l'indirizzo.
Ogni persona poi apre Personalizza › Connettori, trova BookingDesigner e preme Connetti, con il proprio account BookingDesigner.

In una conversazione, attiva il connettore dal pulsante + in basso a sinistra, alla voce Connettori.

Collegare ChatGPT

Nelle impostazioni di ChatGPT attiva la modalità sviluppatore, se il tuo piano la richiede per le app personalizzate.
Dalla sezione delle app (o dei connettori) crea una nuova app, con un nome a tua scelta, per esempio BookingDesigner.
Come indirizzo del server MCP incolla https://api.bookingdesigner.com/mcp e come autenticazione scegli OAuth.
Conferma: si apre la pagina di accesso di BookingDesigner (vedi Il consenso).

Dopo un aggiornamento del servizio ChatGPT continua a mostrare gli strumenti che ha letto al momento del collegamento. Per vedere quelli nuovi apri l'app nelle impostazioni e premi Aggiorna: ricollegarsi non basta, perché rifà solo l'accesso.

Il consenso

Il collegamento passa sempre da una pagina di BookingDesigner:

accedi con le tue credenziali del BMS e, se richiesto, con il codice di verifica;
se appartieni a più organizzazioni, scegli quella da collegare;
la pagina elenca le strutture visibili e le aree di dati che l'assistente potrà leggere, e avvisa se fra queste ci sono dati personali degli ospiti;
premi Consenti per tornare a Claude o ChatGPT, oppure Annulla.

Se la pagina dice che non ci sono organizzazioni disponibili, non sei ancora abilitato: chiedilo all'amministratore della tua organizzazione.

Cosa puoi chiedere

“Com'è andato agosto rispetto ad agosto dell'anno scorso? Occupazione, ADR e RevPAR.”
“Quanto abbiamo prodotto per canale nel secondo trimestre, e quale canale è cresciuto di più?”
“Quante richieste sono arrivate dal sito questo mese, e quante sono diventate prenotazioni?”
“Con quanto anticipo prenotano gli ospiti di settembre, da Booking rispetto al diretto?”
“Famiglie o coppie: chi resta più notti, e chi prenota prima?”
“Da quali paesi arrivano gli ospiti di luglio?”
“Chi arriva oggi, e in che camera?” dati personali
“Chi compie gli anni questa settimana fra gli ospiti in casa?” dati personali

Se chiedi più strutture insieme, l'assistente può rispondere per ciascuna o sul totale.

Strumenti disponibili

Il connettore espone 12 strumenti, raggruppati nelle aree che l'amministratore concede per persona. L'assistente vede solo quelli delle aree concesse.

Elenco strutture e stato dei dati

Strumento	Cosa restituisce
Elenco strutture `list_strutture`	Le strutture che puoi interrogare, con il codice, e fino a quando sono aggiornati i dati.

Occupazione, ADR, RevPAR e produzione

Strumento	Cosa restituisce
Occupazione, ADR e RevPAR `get_adr_revpar`	Occupazione, ADR, RevPAR, notti vendute e ricavo camere per data di soggiorno, per giorno, settimana o mese.
Produzione `get_produzione`	Il ricavo di un periodo per canale, categoria, trattamento o tipologia di camera, per data di soggiorno o di prenotazione. La tassa di soggiorno è esclusa, salvo richiesta.

Produzione e conversioni per canale

Strumento	Cosa restituisce
Prenotazioni per origine `get_prenotazioni_per_origine`	Da dove arrivano le prenotazioni e quanto valgono: diretto, portali, OTA, agenzie, gruppi. Anche con l'anticipo di prenotazione e l'andamento mese per mese.

Richieste, preventivi e conversione

Strumento	Cosa restituisce
Richieste, preventivi e prenotazioni `get_funnel`	Quante richieste sono arrivate, quante sono diventate preventivo e quanti preventivi sono stati confermati.
Conversione delle richieste `get_conversione_richieste`	Quante richieste si sono chiuse in prenotazione, per il canale da cui sono arrivate, con le sorgenti e le campagne se servono.

Provenienza ed età degli ospiti (solo aggregati)

Strumento	Cosa restituisce
Provenienza ed età degli ospiti `get_ospiti`	Presenze, arrivi e partenze per nazione, regione, provincia o fascia d'età. Solo aggregati.
Prenotazioni per tipo di ospiti `get_prenotazioni_per_target`	Single, coppie, famiglie, senior e gruppi: quante prenotazioni, quante notti, durata del soggiorno e anticipo. Solo aggregati.

Prenotazioni per nome: arrivi, partenze, in casa, compleanni, elenchi per periodo (dati personali)dati personali

Strumento	Cosa restituisce
Arrivi e partenze del giorno `get_arrivi_partenze`	Le prenotazioni in arrivo e in partenza in un giorno, con nome, camera, tipologia, trattamento, ospiti, canale e totale del soggiorno.
Ospiti in casa `get_in_casa`	Le prenotazioni in casa la notte di un giorno, con camera e gli stessi dettagli degli arrivi.
Compleanni degli ospiti `get_compleanni`	Gli ospiti che compiono gli anni durante il soggiorno, in un periodo fino a 31 giorni. Solo per chi ha la data di nascita registrata al check-in; sotto i 14 anni solo il numero, senza nome.
Prenotazioni di un periodo `get_prenotazioni`	Le prenotazioni di un periodo fino a 31 giorni, per data di arrivo, soggiorno, creazione o cancellazione, con stato e data di prenotazione.

L'area Elenco strutture e stato dei dati è sempre concessa. L'area Note delle prenotazioni (solo insieme a Prenotazioni per nome) non ha strumenti propri: aggiunge le note agli elenchi delle prenotazioni.

Dati personali degli ospiti

Le aree Prenotazioni per nome e Note sono spente finché l'amministratore non le accende per una persona. Quando sono accese:

l'assistente legge le singole prenotazioni: nome della prenotazione, camera, tipologia, trattamento, date, numero di ospiti, canale e totale del soggiorno; per i compleanni, il nome dell'ospite e l'età che compie, solo dai 14 anni in su: per i più piccoli arriva solo il numero di compleanni del giorno, senza nome né camera;
le note arrivano senza link, email, numeri di telefono e codici di accesso alle pagine dell'ospite;
email, telefono, documenti e dati di pagamento degli ospiti non sono mai disponibili, con nessuna area.

Tutte le altre aree restituiscono solo aggregati.

Limiti

Aggiornamento. Gli strumenti aggregati usano i dati di Analytics, che si allineano periodicamente; ogni risposta dice fino a quando sono aggiornati. Arrivi, partenze, ospiti in casa e prenotazioni vengono invece dal PMS in tempo reale.
Periodi. Fino a 366 giorni per chiamata per gli aggregati; fino a 31 giorni e 300 righe per gli elenchi di prenotazioni. Per periodi più lunghi l'assistente fa più chiamate.
Frequenza. Ogni collegamento ha un numero massimo di chiamate al minuto (di norma 60). Se l'assistente lo supera riceve un avviso e può riprovare poco dopo.

Scollegare e revocare

Da Claude o ChatGPT: rimuovi il connettore o l'app dalle impostazioni. Rimuoverla da ChatGPT non scollega subito il BMS: il collegamento resta attivo fino alla scadenza, o finché non lo scolleghi dal BMS.
Se ricolleghi la stessa app, la pagina di consenso propone di sostituire il collegamento precedente. Lascia la spunta se ti stai ricollegando; toglila se stai collegando un altro computer o un altro account e vuoi tenerli entrambi.
Dal BMS: in Integrazioni › MCP Analytics, alla voce I tuoi collegamenti, premi Scollega. L'effetto è immediato.
L'amministratore dell'organizzazione vede e può revocare tutti i collegamenti, e togliere l'abilitazione a una persona.
Se un account viene disattivato nel BMS, i suoi collegamenti smettono di funzionare finché non viene riattivato.

Se qualcosa non va

Non vedo gli strumenti nuovi. Su ChatGPT premi Aggiorna nelle impostazioni dell'app. Su Claude apri una nuova conversazione.
Manca una struttura. Ti serve il permesso Analytics su quella struttura nel BMS.
Manca un'area (per esempio gli arrivi del giorno). L'amministratore deve concedertela nel BMS. Dopo la modifica vale dalla chiamata successiva.
Un numero non torna con il BMS. Controlla la data di aggiornamento indicata nella risposta, e se si parla di data di soggiorno o di prenotazione: sono due letture diverse dello stesso periodo.

Altri client MCP

Per un client che non supporta OAuth, l'amministratore può creare una chiave personale nel BMS, nella stessa pagina. La chiave va inviata nell'intestazione X-API-Key all'indirizzo https://api.bookingdesigner.com/mcp, ha gli stessi permessi della persona e si revoca allo stesso modo.

Assistenza

Scrivi a support@ionet.it. Per sapere quali dati tratta il connettore e per quanto li conserva leggi la privacy policy.