OwnerRez MCP 连接器（托管版）

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

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

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

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

创建预订和屏蔽日期只存在于 OwnerRez 独立的 Channel API 中，该 API 专供经批准的 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 之前重新调整过这个菜单）。生成一个令牌；你会得到一个用户名和一个令牌值。请将两者都保存好——你需要把它们粘贴到托管平台的环境变量中，切勿粘贴到浏览器或聊天中。

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 进程。