Lodgify über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Lodgify klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Lodgify + Gemini

Ferienvermietung mit Lodgify: Unterkünfte und Zimmertypen, Verfügbarkeitskalender, Preise pro Nacht und Angebote, Buchungen und Anfragen, Nachrichtenverläufe mit Gästen, Check-in und Check-out, Schlüsselcodes und Statusänderungen von Buchungen. Arbeitet mit dem Public-API-Key des Kontos.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

LODGIFY_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst den Inhaber des Lodgify-Kontos, denn nur er sieht den API-Key.

1. Öffne in Lodgify (https://app.lodgify.com) Settings > Public API und kopiere den API-Key.
2. Füge ihn in LODGIFY_API_KEY ein. Er wird im Header X-ApiKey gesendet.
3. Installiere den Connector und führe lodgify_list_properties aus, um den Key zu prüfen.

Der Key gibt vollen Zugriff auf das Konto: Alle, die diesen Connector nutzen, arbeiten mit jeder Unterkunft, jeder Buchung und jedem Gästeverlauf des Kontos.

Was er liest:

• Unterkünfte und Zimmertypen: lodgify_list_properties, lodgify_get_property, lodgify_list_property_rooms (die Zimmertyp-IDs, die Preise, Verfügbarkeit, Angebote und Buchungen brauchen), lodgify_get_room, seit einem Datum gelöschte Unterkünfte sowie die Zusatzleistungen und Zahlungsarten einer Unterkunft.
• Verfügbarkeit: der Kalender des ganzen Kontos, einer Unterkunft oder eines Zimmertyps für einen Zeitraum, auf Wunsch mit den Buchungen und Sperrzeiten, die die Tage blockieren.
• Preise: Preise pro Nacht und Mindestaufenthalt je Tag (lodgify_get_rates_calendar), Preiseinstellungen (Steuern, Gebühren, Anzahlung, Stornoregeln, Preis pro zusätzlichem Gast) und lodgify_get_quote, der Gesamtpreis eines möglichen Aufenthalts mit Zimmerpreis, Gebühren, Steuern, Zusatzleistungen und Aktionscode.
• Buchungen: lodgify_list_bookings mit stay_filter Upcoming, Current, Historic, All oder ArrivalDate und DepartureDate zusammen mit stay_filter_date (zum Beispiel die heutigen Anreisen); lodgify_get_booking mit Gast, Zimmern, Summen, bezahltem und offenem Betrag, Notizen, Schlüsselcodes und dem Nachrichtenverlauf; verknüpfte Kanalbuchungen (Airbnb, Booking.com, Vrbo, ...); das Angebot einer Buchung und der Zahlungslink für den Gast.
• Posteingang: lodgify_list_inbox (Buchungen und Anfragen zusammen, neueste zuerst), lodgify_count_unread, lodgify_get_enquiry und lodgify_get_thread mit der thread_uid einer Buchung oder Anfrage.

Was er schreibt:

• Neue Buchung: Die KI prüft lodgify_get_room_type_availability und lodgify_get_quote und ruft dann lodgify_create_booking auf. Lodgify ignoriert dort den Status, deshalb bestätigt die KI die Buchung anschließend mit lodgify_set_booking_booked oder hält die Tage mit lodgify_set_booking_tentative frei. Mit from_enquiry_id wird eine bestehende Anfrage zur Buchung.
• Statusänderungen: lodgify_decline_booking (die Tage werden wieder frei) und lodgify_reopen_booking (zurück auf Open; eine Booked-Buchung gibt ihre Tage frei).
• Anreise und Abreise: lodgify_update_key_codes setzt die Tür- oder Schlüsselbox-Codes, die der Gast sieht; lodgify_check_in_booking und lodgify_check_out_booking halten An- und Abreisezeit fest.
• Nachrichten: lodgify_add_booking_messages und lodgify_add_enquiry_messages ergänzen einen Verlauf; der Typ Comment speichert eine interne Notiz, die der Gast nicht sieht. lodgify_mark_booking_replied und lodgify_mark_booking_not_replied ordnen den Verlauf im Posteingang ein.

E-Mails an Gäste: Nachrichten mit send_notification: true, lodgify_request_payment und request_payment: true bei einer Statusänderung schicken dem Gast eine E-Mail. Die KI zeigt dir den Text und wartet auf dein Ja, bevor sie sendet.

Bei der Installation deaktiviert: kein Tool. Der Connector hat kein Lösch-Tool, und eine abgelehnte Buchung lässt sich mit lodgify_reopen_booking wieder öffnen.

Datenformate: IDs von Unterkünften, Zimmertypen und Buchungen sind Ganzzahlen; ein Nachrichtenverlauf ist eine GUID (thread_uid). Datumsangaben sind YYYY-MM-DD; Check-in- und Check-out-Zeiten sind HH:mm:ss in der Zeitzone der Unterkunft; Änderungsdaten sind ISO 8601. Beträge sind in der Währung der Unterkunft (currency_code), in Haupteinheiten (120.5 = 120,50). Der Buchungsstatus ist Open (eine Anfrage), Tentative, Booked oder Declined; source nennt den Kanal (Manual, AirbnbIntegration, BookingCom, ...).

Blättern: v2-Listen nehmen page (ab 1) und size (Standard 50); mit include_count: true kommt die Gesamtzahl in count. lodgify_list_inbox nutzt offset und limit und liefert total.

Häufige Fehler: 401 oder 403 bedeutet einen fehlenden oder falschen API-Key, 404 eine unbekannte ID, 400 ungültige Daten oder Parameter (der Antworttext nennt sie). 429 ist das Rate-Limit: Die KI wartet und versucht es erneut.

Der Connector ändert keine Preise oder Verfügbarkeiten, erstellt keine Zahlungslinks, verwaltet keine Webhooks und verschiebt keine Buchungen in den Papierkorb.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Lodgify-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wer reist heute in unseren Unterkünften an? Zeig mir Gastname, Unterkunft, Personenzahl und den noch offenen Betrag.“
• „Ist das Sea View Apartment vom 12. bis 19. Juli für 2 Erwachsene und einen Hund frei, und was würde der Aufenthalt kosten?“
• „Welche Gästenachrichten sind noch unbeantwortet? Fass jeden Verlauf kurz zusammen.“
• „Setz für Buchung 1234567 den Schlüsselbox-Code 4821 und entwirf eine Check-in-Nachricht an den Gast. Zeig sie mir vor dem Senden.“
• „Leg für Laura Bianchi eine Buchung im Garden Studio vom 3. bis 7. März an und bestätige sie.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden