Lodgify über MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Lodgify-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden