apaleo über MCP mit Claude verbinden

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

apaleo + Claude

Hotelbetrieb im Cloud-PMS apaleo: Häuser, Zimmer und Zimmerkategorien, Ratenpläne und Raten, Verfügbarkeit und Angebote, Buchungen, Reservierungen und Gäste, Gruppen, Folios, Zahlungen, Rechnungen, Wartung, Housekeeping und Performance-Berichte. Legt Buchungen an, weist Zimmer zu und checkt Gäste ein und aus. Verbindet sich als App mit OAuth2 Client Credentials; Stornos und No-Shows sind bei der Installation deaktiviert.

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:

APALEO_CLIENT_ID, APALEO_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein apaleo-Konto mit Zugriff auf Apps. Eine Anmeldung im Browser gibt es nicht: Der Connector meldet sich als App mit dem OAuth2-Grant Client Credentials an.

1. Öffne in apaleo Apps > Connected apps > Add a custom app (oder registriere auf apaleo.dev einen OAuth simple client mit Client Credentials).
2. Gib der App die Berechtigungen, die das Team braucht. Zum Lesen zum Beispiel properties.read, unitgroups.read, units.read, rateplans.read, rates.read, services.read, companies.read, availability.read, offers.read, reservations.read, groups.read, blocks.read, folios.read, payments.read, invoices.read, maintenances.read und reports.read; für die Schreib-Tools reservations.create, reservations.manage, reservations.assign-unit, maintenances.create und operations.change-room-state. Lass die Schreibrechte weg, wenn der Connector nur lesen soll.
3. Kopiere die Client-ID in APALEO_CLIENT_ID und das Client Secret in APALEO_CLIENT_SECRET. Das Secret wird nur einmal angezeigt; ist es verloren, erzeugst du in der App ein neues.
4. Installiere den Connector und führe apaleo_list_properties aus, um die Verbindung zu prüfen.

Der Connector holt ein Token bei https://identity.apaleo.com/connect/token und erneuert es jede Stunde. Jeder Aufruf läuft als Custom App mit deren Berechtigungen; fehlt der App ein Recht, kommt 403.

Was er liest:

• Inventar und Raten: Häuser (Hotels), Unit Groups (Zimmerkategorien), Units (Zimmer) mit Zustand und Wartung, Ratenpläne, Preise pro Nacht mit Restriktionen (apaleo_list_rates), Services (Extras wie Frühstück oder Parken), Stornobedingungen und Firmen (Firmenkunden).
• Verfügbarkeit und Angebote: freie Zimmer je Kategorie und Nacht (apaleo_get_unit_group_availability), Zimmer, die für einen ganzen Aufenthalt frei sind (apaleo_get_unit_availability), Zimmer, die einer Reservierung zugewiesen werden können, und apaleo_get_offers, die buchbaren Ratenpläne mit Preisen für einen Aufenthalt.
• Buchungen und Reservierungen: apaleo_list_reservations mit text_search (Name, E-Mail, Reservierungsnummer) und date_filter Arrival, Departure oder Stay zusammen mit from und to; apaleo_count_reservations zählt, ohne sie zu laden. Dazu Buchungen, Services einer Reservierung, Gruppen und Blocks. Gäste sind Teil der Reservierungen (primaryGuest, additionalGuests) und der Buchungen (booker).
• Abrechnung: Folios (Gästerechnungen, über reservation_ids zu finden), Zahlungen auf Folios und Rechnungen.
• Betrieb und Berichte: Wartungsfenster, Property Performance (Auslastung, ADR, RevPAR), Umsätze nach Konto mit Netto, Brutto und MwSt. (für höchstens ein Jahr) und Anreisen pro Tag eines Monats.

Was er schreibt:

