IA et MCP · Guide du Concierge Luma

Qu'est-ce qu'un assistant IA avec MCP

MCP connecte un assistant IA externe à Luma Concierge. Le propriétaire et le gestionnaire peuvent poser des questions sur les opérations de l'hôtel et recevoir des réponses basées sur les données actuelles du système. Il s'agit d'une connexion distincte pour l'équipe ; le client n'en a pas besoin pour utiliser l'application.

Le serveur est en lecture seule. L'IA peut suggérer un plan d'action, mais l'attribution des assignés, la modification des statuts, l'envoi de messages aux clients et les opérations de paiement sont effectués dans l'interface Luma.

Quelles données sont disponibles

Outil	Ce que l'IA reçoit	Exemple de question
`get_operational_overview`	Nombre de demandes ouvertes par statut, demandes en retard et séjours actifs	"Préparez un bref résumé pour le début du quart de travail"
`list_open_requests`	Dernières demandes ouvertes : numéro, titre, statut, priorité, assigné et dates	"Affichez les nouvelles demandes et suggérez un ordre de traitement"
`list_active_stays`	Séjours actifs : chambre et dates d'arrivée et de départ	"Quels départs sont à venir parmi les séjours actifs ?"
`list_service_catalog`	Services actifs, prix, devise, mode de paiement, horaire de disponibilité et règles de réservation	"Quels services sont disponibles et combien coûtent-ils ?"

Les listes renvoient jusqu'à 20 enregistrements par défaut ; le paramètre limit définit de 1 à 50. Il n'y a pas de pagination : une liste de 50 enregistrements ne garantit pas l'exhaustivité du rapport. Les demandes sont triées de la plus récente à la plus ancienne, les séjours par heure de départ. Pour le nombre complet, utilisez le résumé.

Pour les demandes, il existe un filtre status : new, accepted, in_progress, waiting_guest, ready. Les demandes terminées et annulées ne sont pas incluses dans la liste ouverte. Le catalogue renvoie les noms et descriptions en anglais ; l'assistant peut traduire la réponse. Le prix est stocké dans price_minor : pour IDR, il s'agit du montant affiché, pour les autres devises prises en charge, il s'agit de centièmes de la devise.

Comment se connecter

Connectez-vous au tableau de bord du propriétaire, ouvrez "IA et MCP" dans le menu de gestion. Saisissez un nom de connexion et cliquez sur "Créer un jeton". Copiez le jeton émis : il n'est affiché que sur cette page après la création. Le gestionnaire reçoit le jeton du propriétaire de l'hôtel.
Dans les paramètres d'un client IA compatible, ajoutez un serveur MCP distant avec prise en charge HTTP et un en-tête d'autorisation.
Spécifiez l'adresse https://lalo.craabchee.com/mcp et l'autorisation Bearer avec le jeton émis. Le client doit envoyer l'en-tête Authorization: Bearer <MCP_TOKEN> à chaque requête. Ici, <MCP_TOKEN> est un espace réservé, pas une vraie clé.
Enregistrez la connexion et vérifiez que le client voit les quatre outils du tableau ci-dessus.
Demandez le résumé de l'hôtel. Comparez le résultat avec les données actuelles du tableau de bord et vérifiez l'heure generated_at.

Le protocole 2025-11-25, JSON-RPC 2.0 et les réponses JSON aux requêtes POST sont pris en charge. Un flux GET/SSE n'est pas fourni. La connexion OAuth n'est pas implémentée : un client qui exige strictement OAuth ne pourra pas se connecter de cette manière. Les noms de champs spécifiques dépendent du client IA.

Exemples d'invites pour l'équipe

Propriétaire : "Obtenez le résumé actuel via MCP. Affichez les demandes ouvertes par statut, le nombre de séjours en retard et actifs. Suggérez trois priorités pour l'équipe. Précisez l'heure des données et les limites d'échantillonnage."

Gestionnaire : "Obtenez jusqu'à 50 nouvelles demandes via list_open_requests avec status: new. Regroupez par priorité, signalez les demandes sans assigné et suggérez un ordre de traitement. Ne changez rien."

Préparation des départs : "Obtenez jusqu'à 50 séjours actifs. Mettez en évidence les départs les plus proches avec les numéros de chambre et les heures. N'identifiez pas les clients et indiquez si la liste est limitée."

Catalogue : "Obtenez les services actifs. Expliquez les prix et les règles de réservation anticipée en langage simple. Ne promettez pas de disponibilité à une date spécifique : MCP ne renvoie pas les créneaux restants."

Instructions pour l'assistant IA

Ces instructions peuvent être enregistrées dans les paramètres de votre assistant :

Utilisez les outils Luma MCP pour obtenir des données actuelles. Séparez les faits de la réponse du serveur des recommandations. Précisez l'heure du résumé et les limites de la liste. N'inventez pas de données manquantes et n'identifiez pas les clients par les numéros de chambre et les dates. MCP est en lecture seule. Pour modifier une demande, effectuer un paiement ou envoyer un message, suggérez que le gestionnaire effectue l'action dans Luma. Si les données ne sont pas disponibles, indiquez-le directement.

Gestion des connexions et confidentialité

Chaque jeton est lié à un seul hôtel. MCP ne renvoie pas les noms et coordonnées des clients, les codes PIN, les descriptions des demandes, les notes internes ou les données de paiement. Cependant, les numéros de chambre, les titres des demandes et les noms du personnel assigné sont accessibles à l'assistant — choisissez un client IA en lequel votre équipe a confiance.

Stockez le jeton dans des paramètres de connexion sécurisés. Ne le collez pas dans des messages, la barre d'adresse, des captures d'écran ou des documents partagés. Émettez un jeton distinct pour chaque client. En cas de perte d'accès ou de changement d'employé, le propriétaire doit ouvrir "IA et MCP" dans le tableau de bord et cliquer sur "Révoquer" pour la connexion correspondante.

Si la connexion ne fonctionne pas

401 : le jeton est manquant, incorrect ou révoqué ; vérifiez également l'activité de l'hôtel et l'accès à l'abonnement auprès de l'administrateur.
403 : l'origine du client navigateur n'est pas autorisée. L'administrateur doit vérifier les paramètres des origines autorisées ; ne désactivez pas la vérification.
405 : le client utilise GET. La connexion doit fonctionner via POST avec des réponses JSON.
429 : la limite de requêtes a été dépassée. Attendez et réessayez la requête ; la route est limitée à 60 requêtes par minute.
Liste vide : il se peut qu'il n'y ait pas de données correspondantes. Vérifiez le statut, les dates de séjour et le filtre ; ne remplacez pas les données manquantes par des suppositions.
OAuth requis : l'intégration actuelle utilise un jeton Bearer ; choisissez un client compatible.

Le tableau de bord du propriétaire affiche le nom de la connexion, la date de création, la dernière utilisation et le statut. Pour déconnecter le client IA, cliquez sur "Révoquer". La révocation met fin à l'accès via ce jeton ; pour vous reconnecter, créez-en un nouveau. Les jetons des autres hôtels ne sont pas accessibles, et le gestionnaire ne peut pas émettre ou révoquer de jetons.