Il server MCP di Sweeply collega assistenti IA come Claude, Cursor e n8n ai dati operativi in tempo reale del tuo hotel in Sweeply. Una volta attivato, puoi chiedere in linguaggio naturale quante camere sono ancora sporche, a quali partenze non è assegnato nessun cameriere ai piani o quali segnalazioni di manutenzione sono aperte da più di una settimana, e ottenere gli stessi numeri che il tuo team vede nella web app. Il server è in beta e in sola lettura: l’assistente può consultare la tua struttura ma non può ancora modificare nulla.

Sweeply vende software per la gestione operativa degli hotel, quindi questo articolo descrive un nostro prodotto. Ogni dettaglio che segue proviene dalla documentazione MCP di Sweeply.

Che cos’è un server MCP e perché serve a un hotel?

MCP sta per Model Context Protocol, uno standard aperto che permette a un assistente IA di usare gli strumenti di altri software. Invece di copiare i numeri dai report e incollarli in una chat, l’assistente interroga direttamente il sistema e risponde con dati in tempo reale. Per un hotel significa che un general manager, un rooms division manager o una governante possono fare domande come le farebbero a un collega, e l’assistente recupera la risposta da Sweeply.

Sweeply gestisce già housekeeping, manutenzione e richieste degli ospiti a partire dal tuo PMS, con lo stato delle camere sincronizzato dal PMS tramite una delle oltre 20 integrazioni. Il server MCP rende disponibile questa stessa visione agli strumenti di IA che i tuoi manager usano già, senza un’altra dashboard da imparare.

Cosa puoi chiedere all’assistente?

L’assistente può leggere la panoramica dell’housekeeping, le camere, le attività, le segnalazioni di manutenzione, i turni del personale e i report. Domande tipiche tratte dalla documentazione:

• “Quante camere sono ancora sporche in questo momento?”

• “A quali partenze di domani non è assegnato nessun cameriere ai piani?”

• “Mostrami le segnalazioni di manutenzione aperte da più di una settimana.”

• “Come si presenta il carico di lavoro della prossima settimana?”

Poiché camere e personale si possono indicare per nome in testo libero, puoi chiedere anche di una singola camera o persona. Se un nome è ambiguo, il server restituisce i possibili risultati invece di tirare a indovinare, così l’assistente può chiederti a quale ti riferivi.

Come funziona un controllo mattutino?

Una governante potrebbe iniziare la giornata con una breve conversazione. Chiedendo la panoramica di oggi ottiene arrivi, partenze, riassetti durante il soggiorno e quante camere sono pulite, sporche o ispezionate. Una domanda successiva come “quali check-out non sono ancora assegnati?” elenca quelle camere per numero, e “chi è in turno oggi?” mostra il team disponibile a occuparsene. Prima della riunione del pomeriggio, “mostrami le segnalazioni di manutenzione aperte da più di una settimana” fa emergere le segnalazioni da sollecitare, ciascuna con la sua camera e i relativi commenti.

L’assistente risponde a ogni domanda con i dati in tempo reale di Sweeply, quindi nessuno deve esportare un report o andare in ufficio a controllare il tabellone. L’assegnazione delle camere avviene comunque in Sweeply, perché la beta non apporta modifiche.

Quali strumenti include il server MCP di Sweeply?

La beta offre dodici strumenti di lettura suddivisi in tre gruppi. Gli assistenti chiamano per primo get_property_context, così conoscono il fuso orario, la data di oggi e le categorie di attività della tua struttura prima di rispondere.

Le date si possono scrivere nel formato YYYY-MM-DD o semplicemente come oggi, domani o ieri, sempre nel fuso orario della struttura. Gli elenchi si fermano a 50 righe e indicano quante righe ci sono in totale, così l’assistente sa quando sta guardando solo una parte di un elenco.

Come colleghi Claude, Cursor o n8n?

Ogni client ha bisogno delle stesse due cose: l’indirizzo del server https://mcp.getsweeply.com e un’intestazione Authorization che contiene la tua chiave API di Sweeply. I passaggi:

1. Chiedi a Sweeply di attivare MCP per la tua struttura. Durante la beta è disattivato per impostazione predefinita; contatta l’assistenza o il tuo account manager.

