Terug naar artikelen

Frans Veigar Garðarsson, CPO

Gepubliceerd

Bijgewerkt

Sweeply MCP-server: stel AI vragen over hoteloperaties

Sweeply MCP-server: stel AI vragen over hoteloperaties

Met de Sweeply MCP-server kunnen AI-assistenten zoals Claude, Cursor en n8n de live gegevens over housekeeping, technische dienst en personeel van een hotel in Sweeply lezen. Deze gids legt uit wat je kunt vragen, hoe je koppelt en hoe de bèta je gegevens veilig houdt.

Sweeply MCP-server: stel AI vragen over hoteloperaties

Kortom

• De Sweeply MCP-server koppelt AI-assistenten zoals Claude, Cursor en n8n aan de live operationele gegevens van een hotel in Sweeply. • Tijdens de bèta is hij alleen-lezen, dus de assistent kan kamers, taken, meldingen, medewerkers en rapporten bekijken, maar niets wijzigen. • Elke API-sleutel geeft toegang tot één accommodatie, en reserveringen bevatten nooit namen, e-mailadressen of telefoonnummers van gasten. • Het serveradres is https://mcp.getsweeply.com, en tijdens de bèta zet Sweeply MCP per organisatie aan. • Nieuwe tools worden toegevoegd op basis van feedback van klanten en verschijnen meestal binnen enkele dagen, zonder dat je opnieuw hoeft te installeren.

De Sweeply MCP-server koppelt AI-assistenten zoals Claude, Cursor en n8n aan de live operationele gegevens van je hotel in Sweeply. Zodra hij is ingeschakeld, kun je in gewone taal vragen hoeveel kamers nog vuil zijn, aan welke vertrekken nog geen housekeeper is toegewezen of welke meldingen voor de technische dienst al langer dan een week openstaan, en krijg je dezelfde cijfers die je team in de webapp ziet. De server is in bèta en alleen-lezen: de assistent kan je accommodatie bekijken, maar nog niets wijzigen.

Sweeply verkoopt software voor hoteloperaties, dus dit artikel beschrijft ons eigen product. Alle details hieronder komen uit de Sweeply MCP-documentatie.

Wat is een MCP-server en waarom heeft een hotel er een nodig?

MCP staat voor Model Context Protocol, een open standaard waarmee een AI-assistent tools in andere software kan aanroepen. In plaats van cijfers uit rapporten te kopiëren en in een chat te plakken, vraagt de assistent het systeem rechtstreeks en antwoordt hij met live gegevens. Voor een hotel betekent dat dat een general manager, rooms division manager of hoofd housekeeping vragen kan stellen zoals aan een collega, waarna de assistent het antwoord uit Sweeply haalt.

Sweeply regelt al housekeeping, technische dienst en gastverzoeken bovenop je PMS, met de kamerstatus gesynchroniseerd vanuit het PMS via een van de 20+ integraties. De MCP-server stelt datzelfde beeld open voor de AI-tools die je managers al gebruiken, zonder dat ze nog een dashboard hoeven te leren.

Wat kun je de assistent vragen?

De assistent kan je housekeepingoverzicht, kamers, taken, meldingen voor de technische dienst, personeelsrooster en rapporten lezen. Typische vragen uit de documentatie:

  • “Hoeveel kamers zijn er op dit moment nog vuil?”

  • “Aan welke vertrekken van morgen is nog geen housekeeper toegewezen?”

  • “Toon openstaande meldingen voor de technische dienst die ouder zijn dan een week.”

  • “Hoe ziet de werklast van volgende week eruit?”

Omdat je kamers en medewerkers in gewone tekst kunt noemen, kun je ook naar één kamer of persoon vragen. Is een naam niet eenduidig, dan geeft de server de mogelijke kandidaten terug in plaats van te gokken, zodat de assistent je kan vragen welke je bedoelde.

Hoe ziet een ochtendcheck eruit?

Een hoofd housekeeping kan de dag beginnen met één kort gesprek. Wie om het overzicht van vandaag vraagt, krijgt de aankomsten, vertrekken en tussentijdse schoonmaken te zien en hoeveel kamers schoon, vuil of geïnspecteerd zijn. Een vervolgvraag zoals “welke vertrekschoonmaken zijn nog niet toegewezen?” geeft die kamers op nummer, en “wie heeft er vandaag dienst?” toont het team dat beschikbaar is om ze op te pakken. Voor het middagoverleg haalt “toon openstaande meldingen voor de technische dienst die ouder zijn dan een week” de meldingen naar boven die opgevolgd moeten worden, elk met de kamer en opmerkingen.

