Smoobu mit Claude verbinden: So fragst du deine Buchungen per MCP ab
Wie steht der Sommer im Vergleich zum Vorjahr? Welche Anzahlungen fehlen noch? Mit einem kleinen MCP-Server fragst du deine Smoobu-Daten direkt in Claude ab – nur lesend und ohne Excel-Export.
von Dirk Klemer
Wer eine Ferienwohnung oder ein Ferienhaus selbst vermietet, kennt das: Die Daten liegen alle in Smoobu, aber die Frage, die einen gerade wirklich interessiert, beantwortet kein Standardbericht. Wie steht der Sommer im Vergleich zum Vorjahr? Wie viele Nächte kamen über Booking.com, wie viele direkt? Welche Wochen in den Herbstferien sind noch frei?
Ich vermiete ein Ferienhaus für bis zu acht Personen auf der Insel Poel und verwalte es mit Smoobu als Channel-Manager und Lexware für die Buchhaltung. Inzwischen stelle ich solche Fragen nicht mehr an eine Excel-Tabelle, sondern direkt an den KI-Assistenten Claude. Möglich macht das ein kleiner, selbst gebauter Smoobu-MCP-Server, der als Cloudflare Worker läuft und in Claude als eigener Connector eingebunden ist.
In diesem Artikel zeige ich, wie das funktioniert: was MCP ist, welche Bausteine du brauchst, wie du Schritt für Schritt vorgehst und worauf du bei Sicherheit und Datenschutz achten musst. Der Server, den ich beschreibe, ist bewusst nur lesend. Claude kann also auswerten, aber keine Buchungen oder Preise verändern.
Was ist MCP?
MCP steht für Model Context Protocol. Es ist ein offener Standard, über den ein KI-Assistent wie Claude mit externen Programmen und Datenquellen spricht. Man kann es sich wie einen USB-Anschluss für KI vorstellen: Ein Dienst stellt einmal einen MCP-Server bereit, und jeder MCP-fähige Assistent kann ihn nutzen.
Ein MCP-Server bietet sogenannte Tools an. Jedes Tool hat einen Namen, eine Beschreibung und feste Eingabeparameter, zum Beispiel „Hole alle Buchungen mit Aufenthalt zwischen Datum A und Datum B“. Claude liest diese Beschreibungen, entscheidet selbst, welches Tool zu deiner Frage passt, ruft es auf und rechnet mit dem Ergebnis weiter.
Smoobu hat eine gut dokumentierte REST-API. Ein eigener MCP-Server ist deshalb im Kern nur eine dünne Übersetzungsschicht zwischen Claude und dieser API. Zwei Bauarten sind möglich:
- Lokaler MCP-Server: läuft auf deinem Rechner, zum Beispiel in Claude Desktop. Funktioniert nur, solange dieser Rechner an ist.
- Remote-MCP-Server: läuft im Internet unter einer HTTPS-Adresse. Er funktioniert in Claude im Browser, in der Desktop-App und auf dem Handy. Diese Variante beschreibe ich hier.
Übrigens: Wie Gäste per MCP die Verfügbarkeit unseres Hauses abfragen können, steht im Artikel „Unser Ferienhaus spricht jetzt mit KI-Assistenten“. Hier geht es um die andere Seite: um dich als Vermieter und deine eigenen Auswertungen.
So ist die Lösung aufgebaut
Das Setup besteht aus drei Teilen: Claude als Oberfläche, einem Cloudflare Worker als Remote-MCP-Server und der Smoobu-API als Datenquelle. Der Worker ist der einzige Ort, an dem die Smoobu-Zugangsdaten liegen. Claude selbst sieht sie nie.
- Claude (Browser, Desktop-App oder Handy) versteht die Frage, wählt das passende Tool und rechnet mit dem Ergebnis.
- Cloudflare Worker prüft die Anmeldung, hält API-Key und Secret als verschlüsselte Secrets und stellt die Tools bereit. Er spricht mit Claude über MCP per HTTPS.
- Smoobu-API liefert Objekte, Buchungen, Preise und Verfügbarkeit. Der Worker ruft sie nur lesend und mit signierten Anfragen auf.
Cloudflare Workers eignen sich gut dafür: Der kostenlose Tarif reicht für einen privaten Vermieter in aller Regel aus, es gibt keinen eigenen Server zu pflegen, und Cloudflare stellt mit dem Agents SDK fertige Bausteine für MCP und die Anmeldung bereit.
Mein Server bietet fünf Tools an, alle nur lesend:
smoobu_list_apartments
alle Objekte mit ID und Namesmoobu_get_reservations
Buchungen als flache Tabelle mit Objekt, Kanal, Anreise, Abreise, Nächten, Gast, Personen, Preis, Anzahlung und Kaution, über alle Seitensmoobu_get_reservation
eine einzelne Buchung mit allen Detailssmoobu_get_rates
Tagespreis, Mindestaufenthalt und Verfügbarkeit pro Tagsmoobu_api_get
allgemeiner lesender Aufruf für alles andere unter/api/
Zwei Designentscheidungen haben sich bewährt. Erstens liefert das Buchungs-Tool bewusst keine E-Mail-Adressen und Telefonnummern, damit bei Auswertungen keine Kontaktdaten im Chat landen. Zweitens blättert der Worker selbst durch alle Seiten der API (höchstens 100 Buchungen pro Seite), sodass Claude immer den vollständigen Zeitraum bekommt.
Schritt für Schritt: Smoobu per MCP an Claude anschließen
Du brauchst einen Smoobu-Account, ein kostenloses Cloudflare-Konto, Node.js auf deinem Rechner und einen Claude-Account. Grundkenntnisse in JavaScript oder TypeScript helfen, der Code ist aber überschaubar. Und beim Schreiben kann dir Claude selbst helfen.
Schritt 1: API-Schlüssel und Secret in Smoobu erstellen
Smoobu hat die Anmeldung an der API umgestellt. Der alte einzelne Api-Key-Header ist laut Smoobu-API-Dokumentation seit dem 31. Oktober 2026 abgeschaltet. Neue Integrationen signieren jede Anfrage per HMAC mit einem Schlüsselpaar aus API-Key und API-Secret.
- In Smoobu unter Einstellungen → Erweitert → API-Schlüssel (englisch: Settings → Advanced → API Keys) einen neuen API-Schlüssel erstellen und einen Namen vergeben, etwa „Claude MCP“.
- Das Secret generieren lassen.
- API-Key und Secret sofort sicher ablegen, zum Beispiel im Passwortmanager. Das Secret wird nur ein einziges Mal angezeigt.
Schritt 2: Worker-Projekt anlegen
Cloudflare stellt eine Vorlage für einen Remote-MCP-Server bereit. Im Terminal:
npm create cloudflare@latest -- mein-smoobu-mcp --template=cloudflare/ai/demos/remote-mcp-authless
cd mein-smoobu-mcp
Die Vorlage startet ohne Anmeldung. Das ist zum Ausprobieren in Ordnung, für echte Buchungsdaten aber nicht. In Schritt 5 kommt deshalb eine Anmeldung dazu.
Schritt 3: Die Smoobu-API signiert aufrufen
Kern des Servers ist eine Funktion, die eine GET-Anfrage an Smoobu signiert. Smoobu erwartet vier Header: X-API-Key, X-Timestamp (UTC im ISO-8601-Format, höchstens fünf Minuten Abweichung), X-Nonce (eine neue UUID pro Anfrage) und X-Signature. Die Signatur ist ein HMAC-SHA256 über Methode, Pfad, sortierte und RFC-3986-kodierte Query, Zeitstempel, Nonce, den SHA-256-Hash des Bodys und den API-Key, jeweils durch Zeilenumbrüche getrennt, mit dem Secret als Schlüssel und Base64-kodiert.
const BASE_URL = "https://login.smoobu.com";
const rfc3986 = (s) => encodeURIComponent(s).replace(/[!'()*]/g, (c) => "%" + c.charCodeAt(0).toString(16).toUpperCase());
async function smoobuGet(env, path, query = {}) {
const entries = Object.entries(query).sort(([a], [b]) => a.localeCompare(b));
const canonicalQuery = entries.map(([k, v]) => `${rfc3986(k)}=${rfc3986(String(v))}`).join("&");
const timestamp = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
const nonce = crypto.randomUUID();
const bodyHash = await sha256Hex(""); // GET hat keinen Body
const canonical = ["GET", path, canonicalQuery, timestamp, nonce, bodyHash, env.SMOOBU_API_KEY].join("\n");
const signature = await hmacBase64(env.SMOOBU_API_SECRET, canonical);
const url = canonicalQuery ? `${BASE_URL}${path}?${canonicalQuery}` : `${BASE_URL}${path}`;
const res = await fetch(url, {
headers: {
"X-API-Key": env.SMOOBU_API_KEY,
"X-Timestamp": timestamp,
"X-Nonce": nonce,
"X-Signature": signature,
Accept: "application/json",
},
});
if (!res.ok) throw new Error(`Smoobu HTTP ${res.status}: ${await res.text()}`);
return res.json();
}
Die Hilfsfunktionen sha256Hex und hmacBase64 sind wenige Zeilen mit der Web Crypto API (crypto.subtle), die in Workers eingebaut ist.
Zwei Tipps aus der Praxis: Kodiere die Query in der Signatur und in der URL auf genau dieselbe Weise. Sonst lehnt Smoobu Anfragen mit Sonderzeichen wie apartments[] mit „401 Unauthorized“ ab, während einfache Abfragen funktionieren. Und erlaube in dieser Funktion nur Pfade, die mit /api/ beginnen, und ausschließlich GET. Dann kann der Server gar nicht schreiben, egal was ein Tool-Aufruf verlangt.
Schritt 4: Tools definieren
Jedes Tool bekommt einen Namen, eine verständliche Beschreibung und ein Eingabeschema. Die Beschreibung ist wichtig, denn danach entscheidet Claude, welches Tool es benutzt.
server.registerTool(
"smoobu_get_reservations",
{
title: "Buchungen abrufen (Tabelle)",
description: "Holt Buchungen aus Smoobu über alle Seiten. 'from'/'to' filtern nach Aufenthaltszeitraum.",
inputSchema: { from: z.string().optional(), to: z.string().optional() },
annotations: { readOnlyHint: true },
},
async (args) => {
const rows = await fetchAllReservations(env, args); // blättert mit pageSize 100 durch alle Seiten
return { content: [{ type: "text", text: JSON.stringify(rows) }] };
},
);
Die Annotation readOnlyHint sagt Claude zusätzlich, dass das Tool nichts verändert.
Schritt 5: Zugang absichern
Ein Remote-MCP-Server ist unter einer öffentlichen Adresse erreichbar. Ohne Schutz könnte jeder, der die URL kennt, deine Buchungen abfragen. Ich nutze dafür die Bibliothek @cloudflare/workers-oauth-provider. Sie macht den Worker zu einem kleinen OAuth-Server, den Claude automatisch erkennt:
- Beim Verbinden öffnet Claude eine Anmeldeseite des Workers, auf der du ein Passwort eingibst.
- Danach bekommt Claude ein kurzlebiges Zugriffstoken, das automatisch erneuert wird.
- Nach mehreren falschen Passwörtern sperrt der Worker die Anmeldung für eine Weile.
- Tokens und Fehlversuche liegen in einem Workers-KV-Speicher.
Den KV-Speicher legst du so an und trägst die ausgegebene ID in die wrangler.jsonc ein:
npx wrangler kv namespace create OAUTH_KV
Schritt 6: Secrets hinterlegen und veröffentlichen
Zugangsdaten gehören nie in den Code und nie unter vars in die wrangler.jsonc, sondern als verschlüsselte Secrets in den Worker:
npx wrangler secret put SMOOBU_API_KEY
npx wrangler secret put SMOOBU_API_SECRET
npx wrangler secret put MCP_PASSWORD
npx wrangler deploy
Wer seinen Worker lieber im Cloudflare-Dashboard pflegt, findet die Secrets dort unter Workers & Pages → dein Worker → Einstellungen → Variablen und Secrets. Wichtig ist der Typ „Secret“, nicht „Text“.
Danach läuft der Server unter einer Adresse wie https://mein-smoobu-mcp.<dein-subdomain>.workers.dev/mcp. Testen kannst du ihn vorab mit dem MCP Inspector: npx @modelcontextprotocol/inspector starten, URL eintragen, verbinden, „List Tools“.
Schritt 7: Als Custom Connector in Claude hinzufügen
- In Claude die Connector-Einstellungen öffnen (Anpassen → Connectors).
- „Add“ und dann „Add custom connector“ wählen.
- Einen Namen eintragen, etwa „Smoobu“, und die URL des Workers mit
/mcpam Ende. Mit „Continue“ weiter. - Bei der Authentifizierung die Optionen übernehmen, die Claude als „Detected“ markiert. Claude erkennt den OAuth-Server des Workers selbst.
- „Add“ und dann „Connect“ klicken. Es öffnet sich die Anmeldeseite des Workers, dort das Passwort eingeben.
Custom Connectors gibt es laut Claude-Hilfe in allen Tarifen, im kostenlosen Tarif allerdings nur einen. In Team- und Enterprise-Tarifen fügt ein Owner den Connector für die Organisation hinzu. Im Chat schaltest du den Connector über das „+“-Menü ein oder aus.
Abkürzung: Claude richtet den Worker selbst ein
Du musst die Schritte 2 bis 6 nicht alle selbst im Terminal tippen. Cloudflare bietet einen eigenen MCP-Connector an, mit dem Claude direkt mit deinem Cloudflare-Konto spricht. Verbindest du ihn in Claude, kann Claude für dich:
- den Worker anlegen und den Code hochladen,
- den KV-Speicher erstellen und Secrets setzen, zum Beispiel einen versehentlich als normale Variable hinterlegten API-Key in ein Secret umwandeln,
- die Einstellungen und die Versionen des Workers prüfen und bei Bedarf auf eine frühere Version zurückgehen,
- den fertigen Smoobu-Connector gleich anschließend testen.
Genau so habe ich meinen Server nachgeschärft: Claude hat den API-Key als Secret hinterlegt, einen Fehler in der Signatur gefunden und behoben, die neue Version veröffentlicht und danach alle fünf Tools gegen Smoobu getestet. Den Wert des Secrets musste ich dafür nicht in den Chat kopieren.
Wichtig: Dieser Connector darf in deinem Cloudflare-Konto Dinge ändern. Prüfe deshalb, was Claude vorhat, bevor du eine Änderung freigibst, und gib ihm nur die Rechte, die er für die Aufgabe braucht.
Den Code in einem GitHub-Repository ablegen
Den Worker kannst du im Cloudflare-Dashboard bearbeiten. Auf Dauer ist es aber besser, den Code in einem privaten GitHub-Repository zu speichern. Das bringt dir drei Vorteile:
- Versionierung: Jede Änderung ist nachvollziehbar und lässt sich zurückdrehen.
- Automatisches Deploy: Verbindest du das Repository in Cloudflare mit dem Worker (Workers Builds), geht jeder Push auf den Hauptzweig nach etwa einer Minute live.
- Claude als Entwickler: Gibst du Claude Zugriff auf das Repository, schreibt es Änderungen am Code, legt sie dort ab und der Rest läuft automatisch. So pflege ich übrigens auch diesen Blog.
Secrets gehören auch dann nicht ins Repository. Sie bleiben im Worker bei Cloudflare, und im Code steht nur ihr Name. Entscheide dich außerdem für eine Quelle: Wenn du den Worker aus GitHub veröffentlichst, ändere den Code nicht mehr zusätzlich im Dashboard. Sonst überschreibt der nächste Push deine Änderung.
Beispielabfragen aus der Praxis
Der eigentliche Nutzen zeigt sich erst im Alltag. Solche Fragen stelle ich Claude, jeweils in ganz normaler Sprache:
Buchungsstand im Vergleich zum Vorjahr
„Wie viele Nächte und wie viel Umsatz habe ich für Juni bis August 2027 schon gebucht? Vergleiche das mit dem Stand, den ich am gleichen Stichtag im Vorjahr für Juni bis August 2026 hatte. Stornierungen und Blockierungen bitte herausrechnen.“
Claude ruft dafür zweimal die Buchungen ab: einmal für den aktuellen Zeitraum und einmal für den Vorjahreszeitraum, gefiltert nach Erstelldatum bis zum gleichen Stichtag. Danach rechnet es Nächte, Auslastung und Umsatz nebeneinander. Das ist der klassische Vergleich mit dem gleichen Stichtag im Vorjahr, für den man sonst einen CSV-Export und etwas Excel-Arbeit braucht. Warum dieser Vergleich so wichtig ist, steht im Artikel „Buchungsstand richtig vergleichen“.
Kanäle
„Wie verteilen sich die Buchungen 2026 auf Airbnb, Booking.com und Direktbuchungen, nach Nächten und nach Umsatz?“
Lücken im Kalender
„Welche Zeiträume in den Herbstferien 2027 sind noch frei, und welcher Mindestaufenthalt und Preis gelten dort?“
Hier nutzt Claude die Preis- und Verfügbarkeitsdaten aus smoobu_get_rates.
Offene Zahlungen
„Bei welchen Buchungen mit Anreise in den nächsten 30 Tagen ist die Anzahlung oder die Kaution noch nicht als bezahlt markiert?“
Vorbereitung für die Buchhaltung
„Liste alle Buchungen mit Abreise im Oktober 2026 mit Kanal, Bruttopreis und Nächten auf, als Tabelle zum Abgleich mit Lexware.“
Der letzte Punkt ersetzt nicht die Buchhaltung, spart aber beim monatlichen Abgleich der Erlöse viel Sucharbeit. Prüfe die Ergebnisse trotzdem stichprobenartig gegen Smoobu, gerade bei Stornierungen und Blockierungen. In meinem Test lieferte die Smoobu-API stornierte Buchungen mit, auch ohne dass sie ausdrücklich angefordert waren. Sag Claude deshalb in der Frage, ob Stornierungen zählen sollen oder nicht.
Sicherheit und Datenschutz
In Smoobu stecken Namen, Adressen und Kontaktdaten deiner Gäste. Wer Smoobu an eine KI anschließt, sollte deshalb ein paar Regeln einhalten.
Zugangsdaten nur als Secret. API-Key und API-Secret gehören als verschlüsselte Secrets in den Worker, nicht als normale Variable und nicht in ein Git-Repository. Wer das Secret hat, kann in deinem Namen auf Smoobu zugreifen. Bei Verdacht auf ein Leck erzeugst du in Smoobu sofort ein neues Schlüsselpaar.
Nur lesen. Die Smoobu-API kann auch Buchungen anlegen, ändern und löschen und Preise setzen. Mein Server lässt technisch nur GET-Aufrufe auf /api/ zu. Selbst ein missverstandener Auftrag oder eine manipulierte Eingabe kann so nichts kaputt machen. In Claude kannst du zusätzlich unter den Tool-Berechtigungen des Connectors einzelne Tools blockieren oder vor jedem Aufruf nachfragen lassen.
Anmeldung erzwingen. Ein Remote-MCP-Server ohne Anmeldung ist für jeden offen, der die URL kennt. Mit OAuth, kurzlebigen Tokens und einer Sperre nach Fehlversuchen ist das Risiko klein.
Datensparsamkeit. Das Buchungs-Tool gibt keine E-Mail-Adressen und Telefonnummern aus. Kontaktdaten holt Claude nur, wenn du gezielt eine einzelne Buchung abfragst. Für Auswertungen braucht man sie nicht.
DSGVO. Sobald Gastdaten an Claude gehen, verarbeitet Anthropic sie in deinem Auftrag. Prüfe, welcher Claude-Tarif und welche Datenschutzeinstellungen für dich gelten, insbesondere ob Chats für das Training verwendet werden dürfen, und schalte das für diesen Zweck ab. Vermerke die Verarbeitung in deinem Verzeichnis von Verarbeitungstätigkeiten und erwähne den Einsatz eines KI-Dienstes in deiner Datenschutzerklärung für Gäste. Für Geschäftskunden bietet Anthropic einen Auftragsverarbeitungsvertrag an. Das ist keine Rechtsberatung. Im Zweifel klärst du die Details mit deinem Datenschutzberater.
Prompt Injection im Blick behalten. Gastnachrichten oder Buchungsnotizen sind fremder Text. Theoretisch könnte jemand dort Anweisungen an eine KI verstecken. Bei einem rein lesenden Server ohne weitere schreibende Connectors im selben Chat ist der Schaden begrenzt. Trotzdem gilt: Ergebnisse prüfen, bevor du danach handelst.
Fazit
Mit einem kleinen Remote-MCP-Server auf Cloudflare Workers wird Smoobu für Claude lesbar. Statt Berichte zu exportieren, fragst du einfach: Wie steht der Sommer im Vergleich zum Vorjahr? Welche Wochen sind noch frei? Welche Anzahlungen fehlen? Mit etwas Programmiererfahrung ist das an einem Nachmittag eingerichtet.
Die drei wichtigsten Punkte zum Schluss: Zugangsdaten nur als Secret im Worker, der Server nur lesend und der Zugang nur mit Anmeldung. Dann hast du ein Werkzeug, das dir als Selbstvermieter Zeit spart, ohne deine Gästedaten unnötig zu verteilen.
Häufige Fragen
Brauche ich Programmierkenntnisse, um Smoobu mit Claude zu verbinden?
Ein wenig. Du musst ein Terminal bedienen, ein Node.js-Projekt anlegen und etwas JavaScript oder TypeScript anpassen. Die Smoobu-Logik selbst umfasst wenige hundert Zeilen, und beim Schreiben kann dir Claude helfen.
Was kostet die Lösung?
Der kostenlose Tarif von Cloudflare Workers reicht für einen privaten Vermieter in der Regel aus. Ob die Smoobu-API in deinem Tarif enthalten ist, siehst du in den Smoobu-Einstellungen unter API-Schlüssel. Custom Connectors in Claude gibt es laut Anthropic in allen Tarifen, im kostenlosen Tarif ist einer möglich.
Kann Claude über MCP Buchungen in Smoobu ändern?
Nur wenn dein Server schreibende Tools anbietet. Die hier beschriebene Lösung ist bewusst rein lesend. Ich empfehle, mit Lesen zu starten und Schreibzugriffe, wenn überhaupt, nur mit Rückfrage vor jedem Aufruf freizugeben.
Funktioniert der alte Smoobu-API-Key noch?
Nein. Laut Smoobu-Dokumentation ist die Anmeldung mit dem einzelnen Api-Key-Header seit dem 31. Oktober 2026 abgeschaltet. Neue Integrationen brauchen API-Key plus Secret und signieren jede Anfrage per HMAC-SHA256.
Gibt es ein Limit für Abfragen?
Smoobu erlaubt laut Dokumentation bis zu 700 Anfragen pro Minute. Bei normaler Nutzung durch Claude erreicht man das nicht. Eine Buchungsabfrage über ein ganzes Jahr braucht bei einem einzelnen Ferienhaus meist nur ein bis zwei Seiten zu je 100 Buchungen.
Funktioniert das auch mit mehreren Ferienwohnungen?
Ja. Die Tools liefern Objekt-ID und Objektnamen mit, und du kannst nach einem einzelnen Objekt filtern. Für Vermieter mit mehreren Einheiten ist der Vergleich zwischen den Objekten besonders nützlich.
Ist das DSGVO-konform?
Das hängt von deinen Einstellungen und deiner Dokumentation ab, denn Gastdaten werden an einen KI-Dienst übertragen. Datensparsame Tools, deaktiviertes Training, ein Eintrag im Verarbeitungsverzeichnis und ein Hinweis in der Datenschutzerklärung sind das Mindeste. Im Zweifel fragst du deinen Datenschutzberater.
Geht das auch mit anderen KI-Assistenten?
MCP ist ein offener Standard. Ein Remote-MCP-Server lässt sich grundsätzlich auch mit anderen MCP-fähigen Programmen nutzen, zum Beispiel Claude Code. Wie gut die Einbindung jeweils funktioniert, hängt vom Programm ab.