Ontwikkelaars · voor Hosts

ChatGPT, Claude of je eigen AI-agent koppelen (MCP)

Koppel ChatGPT, Claude, Cursor, n8n of elke MCP-client aan Guestbud, met inloggen of een API-sleutel: je agent beantwoordt gasten en beheert boekingen en advertenties.

Guestbud spreekt het Model Context Protocol (MCP), de open standaard waarmee AI-assistenten met andere software werken. Je koppelt je eigen AI-agent één keer aan je Guestbud-account. Daarna vertel je hem in gewone taal wat hij moet doen, bijvoorbeeld:

• “Beantwoord de nieuwe vragen over parkeren in de Airbnb-chat.”
• “Wie komt er morgen aan, en heeft iedereen ingecheckt?”
• “Verander het wifiwachtwoord van Harbour Loft in SeaBreeze2026.”
• “Maak de e-mail met incheckgegevens vriendelijker en voeg de regel over strandhanddoeken toe.”
• “Welke meldingen staan nog open, en wat heeft de gast in appartement 3 gemeld?”

De agent werkt met jouw gegevens, in jouw account en alleen met de rechten die jij hem geeft.

Wat je agent kan #

Nooit beschikbaar voor een agent: terugbetalingen, borg vrijgeven of innen, betaalinstellingen, gebruikers en API-sleutels. Die blijven bij jou in het dashboard.

Twee manieren om te koppelen #

Je serveradres staat onder Settings → AI agent (MCP):

• https://guestbud.io/mcp, of
• je eigen domein gevolgd door /mcp, bijvoorbeeld https://stay.example.com/mcp.

1. Kies wat de agent mag #

De agent werkt altijd met een rol – precies zoals iemand in je team (zie Gebruikers, rollen en inloggen):

• Staff – aanbevolen om gasten te antwoorden: leest boekingen, stuurt gastberichten en incheck-links, handelt storingsmeldingen af, ziet de schoonmaakplanning. Kan geen advertenties of instellingen wijzigen.
• Manager – bewerkt daarnaast advertenties, sjablonen voor gastberichten en instellingen, en leest statistieken.
• Viewer – alleen lezen; kan niets versturen.
• Cleaning – alleen de schoonmaakplanning.

Begin met Staff. Bij inloggen kies je de rol op de Guestbud-pagina die opent; die kan nooit hoger zijn dan je eigen rol, en nooit Owner.

2. Koppelen met inloggen (ChatGPT, Claude, Cursor) #

