KI und MCP · Luma Concierge-Leitfaden

Was ist ein KI-Assistent mit MCP

MCP verbindet einen externen KI-Assistenten mit Luma Concierge. Der Eigentümer und der Manager können Fragen zum Hotelbetrieb stellen und Antworten basierend auf aktuellen Systemdaten erhalten. Dies ist eine separate Verbindung für das Team; der Gast benötigt sie nicht, um die App zu nutzen.

Der Server ist schreibgeschützt. Die KI kann einen Aktionsplan vorschlagen, aber die Zuweisung von Bearbeitern, das Ändern von Status, das Messaging von Gästen und Zahlungsvorgänge werden in der Luma-Oberfläche durchgeführt.

Welche Daten verfügbar sind

Tool	Was die KI erhält	Beispielfrage
`get_operational_overview`	Anzahl offener Anfragen nach Status, überfällige Anfragen und aktive Aufenthalte	"Erstelle eine kurze Zusammenfassung für den Schichtbeginn"
`list_open_requests`	Neueste offene Anfragen: Nummer, Titel, Status, Priorität, Bearbeiter und Daten	"Zeige neue Anfragen und schlage eine Bearbeitungsreihenfolge vor"
`list_active_stays`	Aktive Aufenthalte: Zimmer und Check-in- und Check-out-Daten	"Welche Check-outs stehen bei den aktiven Aufenthalten an?"
`list_service_catalog`	Aktive Dienstleistungen, Preise, Währung, Zahlungsmethode, Verfügbarkeitszeit und Buchungsregeln	"Welche Dienstleistungen sind verfügbar und wie viel kosten sie?"

Listen geben standardmäßig bis zu 20 Datensätze zurück; der Parameter limit legt 1 bis 50 fest. Es gibt keine Paginierung: Eine Liste mit 50 Datensätzen garantiert nicht die Vollständigkeit des Berichts. Anfragen werden von neu nach alt sortiert, Aufenthalte nach Check-out-Zeit. Für die vollständige Anzahl verwenden Sie die Zusammenfassung.

Für Anfragen gibt es einen status-Filter: new, accepted, in_progress, waiting_guest, ready. Abgeschlossene und stornierte Anfragen sind nicht in der offenen Liste enthalten. Der Katalog gibt Namen und Beschreibungen auf Englisch zurück; der Assistent kann die Antwort übersetzen. Der Preis wird in price_minor gespeichert: Für IDR ist es der angezeigte Betrag, für andere unterstützte Währungen sind es Hundertstel der Währung.

Wie man sich verbindet

Melden Sie sich im Dashboard des Eigentümers an und öffnen Sie "KI und MCP" im Verwaltungsmenü. Geben Sie einen Verbindungsnamen ein und klicken Sie auf "Token erstellen". Kopieren Sie das ausgegebene Token: Es wird nur auf dieser Seite nach der Erstellung angezeigt. Der Manager erhält das Token vom Hotelbesitzer.
Fügen Sie in den Einstellungen eines kompatiblen KI-Clients einen Remote-MCP-Server mit HTTP-Unterstützung und einem Autorisierungsheader hinzu.
Geben Sie die Adresse https://lalo.craabchee.com/mcp und die Bearer-Autorisierung mit dem ausgegebenen Token an. Der Client muss bei jeder Anfrage den Header Authorization: Bearer <MCP_TOKEN> senden. Hier ist <MCP_TOKEN> ein Platzhalter, kein echter Schlüssel.
Speichern Sie die Verbindung und prüfen Sie, ob der Client die vier Tools aus der obigen Tabelle sieht.
Fordern Sie die Hotelzusammenfassung an. Vergleichen Sie das Ergebnis mit den aktuellen Dashboard-Daten und prüfen Sie die generated_at-Zeit.

Das Protokoll 2025-11-25, JSON-RPC 2.0 und JSON-Antworten auf POST-Anfragen werden unterstützt. Ein GET/SSE-Stream wird nicht bereitgestellt. OAuth-Anmeldung ist nicht implementiert: Ein Client, der strikt OAuth erfordert, kann sich auf diese Weise nicht verbinden. Die spezifischen Feldnamen hängen vom KI-Client ab.

Beispielaufforderungen für das Team

