Entwickler · für Gastgeber

ChatGPT, Claude oder Ihren eigenen KI-Agenten verbinden (MCP)

ChatGPT, Claude, Cursor, n8n oder jeden MCP-Client mit Guestbud verbinden – per Anmeldung oder API-Schlüssel. Ihr Agent antwortet Gästen und pflegt Buchungen und Unterkünfte.

Guestbud spricht das Model Context Protocol (MCP), den offenen Standard, mit dem KI-Assistenten mit anderer Software arbeiten. Sie verbinden Ihren eigenen KI-Agenten einmal mit Ihrem Guestbud-Konto. Danach sagen Sie ihm in normaler Sprache, was er tun soll, zum Beispiel:

„Beantworte die neuen Fragen im Airbnb-Chat zum Parken.“
„Wer reist morgen an, und haben alle eingecheckt?“
„Ändere das WLAN-Passwort von Harbour Loft auf SeaBreeze2026.“
„Formuliere die E-Mail mit den Check-in-Details freundlicher und ergänze die Regel zu den Strandtüchern.“
„Welche Problemmeldungen sind noch offen, und was hat der Gast in Wohnung 3 gemeldet?“

Der Agent arbeitet mit Ihren Daten, in Ihrem Konto und nur mit den Berechtigungen, die Sie ihm geben.

Was Ihr Agent kann #

Bereich	Was er kann	Nötige Rollenberechtigung
Konto	Sehen, mit welchem Konto und welcher Rolle er verbunden ist	—
Buchungen	Buchungen auflisten und suchen, eine Buchung mit Check-in-Details, Zahlungsstatus und Türcode-Status lesen	Bookings: view
Gästechat	Die Unterhaltung aus Airbnb, Booking.com, Vrbo … lesen und dem Gast Nachrichten senden (über Hostaway oder Channex)	Bookings: view / edit
Check-in	Den Check-in-Link oder eine Erinnerung per E-Mail oder Chat senden; die Türcodes für einen vereinbarten frühen Check-in vorzeitig anzeigen	Bookings: edit
Buchungen	Eine Direktbuchung anlegen, Notizen, Gäste und Kontakt bearbeiten, stornieren	Bookings: edit
Problemmeldungen	Problemmeldungen der Gäste auflisten, auf in Bearbeitung oder erledigt setzen, interne Notizen hinzufügen	Bookings: view / edit
Reinigungsplan	Check-ins und Check-outs der nächsten Tage mit Anreise- / Abreisezeiten und Flügen	Cleaning plan
Unterkünfte	Die ganze digitale Gästemappe lesen; Abschnitte ändern (WLAN, Check-in-Schritte, Hausordnung, Tipps für die Umgebung, Extras …); eine Unterkunft ein- oder ausschalten	Properties: view / edit
Gästenachrichten	Die automatischen Gästenachrichten und Vorlagen lesen und bearbeiten; eine Nachricht befüllt mit einer echten Buchung in der Vorschau ansehen	Settings
Statistiken	Auslastung, Buchungen, Touristensteuer, Kautionen, verkaufter früher Check-in / später Check-out und Extras	Reports
Alles andere	Jeden Teil der REST-API lesen (nur lesend)	wie die API

Für einen Agenten nie verfügbar: Erstattungen, Freigabe oder Einbehalt von Kautionen, Zahlungseinstellungen, Benutzer und API-Schlüssel. Das bleibt bei Ihnen im Dashboard.

Zwei Wege zur Verbindung #

	Anmeldung (empfohlen)	API-Schlüssel
Für	ChatGPT, claude.ai, Claude Desktop und mobil, Claude Code, Cursor	n8n, Make, Agent-Frameworks, Ihren eigenen Code, Server ohne anwesende Person
Wie	Serveradresse in der KI-App einfügen, bei Guestbud anmelden, eine Rolle wählen, auf Allow klicken	Einen Schlüssel in Guestbud erstellen und in das Tool einfügen
Wer	Die Person, die sich anmeldet (braucht die Berechtigung, Apps zu verbinden, siehe unten)	Jemand, der Benutzer verwaltet
Endet	Wenn Sie die Verbindung trennen, die Person entfernt oder deaktiviert wird, eine andere Rolle erhält oder ihr Passwort ändert, oder nach 60 Tagen ohne jede Nutzung	Wenn Sie den Schlüssel widerrufen

