hostaway-mcp

Servidor MCP de solo lectura adaptado a la hospitalidad para Hostaway.

Este repositorio contiene únicamente el producto del operador: stdio local/npm, seis herramientas de solo lectura, sin Cloudflare Worker y sin superficie de reservas Seascape.

Objetivo de la V1

Hacer que Codex y Claude sean útiles en flujos de trabajo reales de Hostaway sin tener que configurar manualmente llamadas a la API sin procesar cada vez.

La V1 es intencionalmente limitada:

• solo lectura

• herramientas nativas de hospitalidad, no paridad de endpoints sin procesar

• optimizado para contexto de conversación, búsqueda de reservas y búsqueda de anuncios

Related MCP server: guesty-mcp-server

Superficie exacta de la V1

• list_unread_guest_threads

• get_conversation_context

• get_reservation_brief

• get_listing_brief

• search_reservations

• search_conversations

Desarrollo local

npm install
npm test
npm run check
npm run build

Ejecute el servidor stdio localmente:

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

Cree un paquete tarball de npm local:

npm pack

Después de publicar, ejecute sin clonar:

npx hostaway-mcp

Configuración del cliente MCP

Para clientes MCP locales, proporcione HOSTAWAY_API_TOKEN a través del entorno y ejecute el paquete npm publicado a través de stdio.

Los fragmentos a continuación están fijados a la versión publicada actual:

hostaway-mcp@0.2.0

Actualice esa versión intencionalmente cuando realice una actualización.

Claude Desktop (macOS)

Edite ~/Library/Application Support/Claude/claude_desktop_config.json.

Si ya tiene claves de nivel superior como preferences, manténgalas y agregue mcpServers junto a ellas:

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

Reinicie Claude Desktop después de guardar el archivo.

Codex

Edite ~/.codex/config.toml y agregue:

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

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

Verifique que el servidor esté registrado:

codex mcp list

CLI compilada localmente

Si desea ejecutar el repositorio clonado en lugar de npm, apunte el cliente directamente a la CLI compilada:

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

Variables de entorno

No objetivos de la V1

• enviar mensajes a los huéspedes

• modificar reservas o anuncios

• transporte de Cloudflare Worker

• flujos de reserva/distribución de Seascape

• ingesta de webhooks

• tuberías de sincronización en segundo plano

• paneles o informes de propietarios

• cobertura de proxy REST-a-MCP genérica

Diseño de la fuente

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