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

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](/api/docs) 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](/docs/users-roles-and-sign-in)):

- **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.

## 2. Mit Anmeldung verbinden (ChatGPT, Claude, Cursor) {#connect-with-sign-in}

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:

1. Fügen Sie Guestbud in Ihrer KI-App wie oben gezeigt mit Ihrer Serveradresse hinzu und starten Sie die Verbindung.
2. 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).
3. 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**.
4. 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) {#connect-with-an-api-key}

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

1. Ö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).
2. Geben Sie einen **Name** ein, zum Beispiel *n8n – Gästeantworten*, und wählen Sie die **Role**.
3. Klicken Sie auf **Create key and show the setup**.
4. 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](https://nodejs.org)):

```
{
  "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](/api/docs) und die [Webhooks](/docs/webhooks); siehe den [API-Schnellstart](/docs/api-quickstart).