Waar je het serveradres (https://guestbud.io/mcp) in je AI-app toevoegt:

• claude.ai, Claude Desktop en mobiel: Settings → Connectors → Add custom connector, plak het adres, Add, daarna Connect.
• ChatGPT: Settings → Apps & Connectors, maak een connector (ontwikkelaarsmodus), plak het adres, authenticatie OAuth.
• Claude Code: voer claude mcp add --transport http guestbud https://guestbud.io/mcp uit, typ daarna /mcp in Claude Code en kies Authenticate.
• Cursor: Settings → MCP → Add server met { "mcpServers": { "guestbud": { "url": "https://guestbud.io/mcp" } } }, daarna Connect.

Daarna:

1. Voeg in je AI-app Guestbud toe met je serveradres zoals hierboven en start de koppeling.
2. Er opent een Guestbud-pagina. Log in met je gewone Guestbud-login (op guestbud.io vul je ook de korte naam van je bedrijf in).
3. Controleer de naam van de app en waar die naar terugkeert (bijvoorbeeld claude.ai), kies de rol voor de app en klik op Allow.
4. Terug in de AI-app zijn de tools van Guestbud beschikbaar. Vraag bijvoorbeeld: “Welke gasten komen deze week aan?”.

Blijft gekoppeld: de app vernieuwt zijn toegang automatisch op de achtergrond (elk uur). Je hoeft niet opnieuw te koppelen zolang de agent minstens één keer per 60 dagen wordt gebruikt.

Wie mag koppelen: onder Settings → AI agent (MCP) → Who may connect AI apps with sign-in kies je Team members who manage users (standaard), All team members (elk tot de eigen rol) of Nobody. Met Nobody stoppen alle inlogkoppelingen in één keer.

Gekoppelde apps: dezelfde pagina toont elke gekoppelde app met de persoon die inlogde, de rol en het laatste gebruik. Disconnect stopt de app meteen.

3. Koppelen met een API-sleutel (automatiseringstools en je eigen code) #

Gebruik een sleutel voor tools die draaien zonder dat iemand inlogt: n8n, Make, agentframeworks, scripts en servers.

1. Open Settings → AI agent (MCP) en klap For automation tools and your own code (API key) open (je hebt het recht nodig om gebruikers te beheren).
2. Vul een Name in, bijvoorbeeld n8n – gastantwoorden, en kies de Role.
3. Klik op Create key and show the setup.
4. De volledige sleutel (gpk_…) wordt één keer getoond, samen met kant-en-klare instelregels waarin hij al staat. Kopieer ze nu. Raak je de sleutel kwijt, trek hem dan in en maak een nieuwe.

Een sleutel werkt alleen voor je eigen account. Op het domein van een ander bedrijf wordt hij geweigerd.

n8n en andere automatiseringstools #

Voeg in n8n een AI Agent toe met de MCP Client Tool:

• Endpoint: https://guestbud.io/mcp
• Server transport: HTTP Streamable
• Authentication: Bearer Auth, token = je gpk_…-sleutel

Elke andere MCP-client die een header kan meesturen, werkt op dezelfde manier:

• URL: https://guestbud.io/mcp
• Transport: Streamable HTTP
• Header: Authorization: Bearer gpk_…

Claude Code, Claude Desktop, Cursor, Windsurf met een sleutel #

Gebruik bij deze apps liever inloggen. Wil je toch een sleutel (bijvoorbeeld op een server):

claude mcp add --transport http guestbud https://guestbud.io/mcp --header "Authorization: Bearer gpk_…"

Apps die MCP-servers vanuit een configuratiebestand starten, gebruiken de gratis mcp-remote-bridge (vereist Node.js):

{
  "mcpServers": {
    "guestbud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://guestbud.io/mcp", "--header", "Authorization:${GUESTBUD_AUTH}"],
      "env": { "GUESTBUD_AUTH": "Bearer gpk_…" }
    }
  }
}

De sleutel staat met opzet in het deel env: zo voorkom je problemen met spaties op Windows.

4. Gebruik het #

Vraag het in gewone taal, zoals je het een collega zou vragen. Een paar voorbeelden die goed werken:

• Gastenchat: “Bekijk de boekingen die de komende drie dagen aankomen. Lees hun gesprekken op Airbnb en Booking.com en schrijf concepten voor onbeantwoorde vragen. Laat ze me zien voordat je ze verstuurt.”
• Inchecken opvolgen: “Wie komt morgen aan en heeft nog niet online ingecheckt? Stuur ze een herinnering via de boekingschat.”
• Vroeg inchecken: “De gast van boeking GP-7KQ2XD mag om 12:00 inchecken – geef de codes eerder vrij en laat het weten in de chat.”
• Advertenties: “Laat me de incheckstappen van Capua Flats zien en verander de liftcode in 3044.”
• Meldingen: “Geef de openstaande meldingen weer; zet die over de wifi bij Harbour Loft op opgelost met de notitie ‘router herstart’.”
• Schoonmaak: “Wat moet het schoonmaakteam zaterdag doen, gesorteerd op vertrektijd? Markeer wissels op dezelfde dag.”
• Berichten: “Herschrijf de e-mail met incheckgegevens in een warmere toon, behoud alle placeholders en laat me een voorbeeld zien met de volgende boeking.”
• Cijfers: “Hoeveel keer laat uitchecken hebben we vorige maand verkocht, en welke extra's verkochten het best?”

Tip: laat de agent gastberichten eerst als concept schrijven en aan je tonen (“laat ze me zien voordat je ze verstuurt”). Als je hem vertrouwt, kun je hem direct laten versturen.

Beveiliging #