Ihre Serveradresse steht unter Settings → AI agent (MCP):

https://guestbud.io/mcp oder
Ihre eigene Domain gefolgt von /mcp, zum Beispiel https://stay.example.com/mcp.

1. Festlegen, was der Agent darf #

Der Agent arbeitet immer mit einer Rolle – genau wie eine Person in Ihrem Team (siehe Benutzer, Rollen und Anmeldung):

Staff – empfohlen zum Beantworten von Gästen: liest Buchungen, sendet Gästenachrichten und Check-in-Links, bearbeitet Problemmeldungen, sieht den Reinigungsplan. Kann keine Unterkünfte oder Einstellungen ändern.
Manager – bearbeitet zusätzlich Unterkünfte, Vorlagen für Gästenachrichten und Einstellungen und liest Statistiken.
Viewer – liest nur; kann nichts senden.
Cleaning – nur der Reinigungsplan.

Beginnen Sie mit Staff. Bei der Anmeldung wählen Sie die Rolle auf der Guestbud-Seite, die sich öffnet; sie kann nie höher sein als Ihre eigene Rolle und nie Owner.

Wo Sie die Serveradresse (https://guestbud.io/mcp) in Ihrer KI-App eintragen:

claude.ai, Claude Desktop und mobil: Settings → Connectors → Add custom connector, Adresse einfügen, Add, dann Connect.
ChatGPT: Settings → Apps & Connectors, einen Connector erstellen (Entwicklermodus), Adresse einfügen, Authentifizierung OAuth.
Claude Code: claude mcp add --transport http guestbud https://guestbud.io/mcp ausführen, dann in Claude Code /mcp eingeben und Authenticate wählen.
Cursor: Settings → MCP → Add server mit { "mcpServers": { "guestbud": { "url": "https://guestbud.io/mcp" } } }, dann Connect.

Danach:

Fügen Sie Guestbud in Ihrer KI-App wie oben gezeigt mit Ihrer Serveradresse hinzu und starten Sie die Verbindung.
Eine Guestbud-Seite öffnet sich. Melden Sie sich mit Ihrem normalen Guestbud-Login an (auf guestbud.io geben Sie zusätzlich das Kürzel Ihres Unternehmens ein).
Prüfen Sie den Namen der App und wohin sie zurückkehrt (zum Beispiel claude.ai), wählen Sie die Rolle für die App und klicken Sie auf Allow.
Zurück in der KI-App stehen die Tools von Guestbud zur Verfügung. Fragen Sie zum Beispiel: „Welche Gäste reisen diese Woche an?“

Bleibt verbunden: Die App erneuert ihren Zugang automatisch im Hintergrund (stündlich). Sie müssen sich nicht erneut verbinden, solange der Agent mindestens einmal in 60 Tagen genutzt wird.

Wer verbinden darf: Unter Settings → AI agent (MCP) → Who may connect AI apps with sign-in wählen Sie Team members who manage users (Standard), All team members (jeweils bis zur eigenen Rolle) oder Nobody. Mit Nobody enden alle Anmelde-Verbindungen auf einmal.

Verbundene Apps: Dieselbe Seite listet jede verbundene App mit der Person, die sich angemeldet hat, ihrer Rolle und der letzten Nutzung. Disconnect beendet sie sofort.

3. Mit einem API-Schlüssel verbinden (Automatisierungstools und eigener Code) #

Verwenden Sie einen Schlüssel für Tools, die ohne Anmeldung einer Person laufen: n8n, Make, Agent-Frameworks, Skripte und Server.

Öffnen Sie Settings → AI agent (MCP) und klappen Sie For automation tools and your own code (API key) auf (Sie brauchen die Berechtigung, Benutzer zu verwalten).
Geben Sie einen Name ein, zum Beispiel n8n – Gästeantworten, und wählen Sie die Role.
Klicken Sie auf Create key and show the setup.
Der vollständige Schlüssel (gpk_…) wird einmal angezeigt, zusammen mit fertigen Einrichtungszeilen, die ihn bereits enthalten. Kopieren Sie diese jetzt. Wenn Sie den Schlüssel verlieren, widerrufen Sie ihn und erstellen einen neuen.

Ein Schlüssel funktioniert nur für Ihr eigenes Konto. Auf der Domain eines anderen Unternehmens wird er abgelehnt.

n8n und andere Automatisierungstools #

Fügen Sie in n8n einen AI Agent mit dem MCP Client Tool hinzu:

Endpoint: https://guestbud.io/mcp
Server transport: HTTP Streamable
Authentication: Bearer Auth, Token = Ihr gpk_…-Schlüssel

Jeder andere MCP-Client, der einen Header senden kann, funktioniert genauso:

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

Claude Code, Claude Desktop, Cursor, Windsurf mit einem Schlüssel #

Nutzen Sie für diese Apps besser die Anmeldung. Wenn Sie trotzdem einen Schlüssel möchten (zum Beispiel auf einem Server):

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

Apps, die MCP-Server aus einer Konfigurationsdatei starten, verwenden die kostenlose Brücke mcp-remote (benötigt Node.js):

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

Der Schlüssel steht absichtlich im Teil env: So vermeiden Sie Probleme mit Leerzeichen unter Windows.

4. Nutzen #

Fragen Sie in normaler Sprache, so wie Sie eine Kollegin oder einen Kollegen fragen würden. Einige Beispiele, die gut funktionieren:

Gästechat: „Sieh dir die Buchungen an, die in den nächsten drei Tagen anreisen. Lies ihre Unterhaltungen auf Airbnb und Booking.com und entwirf Antworten auf unbeantwortete Fragen. Zeig sie mir vor dem Senden.“
Check-in nachfassen: „Wer reist morgen an und hat den Online-Check-in noch nicht gemacht? Schick ihnen eine Erinnerung über den Buchungschat.“
Früher Check-in: „Der Gast der Buchung GP-7KQ2XD darf um 12:00 einchecken – schalte die Codes vorzeitig frei und sag es ihm im Chat.“
Unterkünfte: „Zeig mir die Check-in-Schritte von Capua Flats und korrigiere den Aufzugscode auf 3044.“
Problemmeldungen: „Liste die offenen Problemmeldungen auf; setze die WLAN-Meldung bei Harbour Loft auf erledigt mit der Notiz ‚Router neu gestartet‘.“
Reinigung: „Was hat das Reinigungsteam am Samstag zu tun, sortiert nach Abreisezeit? Markiere Wechsel am selben Tag.“
Nachrichten: „Schreib die E-Mail mit den Check-in-Details in einem wärmeren Ton um, behalte alle Platzhalter bei und zeig mir eine Vorschau mit der nächsten Buchung.“
Zahlen: „Wie viele späte Check-outs haben wir letzten Monat verkauft, und welche Extras liefen am besten?“

Tipp: Lassen Sie den Agenten Gästenachrichten zuerst entwerfen und Ihnen zeigen („zeig sie mir vor dem Senden“). Wenn Sie ihm vertrauen, können Sie ihn direkt senden lassen.

Sicherheit #

Ihre Wahl der Berechtigungen: Die Rolle des Schlüssels oder der Anmeldung entscheidet über alles. Der Agent sieht nur die Tools, die seine Rolle erlaubt, und der Server prüft jeden Aufruf erneut.
Kein Geld wird bewegt: Erstattungen, Kautionen, Zahlungseinstellungen, Benutzer und Schlüssel sind über MCP nicht erreichbar.
Nicht vertrauenswürdiger Gästetext: Gäste können alles in einen Chat oder ein Check-in-Formular schreiben. Guestbud weist den Agenten an, alles, was ein Gast geschrieben hat, als Information zu behandeln, nie als Anweisung. Außerdem weist es den Agenten an, keine Türcodes zu senden, bevor die Buchung sie als sichtbar ausweist. Prüfen Sie trotzdem, was der Agent sendet, vor allem am Anfang.
Jede Änderung wird protokolliert: Jede Aktion, die etwas ändert (eine gesendete Nachricht, eine geänderte Buchung oder Unterkunft, ein freigeschalteter Code …), steht unter Settings → Audit trail unter dem Namen der App oder des Schlüssels. Reine Abfragen werden nicht aufgeführt, damit das Protokoll übersichtlich bleibt.
Weniger personenbezogene Daten: Der Agent erhält, was er braucht, um Gästen zu helfen – nicht mehr. Buchungsdetails enthalten keine Ausweisdaten und Uploads, keine IP-Adressen und nicht den Smart-Lock-Code der Buchung. Der lesende API-Zugriff schließt Dateien, Benutzer, API-Schlüssel, das Audit-Protokoll, Webhooks, Daten der Gästeregistrierung sowie Zahlungs-, E-Mail- und Schlosseinstellungen aus.
Limits: höchstens 120 Tool-Aufrufe pro Minute und 40 Gästenachrichten pro Stunde und Verbindung oder Schlüssel; höchstens 10 Anfragen in einem Batch, und sehr lange Antworten werden gekürzt.
Sichere Anmeldung: Guestbud nutzt den Standard für die Anmeldung von KI-Apps (OAuth 2.1 mit PKCE). Die App sieht nie Ihr Passwort; sie erhält ein Zugriffstoken, das eine Stunde gilt, und ein Erneuerungstoken, das sich bei jeder Nutzung ändert. Wird ein Erneuerungstoken jemals zweimal verwendet, schließt Guestbud die Verbindung. Ein Anmelde-Token gilt nur für die Verbindung des KI-Agenten, nicht für den Rest der API.
Jederzeit widerrufen: Settings → AI agent (MCP) → Disconnect (Anmeldung) oder Revoke (Schlüssel). Der Agent verliert sofort den Zugriff.
Ihr KI-Anbieter: Die Daten, die der Agent liest, verarbeitet der KI-Dienst, den Sie verbinden (zum Beispiel Anthropic für Claude). Prüfen Sie, ob das zu Ihren Datenschutzhinweisen für Gäste passt.

Häufige Fragen #

Welche KI-Agenten funktionieren mit Guestbud? #

Jeder MCP-Client. ChatGPT, claude.ai, Claude Desktop und mobil, Claude Code und Cursor verbinden sich per Anmeldung. n8n, Agent-Frameworks und Ihr eigener Code verbinden sich mit einem API-Schlüssel.

Wie lange hält eine Anmelde-Verbindung? #

So lange Sie sie nutzen. Die App erneuert ihren Zugang automatisch jede Stunde; die Verbindung endet nur nach 60 Tagen ohne jede Nutzung, wenn Sie sie trennen oder wenn die angemeldete Person entfernt oder deaktiviert wird, eine andere Rolle erhält oder ihr Passwort ändert.

Kann der Agent Gästen Türcodes senden? #

Nur wenn seine Rolle Buchungen und Unterkünfte lesen darf, und nur wenn die Buchung des Gastes die Codes als sichtbar ausweist: Check-in und Zahlungen erledigt und die Check-in-Zeit erreicht (oder von Ihnen vorzeitig freigeschaltet). Der Agent kennt diese Regel. Ihre Vorlagen für Gästenachrichten mit {doorCodes} folgen derselben Regel automatisch.

Können mehrere Agenten Guestbud gleichzeitig nutzen? #

Ja. Jede Anmeldung und jeder Schlüssel ist eine eigene Verbindung mit eigener Rolle, wird im Audit-Protokoll getrennt aufgeführt, und Sie können eine trennen, ohne die anderen zu beeinträchtigen.

Kostet der Agent in Guestbud etwas? #

Nein. Der MCP-Zugang gehört zu Ihrem Konto. Den Agenten selbst stellt Ihnen Ihr KI-Anbieter in Rechnung.

Gibt es auch eine API für Entwickler? #

Ja – der Agent nutzt dieselben Berechtigungen wie die REST-API und die Webhooks; siehe den API-Schnellstart.