コネクタガイド

Meliorra Connector Guide

Meliorra は、Claude などの AI アシスタントに話しかけるだけで、日本の旅館・ホテルを検索し、宿へ直接予約リクエストを送れる MCP コネクタです。決済はコネクタ上では行われず、予約成立後に宿の案内に従ってお支払いいただきます。

Meliorra is an MCP connector that lets you search Japanese ryokan and hotels and send booking requests directly to the property — just by talking to your AI assistant. No payment is processed through the connector.

接続方法 Setup

Claude の 設定 → コネクタ →「カスタムコネクタを追加」 を開きます。
Open Claude → Settings → Connectors → "Add custom connector".
次の URL を入力して追加します。 Enter this URL: https://mcp.meliorra.co/mcp
検索・空室確認はそのまま使えます。予約リクエストを送るときに OAuth の認可画面が開くので、メールアドレスを入力し、届いた 6 桁の確認コードを入力してください。
Search works right away. The first time you send a booking request, an OAuth screen opens — enter your email and the 6-digit verification code we send you.

必要なもの: メールアドレスのみ。事前のアカウント登録は不要です。 All you need is an email address — no account registration required.

使い方の例 Example prompts

「箱根で記念日向けの最高級旅館を探して。2 名で 1 泊 8 万円まで」

→ search_hotels が推薦理由つきで候補を返します。 / Returns ranked properties with reasons.

「1 番目の宿、来月の第 2 土曜から 1 泊 2 名で空室ある？」

→ search_availability が客室タイプ別の空室と料金を返します。 / Room-type availability and total price.

「その部屋で予約リクエストを送って。誕生日のサプライズでケーキをお願いしたい」

→ create_booking_request が宿へリクエストを送信（初回は OAuth ログイン）。宿が承認するとメールで通知されます。 / Sends the request to the hotel; you're notified by email when the hotel approves.

「さっきの予約リクエスト、いまどうなってる？」

→ get_booking_status / list_my_bookings で進捗を確認できます。 / Check the status of your requests.

ツール一覧 Tools

`search_hotels`READ	希望条件（自然言語）に合う宿を検索し、推薦理由つきで返す。まだ提携していない宿は「未提携」と明示し、公式サイトを案内します（Meliorra からは予約できません）
`get_hotel_profile`READ	宿の詳細プロフィール（宿承認済みの構造化情報）。宿が設定した会員特典（ランク別）も返します
`search_availability`READ	指定日・人数の空室と料金（客室タイプ別）。お子様の人数（小学生 / 幼児 / 添い寝）を渡すと、宿が設定した子ども料金・税・サービス料の内訳つきで見積もります。キャンセルポリシーと、キャンセル料の見込み（いつまで無料か・料率が変わる日と金額）も返します。Meliorra はキャンセル料を徴収しません（精算は宿と直接）
`create_booking_request`OAUTH	宿へ予約リクエストを送信。宿が承認すると予約成立。お名前と、メールか電話のどちらかが必要です。お支払いは宿で直接（Meliorra 上での決済はありません）
`get_booking_status`READOAUTH	予約リクエストの現在ステータス
`cancel_booking_request`OAUTH	予約リクエストのキャンセル
`list_my_bookings`READOAUTH	自分の予約リクエスト一覧と、Meliorra の会員ランク（直近 24 か月の宿泊完了回数で決まり、宿ごとの特典が受けられます）
`get_operation_metrics`READOAUTH	宿向け。AI 直販の成績（回収額・OTA 手数料削減額・取りこぼし）を月次で返す

トラブルシュート Troubleshooting

予約ツールだけ失敗する — OAuth 接続が切れています。コネクタの設定から再接続（再ログイン）してください。
Booking tools fail while search works: your OAuth session expired — reconnect the connector.
確認コードのメールが届かない — 迷惑メールフォルダをご確認ください。差出人は notifications@meliorra.co です。コードの有効期限は 10 分です。
No verification email: check spam for notifications@meliorra.co; codes expire in 10 minutes.
空室が見つからない — 日付を変えてお試しください。一部の宿は実在庫連携のため直前日程が満室になりやすくなっています。
No availability: try different dates — some properties sync live inventory.
「未提携」の宿を予約したい — 未提携の宿は Meliorra から予約できません。表示される公式サイトから直接ご予約ください。
Properties marked "unclaimed" can't be booked through Meliorra — use the official website shown in the result.
新しい入力（お子様の人数など）が使えない — コネクタを一度削除して追加し直すと、最新のツール定義が読み込まれます。
New inputs (e.g. children) missing: remove and re-add the connector to refresh the tool definitions.
接続状態を確認したい — https://mcp.meliorra.co/mcp/health でサーバー状態を確認できます。
Server status is available at the health endpoint.

サポート Support

Meliorra サポート / Meliorra Support
support@meliorra.co
通常 2 営業日以内に返信します。 / We usually reply within two business days.