Eigentümer: "Holen Sie die aktuelle Zusammenfassung über MCP. Zeigen Sie offene Anfragen nach Status, die Anzahl der überfälligen und aktiven Aufenthalte. Schlagen Sie drei Prioritäten für das Team vor. Geben Sie die Datenzeit und die Stichprobenbeschränkungen an."

Manager: "Holen Sie bis zu 50 neue Anfragen über list_open_requests mit status: new. Gruppieren Sie nach Priorität, markieren Sie Anfragen ohne Bearbeiter und schlagen Sie eine Bearbeitungsreihenfolge vor. Ändern Sie nichts."

Vorbereitung auf Check-outs: "Holen Sie bis zu 50 aktive Aufenthalte. Heben Sie die nächsten Check-outs mit Zimmernummern und Zeiten hervor. Identifizieren Sie keine Gäste und geben Sie an, ob die Liste begrenzt ist."

Katalog: "Holen Sie aktive Dienstleistungen. Erklären Sie Preise und Vorausbuchungsregeln in einfacher Sprache. Versprechen Sie keine Verfügbarkeit an einem bestimmten Datum: MCP gibt keine verbleibenden Slots zurück."

Anweisungen für den KI-Assistenten

Diese Anweisungen können in den Einstellungen Ihres Assistenten gespeichert werden:

Verwenden Sie die Luma MCP-Tools, um aktuelle Daten zu erhalten. Trennen Sie Fakten aus der Serverantwort von Empfehlungen. Geben Sie die Zusammenfassungszeit und Listenbeschränkungen an. Erfinden Sie keine fehlenden Daten und identifizieren Sie keine Gäste anhand von Zimmernummern und Daten. MCP ist schreibgeschützt. Um eine Anfrage zu ändern, eine Zahlung vorzunehmen oder eine Nachricht zu senden, schlagen Sie dem Manager vor, die Aktion in Luma durchzuführen. Wenn Daten nicht verfügbar sind, geben Sie dies direkt an.

Verbindungsverwaltung und Datenschutz

Jedes Token ist an ein Hotel gebunden. MCP gibt keine Gästenamen und Kontakte, PIN-Codes, Anfragebeschreibungen, interne Notizen oder Zahlungsdaten zurück. Allerdings sind Zimmernummern, Anfragentitel und Namen der zugewiesenen Mitarbeiter für den Assistenten verfügbar — wählen Sie einen KI-Client, dem Ihr Team vertraut.

Bewahren Sie das Token in sicheren Verbindungseinstellungen auf. Fügen Sie es nicht in Nachrichten, die Adressleiste, Screenshots oder gemeinsam genutzte Dokumente ein. Geben Sie für jeden Client ein separates Token aus. Wenn der Zugriff verloren geht oder ein Mitarbeiter wechselt, muss der Eigentümer "KI und MCP" im Dashboard öffnen und für die entsprechende Verbindung auf "Widerrufen" klicken.

Wenn die Verbindung nicht funktioniert

401: Das Token fehlt, ist falsch oder wurde widerrufen; überprüfen Sie auch die Aktivität des Hotels und den Abonnementzugriff mit dem Administrator.
403: Der Origin des Browser-Clients ist nicht erlaubt. Der Administrator muss die Einstellungen für erlaubte Origins überprüfen; deaktivieren Sie die Prüfung nicht.
405: Der Client verwendet GET. Die Verbindung muss über POST mit JSON-Antworten funktionieren.
429: Das Anfragelimit wurde überschritten. Warten Sie und wiederholen Sie die Anfrage; die Route ist auf 60 Anfragen pro Minute begrenzt.
Leere Liste: Es gibt möglicherweise keine übereinstimmenden Daten. Überprüfen Sie den Status, die Aufenthaltsdaten und den Filter; ersetzen Sie fehlende Daten nicht durch Annahmen.
OAuth erforderlich: Die aktuelle Integration verwendet ein Bearer-Token; wählen Sie einen kompatiblen Client.

Das Dashboard des Eigentümers zeigt den Verbindungsnamen, das Erstellungsdatum, die letzte Verwendung und den Status an. Um den KI-Client zu trennen, klicken Sie auf "Widerrufen". Der Widerruf beendet den Zugriff über dieses Token; um sich erneut zu verbinden, erstellen Sie ein neues. Tokens anderer Hotels sind nicht zugänglich, und der Manager kann keine Tokens ausstellen oder widerrufen.