Retour aux articles

Frans Veigar Garðarsson, CPO

Publié

Mis à jour

Serveur MCP Sweeply : interrogez l’IA sur votre hôtel

Serveur MCP Sweeply : interrogez l’IA sur votre hôtel

Le serveur MCP de Sweeply permet à des assistants IA tels que Claude, Cursor et n8n de lire en temps réel les données de housekeeping, de maintenance et de personnel d’un hôtel dans Sweeply. Ce guide explique ce que vous pouvez demander, comment vous connecter et comment la bêta protège les données.

Serveur MCP Sweeply : interrogez l’IA sur votre hôtel

En résumé

• Le serveur MCP de Sweeply connecte des assistants IA tels que Claude, Cursor et n8n aux données opérationnelles en temps réel d’un hôtel dans Sweeply. • Pendant la bêta, il est en lecture seule : l’assistant peut consulter les chambres, les tâches, les incidents, le personnel et les rapports, mais ne peut rien modifier. • Chaque clé API donne accès à un seul établissement, et les réservations n’incluent jamais les noms, adresses e-mail ni numéros de téléphone des clients. • L’adresse du serveur est https://mcp.getsweeply.com, et Sweeply active MCP par organisation pendant la bêta. • De nouveaux outils sont ajoutés à partir des retours des clients et sont généralement livrés en quelques jours, sans réinstallation.

Le serveur MCP de Sweeply connecte des assistants IA tels que Claude, Cursor et n8n aux données opérationnelles en temps réel de votre hôtel dans Sweeply. Une fois qu’il est activé, vous pouvez demander en langage courant combien de chambres sont encore sales, quels départs n’ont aucune femme ou valet de chambre attribué ou quels incidents de maintenance sont ouverts depuis plus d’une semaine, et obtenir les mêmes chiffres que ceux que votre équipe voit dans l’application web. Le serveur est en bêta et en lecture seule : l’assistant peut consulter votre établissement, mais ne peut encore rien modifier.

Sweeply commercialise un logiciel d’exploitation hôtelière : cet article présente donc notre propre produit. Chaque détail ci-dessous provient de la documentation MCP de Sweeply.

Qu’est-ce qu’un serveur MCP, et pourquoi un hôtel en a-t-il besoin ?

MCP signifie Model Context Protocol, une norme ouverte qui permet à un assistant IA d’appeler des outils dans d’autres logiciels. Au lieu de copier des chiffres depuis des rapports pour les coller dans une conversation, l’assistant interroge directement le système et répond avec des données en temps réel. Pour un hôtel, cela signifie qu’un directeur général, un directeur de l’hébergement ou une gouvernante générale peut poser ses questions comme à un collègue, et l’assistant va chercher la réponse dans Sweeply.

Sweeply gère déjà le housekeeping, la maintenance et les demandes des clients en complément de votre PMS, avec le statut des chambres synchronisé depuis le PMS grâce à l’une de plus de 20 intégrations. Le serveur MCP ouvre cette même vue aux outils d’IA que vos responsables utilisent déjà, sans nouveau tableau de bord à prendre en main.

Que pouvez-vous demander à l’assistant ?

L’assistant peut lire la vue d’ensemble du housekeeping, les chambres, les tâches, les incidents de maintenance, le planning du personnel et les rapports. Exemples de questions tirés de la documentation :

  • « Combien de chambres sont encore sales en ce moment ? »

  • « Quels départs de demain n’ont aucune femme ou valet de chambre attribué ? »

  • « Affichez les incidents de maintenance ouverts depuis plus d’une semaine. »

  • « À quoi ressemble la charge de travail de la semaine prochaine ? »

Comme les chambres et les membres du personnel peuvent être désignés en texte libre, vous pouvez aussi poser une question sur une seule chambre ou une seule personne. Si un nom est ambigu, le serveur renvoie les correspondances possibles au lieu de deviner, afin que l’assistant puisse vous demander de laquelle il s’agit.

À quoi ressemble un point du matin ?

Une gouvernante générale peut commencer la journée par une courte conversation. Demander la vue d’ensemble du jour renvoie les arrivées, les départs, les recouches et le nombre de chambres propres, sales ou contrôlées. Une question de suivi comme « quels départs ne sont pas encore attribués ? » liste ces chambres par numéro, et « qui est en service aujourd’hui ? » affiche l’équipe disponible pour s’en charger. Avant la réunion de l’après-midi, « affichez les incidents de maintenance ouverts depuis plus d’une semaine » fait remonter les incidents à relancer, chacun avec sa chambre et ses commentaires.