De assistent beantwoordt elke vraag met de live gegevens van Sweeply, dus niemand hoeft een rapport te exporteren of naar het kantoor te lopen om het bord te checken. Het toewijzen van de kamers gebeurt nog steeds in Sweeply, want de bèta voert geen wijzigingen door.

Welke tools bevat de Sweeply MCP-server?

De bèta heeft twaalf leestools in drie groepen. Assistenten roepen eerst get_property_context aan, zodat ze je tijdzone, de datum van vandaag en je taakcategorieën kennen voordat ze antwoorden.

Groep

Tools

Wat ze lezen

De dag

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

Aankomsten, vertrekken, tussentijdse schoonmaken en schoonmaakstatus, de status, het verblijf, de taken, opmerkingen en openstaande meldingen van één kamer, de geschiedenis van een kamer over maximaal 31 dagen, de data en het aantal gasten van één verblijf, en wie er dienst heeft

Taken en meldingen

list_tasks, list_issues, get_issue

Taken over maximaal 31 dagen per type, status, toegewezen medewerker of kamer, openstaande meldingen voor de technische dienst per leeftijd of categorie, en één melding met opmerkingen en fotolinks

Planning en rapporten

get_workload_forecast, get_housekeeping_performance

Geplande aankomsten, vertrekken, tussentijdse schoonmaken en schoonmaakbeurten per dag, en voltooide schoonmaakbeurten met het gemiddelde aantal minuten per housekeeper, kamer of taak

Datums kun je schrijven als YYYY-MM-DD of gewoon als vandaag, morgen of gisteren, altijd in de tijdzone van de accommodatie. Lijsten stoppen bij 50 rijen en vermelden hoeveel rijen er in totaal zijn, zodat de assistent weet wanneer hij naar een deel van een lijst kijkt.

Hoe koppel je Claude, Cursor of n8n?

Elke client heeft dezelfde twee dingen nodig: het serveradres https://mcp.getsweeply.com en een Authorization-header met je Sweeply API-sleutel. De stappen:

  1. Vraag Sweeply om MCP in te schakelen voor je accommodatie. Tijdens de bèta staat het standaard uit; neem contact op met support of je accountmanager.

  2. Maak in de Sweeply-webapp een API-sleutel aan onder Instellingen, Account, API-sleutels en kopieer hem meteen, want hij wordt maar één keer getoond.

  3. Voeg de server toe aan je assistent met het adres en de header Authorization: Bearer gevolgd door je sleutel.

In Claude op het web, op desktop of mobiel voeg je de server toe onder Instellingen, Connectors, als aangepaste connector met de Authorization-header. Claude Code, Cursor en n8n gebruiken elk hetzelfde adres en dezelfde header in hun eigen instellingen; de Sweeply MCP-documentatie bevat voor elk de exacte configuratie. ChatGPT wordt nog niet ondersteund, omdat ChatGPT-connectors inloggen via OAuth en de Sweeply MCP-server voorlopig alleen API-sleutels accepteert.

Zijn de gegevens van het hotel veilig?

Het ontwerp houdt de assistent binnen één accommodatie en weg van persoonsgegevens van gasten:

  • Eén sleutel, één accommodatie. De API-sleutel bepaalt welke accommodatie de assistent leest, dus tools vragen nooit om een accommodatie en kunnen geen andere bereiken.

  • Alleen-lezen. In de bèta kan de assistent kijken, maar niets aanmaken, wijzigen of verwijderen.

  • Geen persoonsgegevens van gasten. Reserveringen bevatten een ID, data, kamer en aantal gasten, nooit namen, e-mailadressen of telefoonnummers.

  • Tekst van medewerkers wordt als onbetrouwbaar gemarkeerd. Opmerkingen, notities en beschrijvingen van meldingen worden gemarkeerd, zodat de assistent ze als informatie behandelt en nooit als instructies.

  • Eenvoudig in te trekken. Verwijder een sleutel en de assistent verliest bij zijn volgende verzoek de toegang. Geef elke persoon of tool een eigen sleutel, zodat je er één kunt verwijderen zonder de andere te verstoren.

