OwnerRez MCP connector (хостируемый)

Удалённый MCP-сервер, который предоставляет Claude инструменты для чтения данных вашего аккаунта OwnerRez и выполнения действий: бронирования, объекты, гости, финансы (ценовые предложения, платежи, возвраты, комиссии) и обмен сообщениями с гостями.

Он построен на основе проекта с открытым исходным кодом ownerrez-mcp (лицензия MIT) — этот репозиторий добавляет транспорт Streamable HTTP и защиту bearer-токеном, чтобы сервер можно было запускать как публичный веб-сервис и подключать к Claude как пользовательский коннектор, а не только запускать локально.

Прочтите сначала: что он умеет и чего не умеет

Аккаунтный API OwnerRez («API for Apps» — тот, для которого вы получаете персональный токен) — это чтение плюс обмен сообщениями, а не полноценный API бронирований с чтением и записью:

Создание бронирований и блокировка дат существуют только в отдельном Channel API OwnerRez, который предназначен для одобренных интеграций с OTA/канальными партнёрами (Airbnb, Vrbo и т. д.), — через API-токен вашего собственного аккаунта это недоступно. Поэтому «заблокируйте эти даты» или «создайте это бронирование» — не то, что этот коннектор (или любой инструмент, использующий ваши личные учётные данные OwnerRez) может сделать сегодня. Если вам нужно блокировать даты программно, практичные варианты — собственный интерфейс календаря OwnerRez или (раз уж у вас уже подключён PriceLabs) инструменты PriceLabs для переопределения дат, которые синхронизируются обратно с OwnerRez.

Всё, что в левой колонке, действительно работает в этом сервере.

Related MCP server: Hospitable MCP Server

1. Получите персональный токен доступа OwnerRez

В OwnerRez: Settings → API → Personal Access Tokens (если вы не найдёте это именно там, смотрите собственную документацию по аутентификации OwnerRez — OwnerRez уже переносил это меню). Сгенерируйте токен; вы получите username и значение token. Сохраните оба — вы вставите их в переменные окружения вашей хостинг-платформы, и никогда не вставляйте их в браузер или в чат.

2. Сгенерируйте токен доступа коннектора

Это отдельный секрет — не из OwnerRez, — который Claude будет отправлять обратно с каждым запросом, чтобы случайные посетители не могли обращаться к вашему серверу и вытаскивать данные о бронированиях. Сгенерируйте его:

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

Сохраните его; он понадобится на шагах 3 и 4.

3. Деплой

Вариант A — Render (рекомендуется, без управления сервером)

1. Этот репозиторий уже находится на GitHub: gcwharton-a11y/ownerrez-mcp.

2. В панели управления Render выберите New + → Blueprint, подключите свой аккаунт GitHub, если будет предложено, и выберите этот репозиторий — файл render.yaml здесь настраивает сервис автоматически.

3. Когда появится запрос на переменные окружения, задайте:

   • MCP_ACCESS_TOKEN — секрет из шага 2

   • OWNERREZ_USERNAME / OWNERREZ_TOKEN — из шага 1

   • OWNERREZ_READ_ONLY — оставьте значение 1, чтобы начать в режиме только для чтения, или очистите его, чтобы разрешить отправку сообщений гостям и управление вебхуками (см. таблицу выше — это никогда не включает запись бронирований/дат, потому что API OwnerRez их не предоставляет)

4. Выполните деплой. Render выдаст вам URL вида https://ownerrez-mcp.onrender.com. URL вашего коннектора — это этот URL плюс /mcp/, например https://ownerrez-mcp.onrender.com/mcp/.

Вариант B — Любой Docker-хост (Railway, Fly.io, своя виртуальная машина)

Включённый Dockerfile работает в любом месте, которое принимает контейнер и переменную окружения 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

Локальное тестирование (без деплоя)

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. Добавьте его в Claude как пользовательский коннектор

1. В Claude перейдите в Settings → Connectors → Add custom connector (этот шаг должен выполнить администратор организации).

2. Server URL: https://<your-deployed-host>/mcp/ (с косой чертой в конце).

3. Authentication type: выберите request headers (статический заголовок / аутентификация по API-ключу). Введите:

   • Header name: Authorization

   • Header value: Bearer <the MCP_ACCESS_TOKEN from step 2>

4. Сохраните. Claude будет отправлять этот заголовок при каждом вызове вашего сервера, а middleware из http_app.py проверяет его до того, как что-либо обратится к OwnerRez.

Если ваш тариф Claude ещё не предоставляет аутентификацию по заголовкам для пользовательских коннекторов (она в бете), запасной вариант — не публиковать сервер в списке (не делиться URL) — любой запрос без токена всё равно получит 401, так что сервер не открыт, даже если аутентификация на уровне коннектора не подключена.

Примечания по безопасности

• Bearer-токен ограничивает доступ к данным OwnerRez всего аккаунта — относитесь к нему как к паролю. Смените его (перегенерируйте и передеплойте с новым MCP_ACCESS_TOKEN), если заподозрите утечку.

• OWNERREZ_READ_ONLY=1 — более безопасное значение по умолчанию; очищайте его, только если хотите, чтобы Claude мог отправлять сообщения гостям или управлять подписками на вебхуки от вашего имени.

• Ничто здесь не может создавать, изменять или отменять бронирование, а также затрагивать цены — это вне возможностей аккаунтного API OwnerRez, а не просто ограничение этого сервера.

Благодарности

Определения инструментов, API-клиент OwnerRez, логика повторных попыток с экспоненциальной задержкой (retry/backoff) и логика защиты режима только для чтения взяты из buildwithmanag/ownerrez-mcp (лицензия MIT, включена как LICENSE.upstream). http_app.py и файлы развёртывания в этом репозитории — это дополнения, которые позволяют запускать его как размещённый аутентифицированный удалённый сервер, а не локальный процесс stdio.