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

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 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 apaleo-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

• „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

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