Sviluppatori · per Host

Collega ChatGPT, Claude o il tuo agente AI (MCP)

Collega ChatGPT, Claude, Cursor, n8n o qualsiasi client MCP a Guestbud con l'accesso o una chiave API: il tuo agente risponde agli ospiti e gestisce prenotazioni e annunci.

Guestbud supporta il Model Context Protocol (MCP), lo standard aperto con cui gli assistenti AI lavorano con altri software. Colleghi il tuo agente AI al tuo account Guestbud una sola volta. Dopo puoi dirgli in linguaggio naturale cosa fare, per esempio:

“Rispondi alle nuove domande sul parcheggio nella chat di Airbnb.”
“Chi arriva domani, e hanno fatto tutti il check-in?”
“Cambia la password del Wi-Fi di Harbour Loft in SeaBreeze2026.”
“Rendi più cordiale l'email con i dettagli del check-in e aggiungi la regola sugli asciugamani da spiaggia.”
“Quali segnalazioni sono ancora aperte, e cosa ha segnalato l'ospite dell'appartamento 3?”

L'agente lavora con i tuoi dati, nel tuo account e solo con i permessi che gli dai.

Cosa può fare il tuo agente #

Area	Cosa può fare	Permesso del ruolo richiesto
Account	Vedere con quale account e ruolo è collegato	—
Prenotazioni	Elencare e cercare prenotazioni, leggere una prenotazione con dettagli del check-in, stato dei pagamenti e stato dei codici della porta	Bookings: view
Chat con l'ospite	Leggere la conversazione di Airbnb, Booking.com, Vrbo … e inviare messaggi all'ospite (tramite Hostaway o Channex)	Bookings: view / edit
Check-in	Inviare il link del check-in o un promemoria via email o chat; mostrare in anticipo i codici della porta per un check-in anticipato concordato	Bookings: edit
Prenotazioni	Creare una prenotazione diretta, modificare note, ospiti e contatti, cancellare	Bookings: edit
Segnalazioni	Elencare le segnalazioni di guasti degli ospiti, impostarle come in corso o risolte, aggiungere note interne	Bookings: view / edit
Piano delle pulizie	Check-in e check-out dei prossimi giorni con orari di arrivo / partenza e voli	Cleaning plan
Annunci	Leggere l'intera guida dell'ospite; modificare le sezioni (Wi-Fi, passaggi per il check-in, regole della casa, consigli locali, extra …); attivare o disattivare una struttura	Properties: view / edit
Messaggi agli ospiti	Leggere e modificare i messaggi automatici e i modelli; vedere l'anteprima di un messaggio compilato con una prenotazione reale	Settings
Statistiche	Occupazione, prenotazioni, tassa di soggiorno, depositi, early check-in / late check-out ed extra venduti	Reports
Tutto il resto	Leggere qualsiasi parte della REST API (sola lettura)	come l'API

Mai disponibili per un agente: rimborsi, sblocco o incasso dei depositi, impostazioni di pagamento, utenti e chiavi API. Restano a te nella dashboard.

Due modi per collegarsi #

	Accesso (consigliato)	Chiave API
Per	ChatGPT, claude.ai, Claude Desktop e mobile, Claude Code, Cursor	n8n, Make, framework per agenti, il tuo codice, server senza una persona presente
Come	Incolla l'indirizzo del server nell'app AI, accedi a Guestbud, scegli un ruolo, clicca Allow	Crea una chiave in Guestbud e incollala nello strumento
Chi	La persona che accede (le serve il permesso di collegare app, vedi sotto)	Qualcuno che gestisce gli utenti
Fine	Quando la scolleghi, quando la persona viene rimossa, disattivata, riceve un altro ruolo o cambia password, oppure dopo 60 giorni senza alcun utilizzo	Quando revochi la chiave

L'indirizzo del tuo server è indicato in Settings → AI agent (MCP):

https://guestbud.io/mcp, oppure
il tuo dominio seguito da /mcp, per esempio https://stay.example.com/mcp.

1. Scegli cosa può fare l'agente #

L'agente lavora sempre con un ruolo, esattamente come una persona del tuo team (vedi Utenti, ruoli e accesso):

Staff: consigliato per rispondere agli ospiti; legge le prenotazioni, invia messaggi agli ospiti e link del check-in, gestisce le segnalazioni, vede il piano delle pulizie. Non può modificare annunci o impostazioni.
Manager: in più modifica annunci, modelli dei messaggi agli ospiti e impostazioni, e legge le statistiche.
Viewer: solo lettura; non può inviare nulla.
Cleaning: solo il piano delle pulizie.

Inizia con Staff. Con l'accesso scegli il ruolo nella pagina di Guestbud che si apre; non può mai essere superiore al tuo ruolo, e mai Owner.