L’assistant répond à chaque question à partir des données en temps réel de Sweeply : personne n’a besoin d’exporter un rapport ni de passer au bureau pour consulter le tableau. L’attribution des chambres se fait toujours dans Sweeply, car la bêta n’effectue aucune modification.

Quels outils le serveur MCP de Sweeply comprend-il ?

La bêta compte douze outils de lecture répartis en trois groupes. Les assistants appellent d’abord get_property_context, afin de connaître votre fuseau horaire, la date du jour et vos catégories de tâches avant de répondre.

Groupe

Outils

Ce qu’ils lisent

La journée

get_property_context, get_day_overview, list_rooms, get_room, get_room_history, get_reservation, get_staff_today

Arrivées, départs, recouches et statut de nettoyage, le statut, le séjour, les tâches, les commentaires et les incidents ouverts d’une chambre, l’historique d’une chambre sur 31 jours maximum, les dates et le nombre de clients d’un séjour, et les personnes en service

Tâches et incidents

list_tasks, list_issues, get_issue

Tâches sur 31 jours maximum par type, statut, personne assignée ou chambre, incidents de maintenance ouverts par ancienneté ou par catégorie, et un incident avec ses commentaires et ses liens vers les photos

Planification et rapports

get_workload_forecast, get_housekeeping_performance

Arrivées, départs, recouches et nettoyages prévus par jour, et nettoyages terminés avec la durée moyenne en minutes par femme ou valet de chambre, par chambre ou par tâche

Les dates peuvent s’écrire au format YYYY-MM-DD ou simplement sous la forme aujourd’hui, demain ou hier, toujours dans le fuseau horaire de l’établissement. Les listes s’arrêtent à 50 lignes et indiquent le nombre total de lignes, pour que l’assistant sache quand il ne voit qu’une partie d’une liste.

Comment connecter Claude, Cursor ou n8n ?

Chaque client a besoin des deux mêmes éléments : l’adresse du serveur https://mcp.getsweeply.com et un en-tête Authorization contenant votre clé API Sweeply. Les étapes :

  1. Demandez à Sweeply d’activer MCP pour votre établissement. Il est désactivé par défaut pendant la bêta ; contactez le support ou votre chargé de compte.

  2. Créez une clé API dans l’application web Sweeply sous Paramètres, Compte, Clés API, puis copiez-la immédiatement, car elle ne s’affiche qu’une seule fois.

  3. Ajoutez le serveur à votre assistant avec l’adresse et l’en-tête Authorization: Bearer suivi de votre clé.

Dans Claude sur le web, sur ordinateur ou sur mobile, le serveur s’ajoute dans Paramètres, Connecteurs, en tant que connecteur personnalisé avec l’en-tête Authorization. Claude Code, Cursor et n8n acceptent chacun la même adresse et le même en-tête dans leurs propres paramètres ; la documentation MCP de Sweeply indique la configuration exacte pour chacun. ChatGPT n’est pas encore pris en charge, car les connecteurs ChatGPT s’authentifient via OAuth et le serveur MCP de Sweeply n’accepte pour l’instant que des clés API.

Les données de l’hôtel sont-elles en sécurité ?

La conception maintient l’assistant au sein d’un seul établissement et à l’écart des données personnelles des clients :

  • Une clé, un établissement. La clé API détermine l’établissement que l’assistant lit : les outils ne demandent donc jamais d’établissement et ne peuvent pas en atteindre un autre.

  • Lecture seule. Pendant la bêta, l’assistant peut consulter, mais ne peut rien créer, modifier ni supprimer.

  • Aucune donnée personnelle des clients. Les réservations contiennent un identifiant, des dates, une chambre et un nombre de clients, jamais de noms, d’adresses e-mail ni de numéros de téléphone.

  • Les textes du personnel sont marqués comme non fiables. Les commentaires, notes et descriptions d’incidents sont signalés pour que l’assistant les traite comme des informations, jamais comme des instructions.

  • Révocation facile. Supprimez une clé et l’assistant perd l’accès dès sa requête suivante. Attribuez à chaque personne ou outil sa propre clé, afin de pouvoir en retirer une sans perturber les autres.

