AI en MCP

Wat is een AI-assistent met MCP

MCP verbindt een externe AI-assistent met Luma Concierge. De eigenaar en manager kunnen vragen stellen over hotelactiviteiten en antwoorden ontvangen op basis van actuele systeemgegevens. Dit is een aparte verbinding voor het team; de gast heeft deze niet nodig om de app te gebruiken.

De server is alleen-lezen. De AI kan een actieplan voorstellen, maar het toewijzen van verantwoordelijken, het wijzigen van statussen, het berichten van gasten en betalingshandelingen worden uitgevoerd in de Luma-interface.

Welke gegevens beschikbaar zijn

Lijsten retourneren standaard maximaal 20 records; de parameter limit stelt in van 1 tot 50. Er is geen paginering: een lijst van 50 records garandeert niet de volledigheid van het rapport. Verzoeken zijn gesorteerd van nieuw naar oud, verblijven op uitchecktijd. Voor het volledige aantal, gebruik de samenvatting.

Voor verzoeken is er een status-filter: new, accepted, in_progress, waiting_guest, ready. Voltooide en geannuleerde verzoeken zijn niet opgenomen in de open lijst. De catalogus retourneert namen en beschrijvingen in het Engels; de assistent kan het antwoord vertalen. De prijs is opgeslagen in price_minor: voor IDR is het het weergegeven bedrag, voor andere ondersteunde valuta's is het honderdsten van de valuta.

Hoe te verbinden

1. Log in op het dashboard van de eigenaar, open "AI en MCP" in het beheer menu. Voer een verbindingsnaam in en klik op "Token aanmaken". Kopieer het uitgegeven token: het wordt alleen op deze pagina getoond na aanmaak. De manager ontvangt het token van de hoteleigenaar.
2. Voeg in de instellingen van een compatibele AI-client een externe MCP-server toe met HTTP-ondersteuning en een autorisatieheader.
3. Geef het adres https://lalo.craabchee.com/mcp op en Bearer-autorisatie met het uitgegeven token. De client moet de header Authorization: Bearer <MCP_TOKEN> bij elk verzoek meesturen. Hier is <MCP_TOKEN> een plaatsaanduiding, geen echte sleutel.
4. Sla de verbinding op en controleer of de client de vier tools uit de bovenstaande tabel ziet.
5. Vraag de hotelsamenvatting op. Vergelijk het resultaat met de huidige dashboardgegevens en controleer de generated_at-tijd.

Het protocol 2025-11-25, JSON-RPC 2.0 en JSON-antwoorden op POST-verzoeken worden ondersteund. Een GET/SSE-stream wordt niet geboden. OAuth-login is niet geïmplementeerd: een client die strikt OAuth vereist, kan op deze manier geen verbinding maken. De specifieke veldnamen zijn afhankelijk van de AI-client.

Voorbeeldprompts voor het team

Eigenaar: "Haal de huidige samenvatting op via MCP. Toon openstaande verzoeken per status, het aantal te late en actieve verblijven. Stel drie prioriteiten voor het team voor. Geef de gegevenstijd en beperkingen van de steekproef aan."

Manager: "Haal tot 50 nieuwe verzoeken op via list_open_requests met status: new. Groepeer op prioriteit, markeer verzoeken zonder toegewezen persoon en stel een behandelingsvolgorde voor. Wijzig niets."

Voorbereiding op check-outs: "Haal tot 50 actieve verblijven op. Markeer de dichtstbijzijnde check-outs met kamernummers en tijden. Identificeer geen gasten en geef aan of de lijst beperkt is."

Catalogus: "Haal actieve diensten op. Leg prijzen en boekingsregels vooraf in eenvoudige taal uit. Beloof geen beschikbaarheid op een specifieke datum: MCP retourneert geen resterende slots."

Instructies voor de AI-assistent

Deze instructies kunnen worden opgeslagen in de instellingen van uw assistent:

Gebruik de Luma MCP-tools om actuele gegevens op te halen. Scheid feiten van het serverantwoord van aanbevelingen. Geef de samenvattingstijd en lijstbeperkingen aan. Verzin geen ontbrekende gegevens en identificeer geen gasten aan de hand van kamernummers en datums. MCP is alleen-lezen. Om een verzoek te wijzigen, een betaling te doen of een bericht te sturen, stel voor dat de manager de actie in Luma uitvoert. Als gegevens niet beschikbaar zijn, geef dat dan direct aan.

Verbindingsbeheer en privacy

Elk token is gekoppeld aan één hotel. MCP retourneert geen gastennamen en contactgegevens, pincodes, verzoekbeschrijvingen, interne notities of betalingsgegevens. Kamernummers, verzoektitels en namen van toegewezen personeel zijn echter beschikbaar voor de assistent — kies een AI-client die uw team vertrouwt.

Bewaar het token in beveiligde verbindingsinstellingen. Plak het niet in berichten, de adresbalk, screenshots of gedeelde documenten. Geef een apart token uit voor elke client. Als de toegang verloren gaat of een medewerker wisselt, moet de eigenaar "AI en MCP" openen in het dashboard en op "Intrekken" klikken voor de betreffende verbinding.

Als de verbinding niet werkt

• 401: het token ontbreekt, is onjuist of ingetrokken; controleer ook de activiteit van het hotel en de abonnementstoegang met de beheerder.
• 403: de Origin van de browserclient is niet toegestaan. De beheerder moet de instellingen voor toegestane origins controleren; schakel de controle niet uit.
• 405: de client gebruikt GET. De verbinding moet werken via POST met JSON-antwoorden.
• 429: de verzoeklimiet is overschreden. Wacht en probeer het verzoek opnieuw; de route is beperkt tot 60 verzoeken per minuut.
• Lege lijst: er zijn mogelijk geen overeenkomende gegevens. Controleer de status, verblijfsdatums en filter; vervang ontbrekende gegevens niet door aannames.
• OAuth vereist: de huidige integratie gebruikt een Bearer-token; kies een compatibele client.

Het dashboard van de eigenaar toont de verbindingsnaam, aanmaakdatum, laatste gebruik en status. Om de AI-client los te koppelen, klikt u op "Intrekken". Intrekking beëindigt de toegang via dit token; om opnieuw te verbinden, maakt u een nieuw token aan. Tokens van andere hotels zijn niet toegankelijk en de manager kan geen tokens uitgeven of intrekken.