通过 MCP 集成
YSystem 提供标准的 MCP Streamable HTTP 服务,入口为:
POST /services/mcp
客户端通过 OAuth 2.1 获取 access token 后,将其放入请求头:
Authorization: Bearer <access-token>
Content-Type: application/json
服务端根据 access token 的 scope 确定当前会话可见的工具列表。未授权工具不会出现在 tools/list 响应中。
公开工具
| 工具 | OAuth scope | 用途 |
|---|---|---|
hotel_meta_search |
mcp:hotel.meta.search |
无需入住日期,查询酒店基础资料,不含实时价格和房态 |
hotel_search |
mcp:hotel.search |
查询酒店搜索结果 |
hotel_rates |
mcp:hotel.rates |
查询酒店房型和价格方案 |
hotel_rateRule |
mcp:hotel.rate-rule |
查询价格方案及规则 |
order_search |
mcp:order.search |
查询订单明细 |
已有令牌需要重新授权 mcp:hotel.meta.search,新工具才会出现在 tools/list 中。
统计、汇总和趋势分析工具属于受控能力,不在公开工具清单中;如需使用,请联系平台为账号开通对应 capability。
工具选择约定
hotel_meta_search用于无入住日期的酒店资料搜索;需要实时价格时使用hotel_search。hotel_rates、hotel_rateRule和order_search用于查询具体明细。- 统计、汇总、趋势和对比问题应使用平台开通的分析工具,不要在明细结果上自行汇总。
- MCP 会话绑定 OAuth token 中的用户和渠道。请求中的渠道 header 不会改变这一绑定关系。
协议发现
支持 OAuth 发现的 MCP 客户端可以先读取 protected resource metadata:
GET /.well-known/oauth-protected-resource/services/mcp
授权服务器 metadata 位于授权服务器域名的:
GET /.well-known/oauth-authorization-server
具体授权流程见 OAuth 授权。