Dove aggiungere l'indirizzo del server (https://guestbud.io/mcp) nella tua app AI:

claude.ai, Claude Desktop e mobile: Settings → Connectors → Add custom connector, incolla l'indirizzo, Add, poi Connect.
ChatGPT: Settings → Apps & Connectors, crea un connettore (modalità sviluppatore), incolla l'indirizzo, autenticazione OAuth.
Claude Code: esegui claude mcp add --transport http guestbud https://guestbud.io/mcp, poi digita /mcp in Claude Code e scegli Authenticate.
Cursor: Settings → MCP → Add server con { "mcpServers": { "guestbud": { "url": "https://guestbud.io/mcp" } } }, poi Connect.

Poi:

Nella tua app AI aggiungi Guestbud con l'indirizzo del tuo server come indicato sopra e avvia la connessione.
Si apre una pagina di Guestbud. Accedi con il tuo normale login di Guestbud (su guestbud.io inserisci anche il nome breve della tua azienda).
Controlla il nome dell'app e dove ritorna (per esempio claude.ai), scegli il ruolo per l'app e clicca Allow.
Tornato nell'app AI, gli strumenti di Guestbud sono disponibili. Chiedi, per esempio: “Quali ospiti arrivano questa settimana?”.

Resta collegata: l'app rinnova il proprio accesso automaticamente in background (ogni ora). Non devi ricollegarti finché l'agente viene usato almeno una volta ogni 60 giorni.

Chi può collegarsi: in Settings → AI agent (MCP) → Who may connect AI apps with sign-in scegli Team members who manage users (predefinito), All team members (ciascuno fino al proprio ruolo) o Nobody. Passando a Nobody si interrompono subito tutte le connessioni tramite accesso.

App collegate: la stessa pagina elenca ogni app collegata con la persona che ha effettuato l'accesso, il suo ruolo e l'ultimo utilizzo. Disconnect la interrompe subito.

3. Collegati con una chiave API (strumenti di automazione e il tuo codice) #

Usa una chiave per gli strumenti che funzionano senza che nessuno acceda: n8n, Make, framework per agenti, script e server.

Apri Settings → AI agent (MCP) ed espandi For automation tools and your own code (API key) (ti serve il permesso di gestire gli utenti).
Inserisci un Name, per esempio n8n — risposte agli ospiti, e scegli il Role.
Clicca Create key and show the setup.
La chiave completa (gpk_…) viene mostrata una sola volta, insieme alle righe di configurazione già pronte che la contengono. Copiale subito. Se perdi la chiave, revocala e creane una nuova.

Una chiave funziona solo per il tuo account. Viene rifiutata sul dominio di un'altra azienda.

n8n e altri strumenti di automazione #

In n8n aggiungi un AI Agent con il MCP Client Tool:

Endpoint: https://guestbud.io/mcp
Server transport: HTTP Streamable
Authentication: Bearer Auth, token = la tua chiave gpk_…

Qualsiasi altro client MCP in grado di inviare un header funziona allo stesso modo:

URL: https://guestbud.io/mcp
Transport: Streamable HTTP
Header: Authorization: Bearer gpk_…

Claude Code, Claude Desktop, Cursor, Windsurf con una chiave #

Per queste app è preferibile l'accesso. Se vuoi comunque una chiave (per esempio su un server):

claude mcp add --transport http guestbud https://guestbud.io/mcp --header "Authorization: Bearer gpk_…"

Le app che avviano server MCP da un file di configurazione usano il bridge gratuito mcp-remote (richiede Node.js):

{
  "mcpServers": {
    "guestbud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://guestbud.io/mcp", "--header", "Authorization:${GUESTBUD_AUTH}"],
      "env": { "GUESTBUD_AUTH": "Bearer gpk_…" }
    }
  }
}

La chiave è nella parte env di proposito: evita problemi con gli spazi su Windows.

4. Usalo #

Chiedi in linguaggio naturale, come faresti con un collega. Alcuni esempi che funzionano bene:

Chat con gli ospiti: “Guarda le prenotazioni in arrivo nei prossimi tre giorni. Leggi le conversazioni su Airbnb e Booking.com e prepara le risposte alle domande senza risposta. Mostramele prima di inviarle.”
Sollecito del check-in: “Chi arriva domani e non ha fatto il check-in online? Invia loro un promemoria tramite la chat della prenotazione.”
Check-in anticipato: “L'ospite della prenotazione GP-7KQ2XD può fare il check-in alle 12:00: sblocca i codici in anticipo e diglielo in chat.”
Annunci: “Mostrami i passaggi per il check-in di Capua Flats e correggi il codice dell'ascensore in 3044.”
Segnalazioni: “Elenca le segnalazioni aperte; imposta quella del Wi-Fi di Harbour Loft come risolta con la nota ‘router riavviato’.”
Pulizie: “Cosa deve fare il team delle pulizie sabato, in ordine di orario di partenza? Segna i cambi nello stesso giorno.”
Messaggi: “Riscrivi l'email con i dettagli del check-in con un tono più caloroso, mantieni tutti i segnaposto e mostrami un'anteprima con la prossima prenotazione.”
Numeri: “Quanti late check-out abbiamo venduto il mese scorso, e quali extra hanno venduto di più?”

