把星巴克的咖啡服务，
接入每一个 AI 应用。
星巴克 MCP 开放平台基于 Model Context Protocol 标准， 将门店发现、商品与套餐、啡快到店自取 / 专星送外卖的算价下单、 订单管理与会员权益等能力以工具形式开放给智能体， 让你在熟悉的 AI 助手里，一句话就能找到附近的星巴克、点上心仪的那杯咖啡。
为 AI 准备好的咖啡能力
一次接入，AI 应用即可像门店伙伴一样，发现门店、解析菜单、下单取餐、管理订单与会员权益。
门店发现
按城市 / 经纬度 / 商品检索星巴克中国门店，返回门店编码、营业状态与支持的取餐方式。
商品与套餐
查询门店实时菜单、商品详情与可定制规格（口味、温度、奶等），并解析套餐结构 combo_group_info。
算价与下单
啡快到店自取（MOP）与专星送外卖（MOD）双链路算价→下单，temp_order_id 幂等回传。
订单管理
按状态分页查询订单、获取订单详情与取消未支付订单，覆盖会员的完整下单生命周期。
会员与权益
查询星享会员基础信息、星星与权益，列出可用优惠券，串起“懂会员”的对话体验。
标准与安全
标准 JSON-RPC 2.0 over HTTP，Bearer Token + 用户身份头双因子鉴权，支持私有化部署。
17 个面向咖啡场景的工具
每个工具都遵循 MCP Tool 规范，明确定义入参、出参与示例，覆盖门店发现、商品与套餐、算价下单、订单管理、会员权益与外送地址六大场景。完整列表请见工具文档。
门店搜索
按城市、地址、坐标或门店名称查找附近星巴克门店，支持网红打卡、星巴克臻选等门店标签筛选。
门店可售商品列表
获取指定门店当前可供点单的商品列表，后端已按渠道与上架状态过滤，结果均为有效可点单商品。
套餐详情
获取指定套餐的完整信息，包括各商品组的选品规则及每组内可选商品的完整规格和客制化选项。
啡快算价
用于 MOP 啡快到店自取场景的订单价格试算；返回 temp_order_id 与可用券提示，后续下单必须原样回传。
啡快创建订单
用于 MOP 啡快到店自取场景创建订单，必须基于 calculate_pickup_price 返回的 temp_order_id；返回 order_id、pre_payid、pay_url。
专星送创建订单
外卖场景创建订单使用，必须先通过 calculate_delivery_price 完成算价；地址字段必须来自 list_delivery_addresses。
订单详情
根据 order_id 查询订单状态、优惠明细、支付链接或取餐码；非本人查询会返回错误。
可用优惠券
查询用户可用券（合并 UPP 券与好礼券），仅返回 MCP 所需的券号、券名称和有效期结束时间。