Bitvoya MCP

为 AI 旅行 Agent 提供奢华酒店信息和安全结账交接。

提供托管的公共 MCP，支持高端酒店搜索、丰富礼遇的房价比较、报价准备，以及由 Bitvoya 控制的结账流程。

快速入门 · 客户端设置 · 安全模型 · 安全交接 · server.json

普通用户使用 Bitvoya 签发的 Agent 密钥连接托管端点 https://bitvoya.com/api/mcp，可在 Dashboard -> Connect Agent 中获取。正常使用无需自行托管。

Bitvoya MCP 的优势

Bitvoya 并非只是套上 MCP 的通用酒店信息源，而是围绕奢华住宿的预订价值，以及真实旅行 Agent 所需的交接边界而设计。

Bitvoya 的优势	对 Agent 的意义
优先覆盖奢华酒店	更适合高端行程规划、礼宾服务和会员旅行流程
结构化礼遇和促销信息	Agent 无需抓取散文式介绍，就能说明早餐、升级资格、延迟退房和酒店消费额度
明确的价格语义	supplier_total_cny、service_fee_cny 和 display_total_cny 各自独立
安全结账交接	信用卡信息填写和付款均在 Bitvoya 自有页面完成，而非通过 Agent 聊天进行
托管的远程 MCP	用户通过可流式传输的 HTTP 和 Bearer 身份验证直接连接

适用对象

• AI 旅行助手
• 礼宾和行程规划 Agent
• 高端会员旅行副驾
• 接入 Bitvoya 的合作伙伴 Agent
• 注重住宿品质、礼遇和实际预订价值的工作流

快速入门

1. 创建 Agent 密钥

1. 登录 https://bitvoya.com
2. 打开 Dashboard -> Connect Agent
3. 创建一个命名的 Agent 连接

直达页面：

• 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 和基于环境变量的 bearer 身份验证
Windsurf	是	使用带有自定义请求头的远程 Streamable HTTP
Claude Code	是	使用 claude mcp add --transport http
GitHub Copilot CLI	是	配置为远程 HTTP MCP
Goose	是	使用远程 MCP 端点和 bearer 请求头

Agent 可以做什么

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 的酒店消费额度
• stay 3 pay 2 和 stay 4 pay 3 等长住促销活动可能显著改变实际价值
• 优惠和促销信息会以结构化输出形式返回，因此 Agent 可以比较实际预订品质，而不是根据营销文案猜测

优惠是否可用仍取决于酒店、房价、市场和入住日期。返回的酒店和房价数据应始终视为准确信息来源。

预订流程

Bitvoya 有意将敏感操作保留在 Bitvoya 托管的界面中。

1. Agent 发现酒店、客房和房价。
2. Agent 准备预订报价并创建预订意图。
3. 旅客被转至 Bitvoya 托管的安全结账界面。
4. Agent 继续使用 get_booking_state 轮询状态。

公共 Agent 不会直接处理：

• 原始银行卡信息录入
• 支付操作
• 最终面向供应商的预订提交

这是有意设定的边界。这样既能让公共 MCP 保持实用，也能避免将支付风险或银行卡处理交给第三方聊天工具。

价格字段

Agent 应谨慎呈现价格信息。

• 搜索阶段的输出可能包含 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 签发的 Agent 密钥或用户帐户
• Bitvoya 商标、品牌资产，或正常产品条款之外的服务访问权限

重要说明

• Bitvoya 将此流程称为 Connect Agent
• 生成的凭据是可撤销的 Agent 密钥
• 网站登录凭据与 MCP 凭据有意设置为不同凭据
• 同一 Bitvoya 用户下的多个 Agent 密钥仍映射到同一 Bitvoya 帐户历史记录
• 普通用户连接到托管的 MCP，无需直接配置数据库或服务器