OwnerRez MCP connector (gehostet)

Ein Remote-MCP-Server, der Claude Tools bereitstellt, um dein OwnerRez-Konto zu lesen und darin Aktionen durchzuführen: Buchungen, Unterkünfte, Gäste, Finanzen (Angebote, Zahlungen, Rückerstattungen, Gebühren) und Gastnachrichten.

Er basiert auf dem Open-Source-Projekt ownerrez-mcp (MIT-lizenziert) – dieses Repository ergänzt einen Streamable-HTTP-Transport und eine Bearer-Token-Absicherung, sodass er als öffentlicher Webdienst laufen und Claude als benutzerdefinierter Connector hinzugefügt werden kann, statt nur lokal zu laufen.

Lies zuerst dies: Was er kann und was nicht

Die Account-API von OwnerRez („API for Apps“, die Art, für die du einen persönlichen Token erhältst) ist Lesen plus Messaging, keine vollständige Lese-/Schreib-Buchungs-API:

Das Erstellen von Buchungen und das Blockieren von Kalenderdaten gibt es nur in der separaten Channel API von OwnerRez, die für zugelassene OTA-/Channel-Partner-Integrationen (Airbnb, Vrbo usw.) reserviert ist – nicht über den API-Token deines eigenen Kontos verfügbar. „Blockiere diese Kalenderdaten“ oder „Erstelle diese Buchung“ ist also nichts, was dieser Connector – oder ein anderes Tool, das deine persönlichen OwnerRez-Zugangsdaten verwendet – heute tun kann. Wenn du Kalenderdaten programmatisch blockieren musst, sind die praktischen Optionen die eigene Kalender-UI von OwnerRez oder (da du PriceLabs bereits verbunden hast) die Date-Override-Tools von PriceLabs, die mit OwnerRez synchronisiert werden.

Alles in der linken Spalte ist real und funktioniert in diesem Server.

Related MCP server: Hospitable MCP Server

1. Einen OwnerRez-Personal-Access-Token erhalten

In OwnerRez: Settings → API → Personal Access Tokens (siehe die Authentifizierungsdokumentation von OwnerRez, falls du es dort nicht genau findest – OwnerRez hat dieses Menü schon umorganisiert). Erzeuge einen Token; du erhältst einen Benutzernamen und einen Token-Wert. Bewahre beides auf – du fügst sie in die Umgebungsvariablen deiner Hosting-Plattform ein, niemals in einen Browser oder Chat.

2. Einen Connector-Zugriffstoken erzeugen

Dies ist ein separates Geheimnis – nicht von OwnerRez –, das Claude bei jeder Anfrage mitschickt, damit zufällige Besucher nicht auf deinen Server zugreifen und deine Buchungsdaten abrufen können. Erzeuge einen:

python3 -c "import secrets; print(secrets.token_urlsafe(32))"

3. Bereitstellen

Option A – Render (empfohlen, kein Serverbetrieb)

1. Dieses Repository ist bereits auf GitHub unter gcwharton-a11y/ownerrez-mcp.

2. Wähle im Render-Dashboard die Option New + → Blueprint, verbinde dein GitHub-Konto, falls du dazu aufgefordert wirst, und wähle dieses Repository – die render.yaml hier konfiguriert den Dienst automatisch.

3. Wenn du nach Umgebungsvariablen gefragt wirst, setze Folgendes:

   • MCP_ACCESS_TOKEN – das Geheimnis aus Schritt 2

   • OWNERREZ_USERNAME / OWNERREZ_TOKEN – aus Schritt 1

   • OWNERREZ_READ_ONLY – lasse es auf 1, um zunächst schreibgeschützt zu starten, oder entferne es, um das Senden von Gastnachrichten und die Webhook-Verwaltung zu erlauben (siehe Tabelle oben – dadurch werden Buchungs-/Kalenderdatenschreibvorgänge nie aktiviert, weil die API von OwnerRez sie nicht anbietet)

4. Stelle bereit. Render gibt dir eine URL wie https://ownerrez-mcp.onrender.com. Deine Connector-URL ist diese URL plus /mcp/ – z. B. https://ownerrez-mcp.onrender.com/mcp/.

Option B – Beliebiger Docker-Host (Railway, Fly.io, eigene VM)

Das enthaltene Dockerfile läuft überall, wo ein Container und eine PORT-Umgebungsvariable akzeptiert werden:

docker build -t ownerrez-mcp .
docker run -p 8080:8080 \
  -e MCP_ACCESS_TOKEN=... \
  -e OWNERREZ_USERNAME=... \
  -e OWNERREZ_TOKEN=... \
  -e OWNERREZ_READ_ONLY=1 \
  ownerrez-mcp

Lokaler Test (ohne Bereitstellung)

git clone https://github.com/gcwharton-a11y/ownerrez-mcp.git
cd ownerrez-mcp
pip install -r requirements.txt
MCP_ACCESS_TOKEN=devtoken OWNERREZ_USERNAME=... OWNERREZ_TOKEN=... \
  uvicorn http_app:app --host 0.0.0.0 --port 8080
curl http://localhost:8080/health   # -> ok

4. Als benutzerdefinierten Connector zu Claude hinzufügen

1. Gehe in Claude zu Settings → Connectors → Add custom connector (ein Organisations-Administrator muss diesen Schritt ausführen).

2. Server-URL: https://<your-deployed-host>/mcp/ (mit abschließendem Schrägstrich).

3. Authentifizierungstyp: Wähle request headers (statischer Header / API-Key-Authentifizierung). Gib Folgendes ein:

   • Header-Name: Authorization

   • Header-Wert: Bearer <the MCP_ACCESS_TOKEN from step 2>

4. Speichere. Claude sendet diesen Header bei jedem Aufruf an deinen Server, und die Middleware von http_app.py prüft ihn, bevor irgendetwas OwnerRez berührt.

Falls dein Claude-Tarif die headerbasierte Authentifizierung für benutzerdefinierte Connector noch nicht bereitstellt (sie befindet sich in der Beta-Phase), besteht der Fallback darin, den Server nicht öffentlich zu machen (teile die URL nicht) – jeder ohne den Token erhält bei jeder Anfrage trotzdem eine 401, er ist also auch ohne eingerichtete Connector-Authentifizierung nicht offen.

Sicherheitshinweise

• Der Bearer-Token schützt die OwnerRez-Daten des gesamten Kontos – behandle ihn wie ein Passwort. Rotiere ihn (neu erzeugen und mit einem neuen MCP_ACCESS_TOKEN neu bereitstellen), falls du jemals vermutest, dass er geleakt ist.

• OWNERREZ_READ_ONLY=1 ist die sicherere Standardeinstellung; entferne sie nur, wenn du möchtest, dass Claude in deinem Namen Gastnachrichten senden oder Webhook-Abonnements verwalten kann.

• Nichts hier kann eine Buchung erstellen, ändern oder stornieren oder Preise beeinflussen – das liegt außerhalb dessen, was die Account-API von OwnerRez bereitstellt, und ist nicht nur eine Einschränkung dieses Servers.

Danksagung

Tool-Definitionen, der OwnerRez-API-Client, Retry/Backoff und die Read-only-Schutzlogik stammen aus buildwithmanag/ownerrez-mcp (MIT-Lizenz, enthalten als LICENSE.upstream). http_app.py und die Bereitstellungsdateien in diesem Repository sind die Ergänzungen, die dafür sorgen, dass es als gehosteter, authentifizierter Remote-Server läuft und nicht als lokaler Stdio-Prozess.