通过 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。

工具选择约定

协议发现

支持 OAuth 发现的 MCP 客户端可以先读取 protected resource metadata:

GET /.well-known/oauth-protected-resource/services/mcp

授权服务器 metadata 位于授权服务器域名的:

GET /.well-known/oauth-authorization-server

具体授权流程见 OAuth 授权。