Skip to main content
Glama
OwnerRez MCP connector

OwnerRez MCP connector

OwnerRez MCP 连接器(托管版)

一个远程 MCP 服务器,为 Claude 提供读取和操作你的 OwnerRez 账户的工具:预订、房源、住客、财务(报价、付款、退款、费用)以及住客消息。

它构建于开源项目 ownerrez-mcp(MIT 许可)之上——本仓库为其添加了 Streamable HTTP 传输层和一个 bearer 令牌门禁,使其可以作为公共 Web 服务运行,并作为自定义连接器添加到 Claude,而不仅限于本地运行。

先读这里:它能做什么、不能做什么

OwnerRez 的账户级 API(“API for Apps”,即你可以获取个人令牌的那种)是读取加消息,而不是完整的读写预订 API:

可以做的事

不能做的事

列出/读取预订、房源、住客、房东

创建或更新预订

查看当前已入住的住客

屏蔽或取消屏蔽日历日期

读取报价、付款、退款、费用

创建费用

在现有会话线程中发送/读取住客消息

创建新的消息线程

创建/列出/删除 webhook 订阅

创建预订和屏蔽日期只存在于 OwnerRez 独立的 Channel API 中,该 API 专供经批准的 OTA/渠道合作伙伴集成(Airbnb、Vrbo 等)使用——无法通过你自己的账户 API 令牌获得。所以“屏蔽这些日期”或“创建这笔预订”不是本连接器——或任何使用你个人 OwnerRez 凭证的工具——目前能做的事。如果你需要以编程方式屏蔽日期,实际的方案是 OwnerRez 自己的日历界面,或者(既然你已经连接了 PriceLabs)PriceLabs 的日期覆盖工具,后者会同步回 OwnerRez。

左列中的一切功能都是真实存在且可用的。

Related MCP server: OwnerRez MCP Server

1. 获取 OwnerRez 个人访问令牌

在 OwnerRez 中:Settings → API → Personal Access Tokens(如果你找不到确切位置,请参阅 OwnerRez 官方的 身份验证文档——OwnerRez 之前重新调整过这个菜单)。生成一个令牌;你会得到一个用户名和一个令牌值。请将两者都保存好——你需要把它们粘贴到托管平台的环境变量中,切勿粘贴到浏览器或聊天中。

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 以只读模式启动,或将其清空以允许发送住客消息和管理 webhook(见上表——这永远不会启用预订/日期写入,因为 OwnerRez 的 API 不提供这些功能)

  4. 部署。Render 会给你一个类似 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. 服务器 URL:https://<your-deployed-host>/mcp/(带尾部斜杠)。

  3. 身份验证类型:选择 request headers(静态请求头 / API 密钥认证)。输入:

    • 请求头名称:Authorization

    • 请求头值:Bearer <the MCP_ACCESS_TOKEN from step 2>

  4. 保存。Claude 每次调用你的服务器时都会发送该请求头,http_app.py 的中间件会在任何请求触及 OwnerRez 之前对其进行检查。

如果你的 Claude 套餐尚未提供基于请求头的自定义连接器认证(该功能目前处于测试阶段),备用方案是保持服务器不公开(不要分享 URL)——没有令牌的访问者每次请求仍会收到 401,因此即使没有配置连接器级别的认证,服务器也不会开放。

安全说明

  • bearer 令牌是通往整个账户 OwnerRez 数据的门禁——请像对待密码一样对待它。如果你怀疑它泄露了,请轮换它(重新生成并使用新的 MCP_ACCESS_TOKEN 重新部署)。

  • OWNERREZ_READ_ONLY=1 是更安全的默认设置;只有当你希望 Claude 能够代你发送住客消息或管理 webhook 订阅时,才将其清空。

  • 这里的一切都无法创建、修改或取消预订,也无法改动定价——这是 OwnerRez 账户 API 未开放的功能,而不只是此服务器的限制。

致谢

工具定义、OwnerRez API 客户端、重试/退避逻辑以及只读保护逻辑均来自 buildwithmanag/ownerrez-mcp(MIT 许可,以 LICENSE.upstream 形式包含)。本仓库中的 http_app.py 和部署文件是新增内容,使其可以作为托管、带认证的远程服务器运行,而不是本地 stdio 进程。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • Manage OwnerRez properties, bookings, guests, quotes and inquiries.

      https://ownerrez.usefulapi.io/mcp
    • Hostfully MCP server for ChatGPT, Claude and any AI agent: list reservations, get reservation, accept booking request, send guest message, read Central Calendar and list properties in your own Hostfully account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Hostfully yourself; Cotlet does not store your password and you need no Hostfully API key. About the official Hostfully API: Hostfully has an official REST API, the Open API v3, and no official MCP server (checked 31 Oct 2026). It is a paid add-on: you email api@hostfully.com with your use case, test in a sandbox, and only then get production access. Setup and FAQ: https://cotlet.dev/integrations/hostfully-api-mcp-server

    • Avantio MCP server for ChatGPT, Claude and any AI agent: list bookings, get booking, read calendar, update rates, send guest message and list tasks in your own Avantio account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Avantio yourself; Cotlet does not store your password and you need no Avantio API key. About the official Avantio API: Avantio has official APIs, a PMS API, a Web API and an Accounting API, and no official MCP server (checked 31 Oct 2026). The API is closed: documentation comes on request, and Avantio tests each connection with its technical team before it goes live. Setup and FAQ: https://cotlet.dev/integrations/avantio-api-mcp-server

      https://cotlet.dev/mcp/v1/avantio
    • Rent Manager MCP server for ChatGPT, Claude and any AI agent: post charge, create work order, message tenant and list tenants in your own Rent Manager account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Rent Manager yourself; Cotlet does not store your password and you need no Rent Manager API key. About the official Rent Manager API: Rent Manager has an API that reads and writes your database, but it is not self-serve (checked 11 Oct 2026). Its public pages offer no key signup: access goes through the Integrations Partner Program or an API support request, and a developer then builds the connector. Setup and FAQ: https://cotlet.dev/integrations/rent-manager-api-mcp-server

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables Claude to interact with your OwnerRez account via natural language, including booking inquiries, income summaries, property stats, and owner statements. Supports optional guest messaging with OAuth setup.
      21
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Connects OwnerRez property management data to MCP clients, enabling natural-language queries about bookings, check-ins, guest messaging, expenses, and webhooks.
      18
      MIT