OwnerRez MCP connector (alojado)

Un servidor MCP remoto que da a Claude herramientas para leer y actuar sobre tu cuenta de OwnerRez: reservas, propiedades, huéspedes, finanzas (presupuestos, pagos, reembolsos, cargos) y mensajería con los huéspedes.

Está construido sobre el proyecto de código abierto ownerrez-mcp (licencia MIT): este repositorio añade un transporte HTTP Streamable y una protección mediante token de portador a su alreded or para que pueda ejecutarse como un servidor web público y añadirse a Claude como conector personalizado, en lugar de ejecutarse solo localmente.

Léelo primero: qué puede y qué no puede hacer

La API a nivel de cuenta de OwnerRez («API for Apps», el tipo para el que obtienes un token personal) es de lectura más mensajería, no una API de reservas completa de lectra/escritura:

Crear reservas y bloquear fechas solo existe en la Channel API seprada de OwnerRez, que está reservada para integraciones aprobadas de OTA/socios de canal (Airbnb, Vrbo, etc.), no es algo que esté disponible a través del token de API de tu propia cuenta. Así que «bloquear estas fechas» o «crear esta reserva» no es algo que este conector — ni ningún a herramienta que use tus credenciales personales de OwnerRez — puedahacer hoy. Si necesitas bloquear fechas mediante programación, las opciones prácticas son la interfaz de calandario propia de OwnerRez o (ya que tines PriceLabs conectado) las herramientas de anulación de fechas de PriceLabs, que se sincronizan de vuelta con OwnerRez.

Todo lo que está en la columna izquierda es real y funcionan en este servidor.

Related MCP server: Hospitable MCP Server

1. Obten un token de acceso personal de OwnerRez

En OwnerRez: Settings → API → Personal Access Tokens (consulta la documentación de autenticación de OwnerRez si no es exactamente donde lo encuentras: OwnerRez ha reorganizado este menú anteriormente). Genera un token; obtendrás un username y un valor de token. Conserva ambos: los pegarás en las variables de entorno de tu plataforma de alojamiento, nunca en un navegador ni en un chat.

2. Genera un token de acceso para el conector

Este es un secreto independiente —no de OwnerRez— que Claude enviará de vuelta en cada solicitud para que visiantes aleatorios no puedan llegar a tu servidor y extraer tus datos de reservas. Genera uno:

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

Guárda lo; lo necesitarás en el paso 3 y en el paso 4.

3. Despliega

Opción A — Render (recomendada, sin operaciones de servidor)

1. Este repositorio ya está en GitHub en gcwharton-a11y/ownerrez-mcp.

2. En el panorama de Render, elige New + → Blueprint, conecta tu cuenta de GitHub si se te solicit, y selecciona este repositorio: render.yaml aquí configra el servicio automáticmente.

3. Cuando se te pidan las variables de entorno, establece:

   • MCP_ACCESS_TOKEN — el secreto del paso 2

   • OWNERREZ_USERNAME / OWNERREZ_TOKEN — del paso 1

   • OWNERREZ_READ_ONLY — déjalo como 1 para empear en modo solo lectra, o bórralo para permitir el envío de mensajes a los huéspedes y la gestión de webhooks (consulta la tabla anterior: esto nunca habilita escrituras de reservas/fechas, porque la API de OwnerRez no las ofrece)

4. Despliega. Render te da una URL como https://ownerrez-mcp.onrender.com. La URL de tu conector es esa más /mcp/, p. ej. https://ownerrez-mcp.onrender.com/mcp/.

Opción B — Cualquier host de Docker (Railway, Fly.io, tu propia VM)

El Dockerfile includo se ejecuta en cualquier lugar que acepte un contenedor y una variable de entorno PORT:

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

Prueba local (sin desplegar)

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. Añádelo a Claude como conector personalizado

1. En Claude, ve a Settings → Connectors → Add custom conector (un administador de la organización debe hacer este paso).

2. URL del servidor: https://<your-deployed-host>/mcp/ (con la barra final).

3. Tipo de autenticación: elige request headers (cabecera estática / autenticación por clave de API). Introduce:

   • Nombre de la cabecera: Authorization

   • Valr de la cabecera: Bearer <the MCP_ACCESS_TOKEN from step 2>

4. Guarda. Claude enviará esa cabecera en cada llamada a tu servidor, y el middleware de http_app.py la comprueba antes de que nada toque a OwnerRez.

Si tu plan de Claude aún no expone la autenticación basada en cabeceras para conectores personalizados (está en beta), la alternativa es mantener el servidor no listado (no comparras la URL): cualquiera que no tenga el token recibe un 401 en cada solicitud, así que no está abierto aunque no tengas autenticación a nivel de conector configurada.

Notas de seguridad

• El token de portador protege los datos de OwnerRez de toda la cuenta: trátalo como una contraseña. Rota el token (regenera y vuelve a desplegar con un nuevo MCP_ACCESS_TOKEN) si alguna vez sospechas que se ha filtrado.

• OWNERREZ_READ_ONLY=1 es el valor predeterminado más seguro; bórralo solo si quieres que Claude pueda enviar mensajes a los huéspedes o gestionar suscripciones de webhook en tu nomre.

• Nada de esto puede crear, modificar o cancelar una reserva, ni tocar los precios; eso quedafuera de lo que expone la API de cuenta de OwnerRez, no es solo una restricción de este servidor.

Créditos

Las definiciones de herramientas, el cliente de la API de OwnerRez, la lógica de reintentos/backoff y la protección de solo lectra provienen de buildwithmanag/ownerrez-mcp (licencia MIT, includa como LICENSE.upstream). http_app.py y los archivos de despliegue de este repositorio son las adiciones que hacen que se ejecute como un servidor remoto alojado y autenticado en lugar de un proceso stdio local.