OwnerRez MCP connector (hosted)

OwnerRez アカウントの予約、物件、ゲスト、財務情報（見積もり、支払い、返金、手数料）、ゲストメッセージを読み取って操作するためのツールを Claude に提供する、リモート MCP サーバーです。

これはオープンソースの ownerrez-mcp プロジェクト（MIT ライセンス）をベースに構築されています。このリポジトリは、その周囲に Streamable HTTP トランスポートとベアラートークンによるゲートを追加し、ローカルでのみ実行するのではなく、パブリック Web サービスとして実行して Claude にカスタムコネクタとして追加できるようにするものです。

最初に読んでください：できることとできないこと

OwnerRez のアカウントレベル API（「API for Apps」、個人用トークンを取得するタイプの API）は読み取り＋メッセージ送信であり、完全な読み書き対応の予約 API ではありません。

予約の作成と日付のブロックは、OwnerRez の別途用意されたChannel API でのみ可能です。これは承認済みの OTA／チャネルパートナー連携（Airbnb、Vrbo など）専用であり、ご自身のアカウントの API トークンでは利用できません。したがって、「この日付をブロックする」「この予約を作成する」といった操作は、このコネクタや、個人の OwnerRez 認証情報を使用するツールでは現時点では実行できません。日付をプログラムでブロックする必要がある場合、現実的な選択肢は、OwnerRez のカレンダー UI か、（すでに PriceLabs を接続しているため）OwnerRez に同期される PriceLabs の日付上書きツールです。

左の列の機能はすべて実際に動作し、このサーバーで利用できます。

Related MCP server: Hospitable MCP Server

1. OwnerRez の Personal Access Token を取得する

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 のままにし、ゲストメッセージの送信と Webhook 管理を許可するにはクリアします（上記の表を参照。OwnerRez の API には存在しないため、これによって予約や日付の書き込みが有効になることはありません）

4. デプロイします。Render から https://ownerrez-mcp.onrender.com のような URL が発行されます。コネクタの URL は、この URL の末尾に /mcp/ を付けたものです。例：https://ownerrez-mcp.onrender.com/mcp/。

オプション B — 任意の Docker ホスト（Railway、Fly.io、独自 VM）

同梱の 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. 認証タイプ：request headers（静的ヘッダー／API キー認証）を選択します。次のように入力します：

   • Header name：Authorization

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

4. 保存します。Claude はサーバーへのすべての呼び出しでそのヘッダーを送信し、http_app.py のミドルウェアが OwnerRez にアクセスする前にそれをチェックします。

お使いの Claude プランでカスタムコネクタ向けのヘッダーベース認証がまだ利用できない場合（ベータ版です）、フォールバックとしてサーバーを非公開にしておきます（URL を共有しないでください）。トークンを持たないユーザーはすべてのリクエストで 401 を受け取るため、コネクタレベルの認証を設定していなくても公開状態にはなりません。

セキュリティに関する注意

• ベアラートークンはアカウント全体の OwnerRez データへのアクセスを制御します。パスワードと同じように扱ってください。漏えいが疑われる場合は、新しい MCP_ACCESS_TOKEN で再生成して再デプロイし、ローテーションしてください。

• OWNERREZ_READ_ONLY=1 はより安全なデフォルトです。Claude があなたに代わってゲストメッセージを送信したり、Webhook サブスクリプションを管理したりできるようにしたい場合のみ、クリアしてください。

• ここで説明した機能では、予約の作成・変更・キャンセルや価格への変更はできません。これはこのサーバーの制限ではなく、OwnerRez のアカウント API が公開していない範囲です。

クレジット

ツール定義、OwnerRez API クライアント、リトライ／バックオフ、読み取り専用ガードロジックは、buildwithmanag/ownerrez-mcp（MIT ライセンス、LICENSE.upstream として同梱）からのものです。このリポジトリの http_app.py とデプロイ用ファイルは、ローカルの stdio プロセスではなく、ホスト型で認証付きのリモートサーバーとして実行するための追加部分です。