Bitvoya MCP

AI 旅行エージェント向けの高級ホテル情報と安全なチェックアウト引き継ぎ。

高級ホテルの検索、特典が充実した料金の比較、見積もりの準備、Bitvoya が管理するチェックアウトの完了に対応した、ホスト型の公開 MCP です。

クイックスタート · クライアントのセットアップ · セキュリティモデル · 安全な引き継ぎ · server.json

一般ユーザーは、Dashboard -> Connect Agent から取得した Bitvoya 発行のエージェントキーを使い、ホスト型エンドポイント https://bitvoya.com/api/mcp に接続します。通常の利用ではセルフホストは不要です。

Bitvoya MCP を選ぶ理由

Bitvoya は、汎用ホテルフィードを MCP でラップしたものではありません。高級ホテルの予約価値と、実際の旅行エージェントが必要とする引き継ぎの境界を中心に設計されています。

Bitvoya の強み	エージェントにとって重要な理由
高級ホテルを優先した掲載内容	ハイエンドな旅行計画、コンシェルジュ、会員向け旅行のワークフローに適しています
特典やプロモーションを構造化して提供	エージェントは文章をスクレイピングせずに、朝食、アップグレードの適用条件、レイトチェックアウト、施設クレジットについて説明できます
明確な料金体系	supplier_total_cny、service_fee_cny、display_total_cny はそれぞれ区別されています
安全なチェックアウトの引き継ぎ	カード情報の入力と決済はエージェントとのチャットではなく、Bitvoya が管理する画面で行われます
ホスト型のリモート MCP	ユーザーはベアラー認証を使い、Streamable HTTP 経由で直接接続できます

対象ユーザー

• AI 旅行アシスタント
• コンシェルジュおよび旅程作成エージェント
• プレミアム会員向けの旅行コパイロット
• Bitvoya に接続するパートナーエージェント
• 滞在の質、特典、実際の予約価値を重視するワークフロー

クイックスタート

1. エージェントキーを作成する

1. https://bitvoya.com にサインインします
2. Dashboard -> Connect Agent を開きます
3. 名前を付けたエージェント接続を作成します

直接アクセスできるページ：

• https://bitvoya.com/dashboard/agent-keys

2. ホスト型 MCP に接続する

ホスト型エンドポイントを使用します：

• https://bitvoya.com/api/mcp

次のヘッダーを追加します：

• Authorization: Bearer <your_agent_key>

リモート MCP の最小構成：

{
  "type": "streamable_http",
  "url": "https://bitvoya.com/api/mcp",
  "headers": {
    "Authorization": "Bearer <your_agent_key>"
  }
}

MCP クライアント以外で手動テストする場合は、次も送信してください：

• Accept: application/json, text/event-stream

3. ツールを使った旅行プロンプトから始める

例：

• 来週末の東京の高級ホテルを検索して、最適な候補を比較してください。
• パリで朝食付きの五つ星ホテルを探し、最もお得な料金を説明してください。
• シンガポールで最も有力なシャングリ・ラの候補について、予約見積もりを準備してください。

推奨モデル

Bitvoya は、ツール選択、状態を保持する予約フロー、そして過去の知識からホテルの詳細を幻覚しないことに長けたモデルで最も効果を発揮します。

• Claude 4.6、GPT-5.4、または同等の最上位の推論モデルを推奨します
• これらのモデルは、見積もり、意図、状態確認の各ステップをより確実に実行します
• 小規模なモデルでも接続できますが、ツールを省略したり、料金の意味を曖昧にしたりする可能性が高くなります
• 自動ツール選択が不得意なモデルの場合、汎用的な最初の呼び出しに最も安全なツールは start_travel_planning です
• リクエストがすでに明確に現在のホテル検索である場合は、ホテルに特化した最短経路として start_hotel_search を引き続き利用できます

対応クライアントのセットアップ

クライアント別のセットアップガイドは docs/public/CLIENT_SETUP.md にあります。

クライアント	リモート MCP	備考
Cherry Studio	はい	ラップされたインポート形式を使用し、Authorization ヘッダーを手動で入力します
Cursor	はい	mcp.json と環境変数を利用したベアラー認証に対応しています
Windsurf	はい	カスタムヘッダーを使用したリモート Streamable HTTP に対応しています
Claude Code	はい	claude mcp add --transport http を使用します
GitHub Copilot CLI	はい	リモート HTTP MCP として設定します
Goose	はい	リモート MCP エンドポイントとベアラーヘッダーを使用します