Eén punt om rekening mee te houden: een API-sleutel is geen medewerker, dus personeelsrollen en afdelingsgroepen beperken niet wat hij leest. Een sleutel ziet de hele accommodatie. Hosting en gegevensverwerking volgen de gebruikelijke opzet van Sweeply, zoals beschreven op onze beveiligingspagina.

Hoe past het bij de AI-agents van Sweeply?

De AI-agents van Sweeply werken binnen Sweeply: Tracey leest opmerkingen bij reserveringen en zet ze om in taken, en Roomey wijst kamers toe. De MCP-server werkt andersom. Hij laat de algemene assistent die je managers al gebruiken Sweeply lezen, zodat ze operationele antwoorden in één gesprek kunnen combineren met hun eigen e-mail, spreadsheets of planning.

Wat komt er hierna?

De MCP-server groeit mee met de feedback van klanten. Vertel Sweeply welke vraag de assistent niet kon beantwoorden, en het team laat dezelfde dag weten wat het van plan is te bouwen; nieuwe tools verschijnen meestal binnen enkele dagen en komen automatisch in je assistent, zonder herinstallatie en zonder nieuwe sleutel. De roadmap in de documentatie noemt:

  • Veilig wijzigingen doorvoeren: taken aanmaken en toewijzen en meldingen doen, met een persoonlijke login zodat elke wijziging op naam van een medewerker wordt gedaan.

  • Meerdere accommodaties tegelijk: één koppeling voor een hotelgroep.

  • Meer assistenten: ondersteuning voor inloggen in ChatGPT en andere clients die alleen OAuth gebruiken.

Stuur ideeën naar support@getsweeply.com of via de chat in de Sweeply-app, met de vraag die je stelde en wat je als antwoord verwachtte.

Wanneer deze gids niet van toepassing is

De MCP-server leest gegevens uit Sweeply, dus hij helpt alleen hotels die hun operatie al in Sweeply draaien. Hij leest je PMS niet rechtstreeks uit buiten wat Sweeply synchroniseert, kan tijdens de bèta geen wijzigingen doorvoeren en is nog niet beschikbaar in ChatGPT. Gebruikt je team op het werk geen AI-assistent, dan geven de rapporten en het live overzicht in de Sweeply-webapp dezelfde cijfers zonder assistent.

Praat met ons salesteam

Wil je zien hoe hotels Sweeply gebruiken en wat je managers een AI-assistent over je accommodatie zouden kunnen vragen? Plan een gesprek met ons salesteam.

Conclusie

De Sweeply MCP-server maakt van je operationele gegevens antwoorden die je managers krijgen via de AI-assistent die ze al gebruiken. Hij is alleen-lezen en in bèta, koppelt met een API-sleutel, houdt persoonsgegevens van gasten buiten de deur en groeit mee met de vragen die hotels insturen.

Veelgestelde vragen

Wat kan ik de Sweeply MCP-server vragen?

Je kunt vragen stellen over je housekeepingoverzicht, kamers, taken, meldingen voor de technische dienst, medewerkers met dienst, prognoses van de werklast en housekeepingprestaties, bijvoorbeeld hoeveel kamers nog vuil zijn of aan welke vertrekken van morgen nog geen housekeeper is toegewezen.

Werkt de Sweeply MCP-server met ChatGPT?

Nog niet. ChatGPT-connectors loggen in via OAuth, en de Sweeply MCP-server accepteert voorlopig alleen API-sleutels. Ondersteuning voor inloggen in ChatGPT en andere clients die alleen OAuth gebruiken staat op de roadmap.

Kan de AI-assistent gegevens in Sweeply wijzigen?

Nee. Tijdens de bèta is de MCP-server alleen-lezen. Taken aanmaken en toewijzen en meldingen doen, met een persoonlijke login zodat elke wijziging op naam van een medewerker wordt gedaan, staat gepland.

Hoe zet ik de Sweeply MCP-server aan?

Vraag Sweeply support of je accountmanager om MCP in te schakelen voor je accommodatie, maak in de webapp een API-sleutel aan onder Instellingen, Account, API-sleutels en voeg https://mcp.getsweeply.com met die sleutel toe aan je assistent.

Ziet de assistent persoonsgegevens van gasten?

Nee. Reserveringen bevatten alleen een ID, data, kamer en aantal gasten. Namen, e-mailadressen en telefoonnummers van gasten worden nooit teruggegeven.