• Jij kiest de rechten: de rol van de sleutel of de inlogkoppeling bepaalt alles. De agent ziet alleen de tools die zijn rol toestaat, en de server controleert elke aanroep opnieuw.
• Er beweegt geen geld: terugbetalingen, borgen, betaalinstellingen, gebruikers en sleutels zijn niet bereikbaar via MCP.
• Onbetrouwbare tekst van gasten: gasten kunnen van alles in een chat of incheckformulier schrijven. Guestbud zegt de agent alles wat een gast schreef als informatie te behandelen, nooit als instructie. Ook zegt het de agent geen deurcodes te sturen voordat de boeking ze als zichtbaar toont. Controleer toch wat de agent verstuurt, vooral in het begin.
• Elke wijziging wordt vastgelegd: elke actie die iets verandert (een verstuurd bericht, een gewijzigde boeking of advertentie, een vrijgegeven code …) staat in Settings → Audit trail onder de naam van de app of de sleutel. Gewone opvragingen worden niet vermeld, zodat de trail overzichtelijk blijft.
• Minder persoonsgegevens: de agent krijgt wat hij nodig heeft om gasten te helpen, niet meer. Boekingsgegevens bevatten geen identiteitsdocumentgegevens en uploads, geen IP-adressen en niet de slimme-slotcode van de boeking. De alleen-lezen API-toegang sluit bestanden, gebruikers, API-sleutels, de audittrail, webhooks, gastregistratiegegevens en betaal-, e-mail- en slotinstellingen uit.
• Limieten: maximaal 120 toolaanroepen per minuut en 40 gastberichten per uur per koppeling of sleutel; maximaal 10 verzoeken in één batch, en zeer lange antwoorden worden ingekort.
• Veilig inloggen: Guestbud gebruikt de standaard voor het inloggen van AI-apps (OAuth 2.1 met PKCE). De app ziet nooit je wachtwoord; hij krijgt een toegangstoken dat een uur geldig is en een vernieuwingstoken dat bij elk gebruik verandert. Wordt een vernieuwingstoken ooit twee keer gebruikt, dan sluit Guestbud de koppeling. Een inlogtoken werkt alleen voor de koppeling van de AI-agent, niet voor de rest van de API.
• Altijd in te trekken: Settings → AI agent (MCP) → Disconnect (inloggen) of Revoke (sleutel). De agent verliest meteen de toegang.
• Je AI-aanbieder: de gegevens die de agent leest, worden verwerkt door de AI-dienst die je koppelt (bijvoorbeeld Anthropic voor Claude). Controleer of dat past bij je privacyverklaring voor gasten.

Veelgestelde vragen #

Welke AI-agents werken met Guestbud? #

Elke MCP-client. ChatGPT, claude.ai, Claude Desktop en mobiel, Claude Code en Cursor koppelen met inloggen. n8n, agentframeworks en je eigen code koppelen met een API-sleutel.

Hoe lang blijft een inlogkoppeling actief? #

Zolang je haar gebruikt. De app vernieuwt zijn toegang automatisch elk uur; de koppeling eindigt alleen na 60 dagen zonder enig gebruik, als je haar verbreekt, of als de persoon die inlogde wordt verwijderd of uitgeschakeld, een andere rol krijgt of het wachtwoord wijzigt.

Kan de agent deurcodes naar gasten sturen? #

Alleen als zijn rol boekingen en advertenties mag lezen, en alleen als de boeking van de gast de codes als zichtbaar toont: inchecken en betalingen afgerond en de inchecktijd bereikt (of door jou eerder vrijgegeven). De agent kent deze regel. Je sjablonen voor gastberichten met {doorCodes} volgen automatisch dezelfde regel.

Kunnen meerdere agents tegelijk Guestbud gebruiken? #

Ja. Elke inlogkoppeling en elke sleutel is een aparte koppeling met een eigen rol, die apart in de audittrail staat, en je kunt er één verbreken zonder de andere te raken.

Kost de agent iets in Guestbud? #

Nee. MCP-toegang hoort bij je account. De agent zelf wordt door je AI-aanbieder gefactureerd.

Is er ook een API voor ontwikkelaars? #

Ja – de agent gebruikt dezelfde rechten als de REST API en de webhooks; zie de snelstart voor de API.