エージェントにできること

Bitvoya MCP は、ホテルの検索、比較、見積もりの準備、安全な完了手続きへの引き継ぎを目的に設計されています。

ワークフロー	主なツール
汎用的な最初のステップでのルーティング	start_travel_planning
都市とホテルの検索	start_hotel_search、search_hotels、compare_hotels
ホテルの詳細と客室・料金の調査	get_hotel_detail、get_hotel_rooms、compare_rates
予約の概要の開始	create_booking
予約見積もりの準備	prepare_booking_quote
予約意図の作成	create_booking_intent
注文と引き継ぎ状態の確認	get_booking_state

ラグジュアリーな滞在の価値

Bitvoya は、目に見える最安料金だけでなく、上質な滞在の価値を重視する旅行者にとって、特に強みを発揮します。

• 提携料金には、朝食、アップグレードの機会、アーリーチェックイン、レイトチェックアウト、USD 100 の施設内クレジットなどが含まれる場合があります
• 3泊で2泊分の料金 や 4泊で3泊分の料金 などの連泊プロモーションにより、実質的な価値が大きく変わる場合があります
• 特典とプロモーションは構造化された出力として返されるため、エージェントはマーケティング文言から推測せず、実際の予約内容を比較できます

特典を利用できるかどうかは、ホテル、料金、市場、宿泊日により異なります。返されたホテルと料金のペイロードは、常に正確な情報源として扱ってください。

予約の流れ

Bitvoya は、機密性の高い手続きを Bitvoya がホストする画面に意図的に限定しています。

1. エージェントがホテル、客室、料金を検索します。
2. エージェントが予約見積もりを準備し、予約意図を作成します。
3. 旅行者が Bitvoya のホストする安全なチェックアウト画面に引き継がれます。
4. エージェントは get_booking_state を使って状態の確認を続けます。

公開エージェントは、以下を直接扱いません。

• カード情報の直接入力
• 決済処理
• 予約の最終的なサプライヤーへの送信

この境界は意図的に設けられています。これにより、決済リスクやカード情報の取り扱いをサードパーティーのチャットツールに持ち込むことなく、公開 MCP の利便性を維持できます。

料金フィールド

エージェントは、料金を慎重に提示してください。

• 検索段階の出力には、参考となる検索用料金として supplier_min_price_cny が含まれる場合があります
• 最終的な客室と料金の評価には get_hotel_rooms を使用します
• get_hotel_rooms は以下を返します。
  • supplier_total_cny
  • service_fee_cny
  • display_total_cny
• display_total_cny は、現在の Bitvoya の製品動作に沿った、宿泊者向けの合計金額です

ドキュメントハブ

• クライアントのセットアップ：docs/public/CLIENT_SETUP.md
• よくある質問：docs/public/FAQ.md
• セキュリティモデル：docs/public/SECURITY_MODEL.md
• セキュアな引き継ぎの設計：docs/public/SECURE_HANDOFF.md
• リリースノート：docs/public/releases/v0.3.1.md
• レジストリのメタデータ：server.json
• メンテナー向けセットアップ：DEVELOPMENT.md

ライセンス

このリポジトリは Apache-2.0 ライセンスで提供されています。LICENSE と NOTICE を参照してください。

オープンソースライセンスの対象は、このリポジトリのコードとドキュメントです。以下へのアクセス権は付与されません。

• Bitvoya のホスト型本番インフラストラクチャ
• ライブのホテル在庫およびパートナーのデータフィード
• Bitvoya が発行するエージェントキーまたはユーザーアカウント
• 通常の製品利用規約の範囲外での Bitvoya の商標、ブランド資産、またはサービスへのアクセス

重要な注意事項

• Bitvoya はこのフローを Connect Agent と呼びます
• 生成される認証情報は、取り消し可能なエージェントキーです
• ウェブサイトのログイン認証情報と MCP の認証情報は、意図的に別々にされています
• 1 人の Bitvoya ユーザーが複数のエージェントキーを持っていても、それらは同じ Bitvoya アカウントの履歴に紐づきます
• 通常のユーザーはホスト型 MCP に接続するため、データベースやサーバーを直接設定する必要はありません