hostaway-mcp

Schreibgeschützter, auf das Gastgewerbe zugeschnittener MCP-Server für Hostaway.

Dieses Repository enthält nur das Operator-Produkt: lokales/npm stdio, sechs schreibgeschützte Tools, kein Cloudflare Worker und keine Seascape-Buchungsoberfläche.

V1-Ziel

Codex und Claude in echten Hostaway-Workflows nützlich machen, ohne jedes Mal rohe API-Aufrufe manuell programmieren zu müssen.

V1 ist bewusst eng gefasst:

• nur schreibgeschützt

• auf das Gastgewerbe zugeschnittene Tools, keine 1:1-Abbildung der Endpunkte

• optimiert für Konversationskontext, Reservierungssuche und Inseratssuche

Related MCP server: guesty-mcp-server

Exakte V1-Oberfläche

• list_unread_guest_threads

• get_conversation_context

• get_reservation_brief

• get_listing_brief

• search_reservations

• search_conversations

Lokale Entwicklung

npm install
npm test
npm run check
npm run build

Führen Sie den stdio-Server lokal aus:

HOSTAWAY_API_TOKEN=your-token-here node dist/cli.js

Erstellen Sie ein lokales npm-Paket-Tarball:

npm pack

Nach der Veröffentlichung ohne Klonen ausführen:

npx hostaway-mcp

MCP-Client-Einrichtung

Stellen Sie für lokale MCP-Clients HOSTAWAY_API_TOKEN über die Umgebung bereit und starten Sie das veröffentlichte npm-Paket über stdio.

Die unten stehenden Snippets sind auf die aktuell veröffentlichte Version festgelegt:

hostaway-mcp@0.2.0

Aktualisieren Sie diese Version bewusst, wenn Sie ein Upgrade durchführen.

Claude Desktop (macOS)

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json.

Wenn Sie bereits Top-Level-Schlüssel wie preferences haben, behalten Sie diese bei und fügen Sie mcpServers daneben hinzu:

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "hostaway-mcp@0.2.0"],
      "env": {
        "HOSTAWAY_API_TOKEN": "your-token-here"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern der Datei neu.

Codex

Bearbeiten Sie ~/.codex/config.toml und fügen Sie Folgendes hinzu:

[mcp_servers.hostaway]
command = "npx"
args = ["-y", "hostaway-mcp@0.2.0"]

[mcp_servers.hostaway.env]
HOSTAWAY_API_TOKEN = "your-token-here"

Überprüfen Sie, ob der Server registriert ist:

codex mcp list

Lokal erstellte CLI

Wenn Sie den Repository-Checkout anstelle von npm ausführen möchten, verweisen Sie den Client direkt auf die erstellte CLI:

{
  "command": "node",
  "args": ["/absolute/path/to/hostaway-mcp/dist/cli.js"],
  "env": {
    "HOSTAWAY_API_TOKEN": "your-token-here"
  }
}

Umgebungsvariablen

V1 Nicht-Ziele

• Senden von Gastnachrichten

• Ändern von Reservierungen oder Inseraten

• Cloudflare Worker-Transport

• Seascape-Buchungs-/Vertriebsabläufe

• Webhook-Ingestion

• Hintergrund-Synchronisierungspipelines

• Dashboards oder Eigentümerberichte

• allgemeine REST-zu-MCP-Proxy-Abdeckung

Quelldesign

Siehe docs/designs/v1-readonly-hostaway-mcp.md.