• Buchungen: apaleo_create_booking mit der ratePlanId und einem timeSlice pro Nacht aus apaleo_get_offers. apaleo_update_booking und apaleo_update_reservation nehmen JSON-Patch-Operationen wie [{"op": "replace", "path": "/comment", "value": "Late arrival"}]. apaleo_amend_reservation ändert Anreise, Abreise, Gästezahl, Ratenplan und Preis pro Nacht.
• Rezeption: apaleo_assign_unit (apaleo wählt ein freies Zimmer) oder apaleo_assign_specific_unit, apaleo_unassign_units, apaleo_check_in_reservation (rückgängig mit apaleo_revert_check_in) und apaleo_check_out_reservation, das alle offenen Posten auf das Folio bucht und nur geht, wenn die Abreise nicht später als morgen ist.
• Housekeeping und Wartung: apaleo_set_unit_conditions (Clean, CleanToBeInspected, Dirty) und apaleo_create_maintenance (OutOfService, OutOfOrder, OutOfInventory).

Buchungen, Check-ins und Check-outs ändern den laufenden Hotelbetrieb, deshalb zeigt dir die KI, was sie ändern will, und wartet auf dein Ja.

Bei der Installation deaktiviert: apaleo_cancel_reservation (es gilt die Stornogebühr der Bedingung des Ratenplans, und eine stornierte Reservierung lässt sich nicht reaktivieren) und apaleo_set_reservation_no_show (bucht die No-Show-Gebühr auf das Folio und lässt sich nicht zurücknehmen). Ein Admin schaltet sie ein, wenn das Team sie braucht.

Datenformate: IDs sind lesbare Codes: ein Haus MUC, eine Unit Group MUC-DBL, eine Unit MUC-101, ein Ratenplan MUC-FLEX-DBL, eine Buchung ABCDEF, ihre Reservierungen ABCDEF-1 und ABCDEF-2, ein Folio ABCDEF-1-1. Beträge sind {"amount": 120.0, "currency": "EUR"} in Haupteinheiten; der balance einer Reservierung ist negativ, wenn der Gast noch Geld schuldet. Datumsangaben sind YYYY-MM-DD; Zeiten sind ISO 8601 mit dem UTC-Offset des Hauses. Eine Nacht gehört zu dem Geschäftstag, an dem sie beginnt; to ist bei Verfügbarkeit und Performance eingeschlossen, beim Umsatzbericht ausgeschlossen. Der Reservierungsstatus ist Confirmed, InHouse, CheckedOut, Canceled oder NoShow. Filter mit mehreren Werten werden ohne Leerzeichen mit Kommas getrennt (status: Confirmed,InHouse), und expand fügt eingebettete Objekte hinzu (expand: booker,assignedUnits).

Blättern: Listen nehmen page_number (ab 1) und page_size (bis 500) und liefern die Gesamtzahl in count. Eine Seite hinter dem Ende antwortet mit 204 No Content, es gibt dann nichts mehr.

Häufige Fehler: 401 bedeutet eine falsche Client-ID, ein falsches Secret oder ein abgelaufenes Token. 403 bedeutet, dass der Custom App eine Berechtigung fehlt. 404 ist eine unbekannte ID. 422 ist eine Geschäftsregel, etwa ein Check-in vor dem Anreisetag, kein zugewiesenes Zimmer oder ein ausverkauftes Angebot, mit dem Grund in messages. 429 ist das Rate-Limit.

Der Connector bucht keine Posten oder Zahlungen, erstellt keine Rechnungen, ändert keine Ratenpläne, Preise oder Inventar und verwaltet keine apaleo-Benutzer oder Apps.

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

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. apaleo, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

Verfügbare Tools

Beispiel-Prompts

• „Welche Reservierungen reisen heute in MUC an, und welche davon haben noch kein Zimmer zugewiesen?“
• „Wie viele Doppelzimmer sind nächsten Freitag und Samstag noch frei, und was kostet die flexible Rate für beide Nächte?“
• „Zeig mir Auslastung, ADR und RevPAR des letzten Monats im Vergleich zum Vormonat.“
• „Weise der Reservierung ABCDEF-1 ein sauberes Zimmer zu und checke den Gast ein.“
• „Setz die Zimmer MUC-101 bis MUC-105 auf sauber und nimm MUC-210 wegen einer defekten Dusche bis Montag außer Betrieb.“

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

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