Un point à anticiper : une clé API n’est pas un membre du personnel, donc les rôles du personnel et les groupes de zones ne limitent pas ce qu’elle lit. Une clé voit l’ensemble de l’établissement. L’hébergement et le traitement des données suivent la configuration habituelle de Sweeply, décrite sur notre page sécurité.

Comment s’articule-t-il avec les agents IA de Sweeply ?

Les agents IA de Sweeply travaillent dans Sweeply : Tracey lit les remarques de réservation et les transforme en tâches, et Roomey attribue les chambres. Le serveur MCP fonctionne dans l’autre sens. Il permet à l’assistant généraliste que vos responsables utilisent déjà de lire Sweeply, afin qu’ils puissent combiner des réponses opérationnelles avec leurs propres e-mails, tableurs ou plannings dans une seule conversation.

Et ensuite ?

Le serveur MCP évolue avec les retours des clients. Signalez à Sweeply une question à laquelle l’assistant n’a pas su répondre, et l’équipe vous répond le jour même avec ce qu’elle prévoit de développer ; les nouveaux outils sont généralement livrés en quelques jours et apparaissent automatiquement dans votre assistant, sans réinstallation ni nouvelle clé. La feuille de route de la documentation prévoit :

  • Des modifications en toute sécurité : créer et attribuer des tâches et signaler des incidents, avec une connexion personnelle pour que chaque modification soit faite au nom d’un membre du personnel.

  • Plusieurs établissements à la fois : une seule connexion pour un groupe hôtelier.

  • Davantage d’assistants : la prise en charge de la connexion pour ChatGPT et pour les autres clients qui fonctionnent uniquement avec OAuth.

Envoyez vos idées à support@getsweeply.com ou via le chat de l’application Sweeply, en précisant la question posée et la réponse que vous attendiez.

Quand ce guide ne s’applique pas

Le serveur MCP lit les données de Sweeply : il n’est donc utile qu’aux hôtels qui gèrent déjà leurs opérations dans Sweeply. Il ne lit pas directement votre PMS au-delà de ce que Sweeply synchronise, il ne peut pas effectuer de modifications pendant la bêta et il n’est pas encore disponible dans ChatGPT. Si votre équipe n’utilise pas d’assistant IA au travail, les rapports et la vue d’ensemble en temps réel de l’application web Sweeply fournissent les mêmes chiffres sans assistant.

Parlez à notre équipe commerciale

Vous voulez voir comment les hôtels utilisent Sweeply, et ce que vos responsables pourraient demander à un assistant IA sur votre établissement ? Réservez un appel avec notre équipe commerciale.

Conclusion

Le serveur MCP de Sweeply transforme vos données opérationnelles en réponses que vos responsables obtiennent auprès de l’assistant IA qu’ils utilisent déjà. Il est en lecture seule et en bêta, se connecte avec une clé API, tient à l’écart les données personnelles des clients et évolue au fil des questions envoyées par les hôtels.

Foire aux questions

Que puis-je demander au serveur MCP de Sweeply ?

Vous pouvez poser des questions sur la vue d’ensemble du housekeeping, les chambres, les tâches, les incidents de maintenance, le personnel en service, les prévisions de charge de travail et la performance du housekeeping, par exemple combien de chambres sont encore sales ou quels départs de demain n’ont aucune femme ou valet de chambre attribué.

Le serveur MCP de Sweeply fonctionne-t-il avec ChatGPT ?

Pas encore. Les connecteurs ChatGPT s’authentifient via OAuth, et le serveur MCP de Sweeply n’accepte pour l’instant que des clés API. La prise en charge de la connexion pour ChatGPT et pour les autres clients qui fonctionnent uniquement avec OAuth figure dans la feuille de route.

L’assistant IA peut-il modifier des données dans Sweeply ?

Non. Pendant la bêta, le serveur MCP est en lecture seule. La création et l’attribution de tâches ainsi que le signalement d’incidents, avec une connexion personnelle pour que chaque modification soit faite au nom d’un membre du personnel, sont prévus.

Comment activer le serveur MCP de Sweeply ?

Demandez au support Sweeply ou à votre chargé de compte d’activer MCP pour votre établissement, créez une clé API sous Paramètres, Compte, Clés API dans l’application web, puis ajoutez https://mcp.getsweeply.com avec cette clé à votre assistant.

L’assistant voit-il les données personnelles des clients ?

Non. Les réservations contiennent uniquement un identifiant, des dates, une chambre et un nombre de clients. Les noms, adresses e-mail et numéros de téléphone des clients ne sont jamais renvoyés.