Consiglio: fai prima scrivere all'agente i messaggi per gli ospiti e fatteli mostrare (“mostrameli prima di inviarli”). Quando ti fidi, puoi lasciarlo inviare direttamente.

Sicurezza #

Scegli tu i permessi: il ruolo della chiave o dell'accesso decide tutto. L'agente vede solo gli strumenti che il suo ruolo consente, e il server controlla di nuovo ogni chiamata.
Nessun movimento di denaro: rimborsi, depositi, impostazioni di pagamento, utenti e chiavi non sono raggiungibili tramite MCP.
Testo degli ospiti non attendibile: gli ospiti possono scrivere qualsiasi cosa in una chat o in un modulo di check-in. Guestbud dice all'agente di trattare tutto ciò che ha scritto un ospite come informazione, mai come istruzione. Gli dice anche di non inviare i codici della porta prima che la prenotazione li indichi come visibili. Controlla comunque cosa invia l'agente, soprattutto all'inizio.
Ogni modifica viene registrata: ogni azione che cambia qualcosa (un messaggio inviato, una prenotazione o un annuncio modificati, un codice sbloccato …) compare in Settings → Audit trail con il nome dell'app o della chiave. Le semplici consultazioni non vengono elencate, così il registro resta leggibile.
Meno dati personali: l'agente riceve ciò che gli serve per aiutare gli ospiti, non di più. I dettagli della prenotazione escludono i dati dei documenti d'identità e i file caricati, gli indirizzi IP e il codice della serratura smart della prenotazione. L'accesso all'API in sola lettura esclude file, utenti, chiavi API, audit trail, webhook, dati di registrazione degli ospiti e impostazioni di pagamento, email e serrature.
Limiti: al massimo 120 chiamate a strumenti al minuto e 40 messaggi agli ospiti all'ora per connessione o chiave; al massimo 10 richieste in un batch, e le risposte molto lunghe vengono accorciate.
Accesso sicuro: Guestbud usa lo standard per l'accesso delle app AI (OAuth 2.1 con PKCE). L'app non vede mai la tua password; riceve un token di accesso valido per un'ora e un token di rinnovo che cambia a ogni utilizzo. Se un token di rinnovo viene usato due volte, Guestbud chiude la connessione. Un token di accesso funziona solo per la connessione dell'agente AI, non per il resto dell'API.
Revoca in qualsiasi momento: Settings → AI agent (MCP) → Disconnect (accesso) o Revoke (chiave). L'agente perde subito l'accesso.
Il tuo fornitore di AI: i dati che l'agente legge vengono elaborati dal servizio AI che colleghi (per esempio Anthropic per Claude). Verifica che sia coerente con l'informativa privacy per i tuoi ospiti.

Domande frequenti #

Quali agenti AI funzionano con Guestbud? #

Qualsiasi client MCP. ChatGPT, claude.ai, Claude Desktop e mobile, Claude Code e Cursor si collegano con l'accesso. n8n, i framework per agenti e il tuo codice si collegano con una chiave API.

Quanto dura una connessione tramite accesso? #

Finché la usi. L'app rinnova il proprio accesso automaticamente ogni ora; la connessione termina solo dopo 60 giorni senza alcun utilizzo, quando la scolleghi, oppure quando la persona che ha effettuato l'accesso viene rimossa, disattivata, riceve un altro ruolo o cambia password.

L'agente può inviare i codici della porta agli ospiti? #

Solo se il suo ruolo può leggere prenotazioni e annunci, e solo quando la prenotazione dell'ospite indica i codici come visibili: check-in e pagamenti completati e orario di check-in raggiunto (o sbloccato in anticipo da te). L'agente conosce questa regola. I tuoi modelli di messaggio con {doorCodes} seguono automaticamente la stessa regola.

Più agenti possono usare Guestbud contemporaneamente? #

Sì. Ogni accesso e ogni chiave è una connessione separata con il proprio ruolo, elencata separatamente nell'audit trail, e puoi scollegarne una senza toccare le altre.

L'agente costa qualcosa in Guestbud? #

No. L'accesso MCP fa parte del tuo account. L'agente vero e proprio te lo fattura il tuo fornitore di AI.

C'è anche un'API per gli sviluppatori? #

Sì: l'agente usa gli stessi permessi della REST API e dei webhook; vedi la guida rapida all'API.