2. Crea una chiave API nella web app di Sweeply in Impostazioni, Account, Chiavi API, e copiala subito, perché viene mostrata una sola volta.

3. Aggiungi il server al tuo assistente con l’indirizzo e l’intestazione Authorization: Bearer seguita dalla tua chiave.

In Claude sul web, su desktop o su mobile, il server si aggiunge in Impostazioni, Connettori, come connettore personalizzato con l’intestazione Authorization. Claude Code, Cursor e n8n accettano ciascuno lo stesso indirizzo e la stessa intestazione nelle proprie impostazioni; la documentazione MCP di Sweeply riporta la configurazione esatta per ognuno. ChatGPT non è ancora supportato, perché i connettori di ChatGPT effettuano l’accesso tramite OAuth e per ora il server MCP di Sweeply accetta solo chiavi API.

I dati dell’hotel sono al sicuro?

Il design mantiene l’assistente all’interno di una sola struttura e lontano dai dati personali degli ospiti:

• Una chiave, una struttura. La chiave API determina quale struttura legge l’assistente, quindi gli strumenti non chiedono mai una struttura e non possono raggiungerne un’altra.

• Sola lettura. Nella beta l’assistente può consultare ma non può creare, modificare o eliminare nulla.

• Nessun dato personale degli ospiti. Le prenotazioni contengono un id, le date, la camera e il numero di ospiti, mai nomi, indirizzi email o numeri di telefono.

• I testi del personale sono contrassegnati come non attendibili. Commenti, note e descrizioni delle segnalazioni vengono contrassegnati in modo che l’assistente li tratti come informazioni, mai come istruzioni.

• Facile da revocare. Elimina una chiave e l’assistente perde l’accesso alla richiesta successiva. Assegna a ogni persona o strumento la propria chiave, così puoi rimuoverne una senza bloccare le altre.

Un punto da pianificare: una chiave API non è un membro del personale, quindi i ruoli del personale e i gruppi di aree non limitano ciò che legge. Una chiave vede l’intera struttura. Hosting e trattamento dei dati seguono la configurazione abituale di Sweeply, descritta nella nostra pagina sulla sicurezza.

Come si integra con gli agenti IA di Sweeply?

Gli agenti IA di Sweeply lavorano all’interno di Sweeply: Tracey legge le note delle prenotazioni e le trasforma in attività, e Roomey assegna le camere. Il server MCP funziona al contrario. Permette all’assistente generico che i tuoi manager usano già di leggere Sweeply, così possono combinare le risposte operative con le proprie email, i fogli di calcolo o la pianificazione in un’unica conversazione.

Cosa arriverà in futuro?

Il server MCP cresce con il feedback dei clienti. Segnala a Sweeply una domanda a cui l’assistente non ha saputo rispondere e il team ti risponde in giornata con ciò che intende sviluppare; i nuovi strumenti di solito vengono rilasciati in pochi giorni e compaiono automaticamente nel tuo assistente, senza reinstallazioni e senza una nuova chiave. La roadmap nella documentazione prevede:

• Modifiche in sicurezza: creazione e assegnazione di attività e segnalazione di problemi, con un accesso personale così che ogni modifica venga fatta a nome di un membro del personale.

• Più strutture contemporaneamente: un’unica connessione per un gruppo alberghiero.

• Più assistenti: supporto all’accesso per ChatGPT e per altri client che usano solo OAuth.

Invia le tue idee a support@getsweeply.com o tramite la chat nell’app di Sweeply, indicando la domanda che hai fatto e la risposta che ti aspettavi.

Quando questa guida non si applica

Il server MCP legge i dati da Sweeply, quindi è utile solo agli hotel che gestiscono già le proprie operazioni in Sweeply. Non legge direttamente il tuo PMS oltre a ciò che Sweeply sincronizza, non può apportare modifiche durante la beta e non è ancora disponibile in ChatGPT. Se il tuo team non usa un assistente IA al lavoro, i report e la panoramica in tempo reale nella web app di Sweeply forniscono gli stessi numeri anche senza.

Parla con il nostro team commerciale

Vuoi vedere come gli hotel usano Sweeply e cosa potrebbero chiedere i tuoi manager a un assistente IA sulla tua struttura? Prenota una chiamata con il nostro team commerciale.