概览

​

1. 两种接入模式概览与核心区别

​

双模式核心差异对比

​

2. 模式一：跳转模式（只查，bookingUrl 承接下单）

​

交互特征

1. Agent 仅调用 getHotelSearchTags、searchHotels 与 getHotelDetail 3 个查询类 Tool；
2. Agent 不创建订单、不发起支付，能力止步于“搜索推荐 → 推送预订链接”；
3. 用户点击卡片中的 bookingUrl 跳转至 RollingGo H5 或小程序自行选房、填写个人信息并完成支付。

​

跳转模式交互时序图

​

3. 模式二：闭环模式（对话内全链路闭环）

​

交互特征

1. 完整使用全部 9 个 Tool，实现从信息检索、锁价下单到履约查单、售后退改的完整商业闭环；
2. 锁价防跳价：下单前通过 hotelPriceConfirm 锁定 30 分钟实时价格与房态，并返回智能预填常住旅客画像 guestProfile；
3. 安全收银台支付：生单后下发收银台链接（paymentUrl），用户点击即可完成支付，资金安全合规；
4. 全周期订单管理：用户可随时在对话中查询订单列表（searchHotelOrders）及获取多维结构化详情凭证（getHotelOrderDetail）；
5. 两阶段安全取消机制（Quote-Execute）：新增 preCancelHotelBooking 预取消试算罚金（派发 10 分钟时效凭证 confirmId），用户确认后调用 confirmCancelHotelBooking 执行最终不可逆取消。仅免费取消支持在线闭环，产生罚金或不可退订单自动转接客服。

​

闭环模式交互时序图

​

4. 账号开通与凭证获取渠道

​

途径一：开放平台自主申请（线上即时开通）

• 🇨🇳 国内站（中文）：https://partner.rollinggo.cn
• 🌐 国际站（英文）：https://partner.rollinggo.ai

​

途径二：商务与企业定制账户

• 适用对象：商务签约合作伙伴、企业定制客户、特约开发者。
• 开通方式：由 RollingGo 运营团队在管理后台直接开通账号，并通过安全渠道线下直接交付：
  • API Key 模式交付物：专属 API Key（格式如 mcp_xxxxx）及对应服务节点端点；
  • OAuth 2.1 模式交付物：clientId、clientSecret 及预注册回调地址配置。
• 快速指引：已由运营人员直接提供凭证的客户，无需在开放平台重复注册，直接查阅 5. 服务节点与接入端点 与 6. Agent 客户端配置示例 即可快速上线。

​

凭证鉴权模式说明

​

1. API Key 模式（推荐 · 快速接入）

• 适用场景：开发者工具、Claude CLI / Desktop、企业自建 Agent、自动化工作流。
• 请求鉴权：HTTP 请求头携带 Authorization: Bearer <API_KEY>。

​

2. OAuth 2.1 模式（终端用户授权）

• 适用场景：面向 C 端公众用户的客户端 App、Web 应用、多租户 SaaS 平台。
• 配置要点：需配置 PKCE 回调地址（Web 端 redirect_uri 或 本地客户端环回端口 callbackPort）。
• 请求鉴权：标准 OAuth 2.1 授权码流程获取用户级 Access Token 并在请求头中携带。

​

5. 服务节点与接入端点

​

6. Agent 客户端配置示例

​

6.1 API Key 模式配置（以 Claude Desktop / Claude CLI 为例）

{
  "mcpServers": {
    "rollinggo-hotel": {
      "type": "http",
      // 国内节点使用 https://mcp.rollinggo.cn/mcp，国际节点使用 https://mcp.rollinggo.ai/mcp
      "url": "https://mcp.rollinggo.ai/mcp",
      "headers": {
        "Authorization": "Bearer mcp_your_api_key_here"
      }
    }
  }
}

claude mcp add \
  --transport http \
  --header "Authorization: Bearer mcp_your_api_key_here" \
  RollingGo-Hotel \
  https://mcp.rollinggo.ai/mcp

​

6.2 OAuth 模式配置（以 Claude Code / Web 客户端为例）

{
  "mcpServers": {
    "rollinggo-hotel": {
      "type": "http",
      "url": "https://mcp.rollinggo.cn/mcp/hotel",
      "oauth": {
        "clientId": "your-client-id",
        // 本地客户端使用环回端口，Web 客户端配置完整 redirect_uri
        "callbackPort": 55082
      }
    }
  }
}