PuppyIP 资源中心
跨境电商开发 7 分钟 发布于 2026-10-17

Shopify MCP 接入 UCP 买家同意:没传选择会怎样?

从 2026-08-25 版 UCP 起,协商买家同意扩展的 Shopify Checkout MCP 与 Cart MCP 可交换店铺用途说明和买家选择。若 Agent 不发送选择,Shopify 会按买家国家使用店铺默认值;国家未知时默认退出。

Shopify UCP Checkout MCP Cart MCP 买家同意

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 扩展名为 dev.ucp.shopping.buyer_consent,适用于协商了该扩展的 Checkout MCP / Cart MCP Agent。
  • 未提交选择时,使用买家国家对应的店铺默认值;国家未知则默认 opt-out。
  • 只把买家在流程中实际作出的选择标记为 source platform,缺少必填细节时处理 missing_consent_data。

这次 Shopify 更新影响哪些接入?

Shopify 在 2026 年 10 月 16 日说明,Checkout MCP 与 Cart MCP 已支持 UCP 买家同意扩展,最低从 UCP 版本 2026-08-25 起提供。它面向会发现并协商该扩展的购物 Agent,不代表所有旧 MCP 集成自动改变。

店铺可通过 /.well-known/ucp 公布扩展。协商成功后,Agent 与店铺可以围绕分析、偏好、出售或共享、营销等用途交换选项;具体说明和政策链接来自店铺。

买家没有点选时,Shopify 怎样处理?

如果 Agent 没有提交买家选择,Shopify 会按买家所在国家应用该店铺的默认值。若买家国家未知,默认处理为 opt-out。不要把没有传字段当成买家同意。

买家同意对象也可能列出继续结账前必须补充的信息。例如,短信营销选择缺少电话号码时,响应可能包含 missing_consent_data 警告,结账在补齐所需信息前不能完成。

Agent 收到什么,应该展示什么?

当 Agent profile 协商了 dev.ucp.shopping.buyer_consent,购物响应会包含 buyer.consent 对象,列出店铺支持的用途、当前状态、用途说明和店铺政策链接。应把这些内容呈现给买家,让选择发生在清楚的语境里。

如果买家尚未选择,保留未选择状态;不要将默认值改写成买家主动同意。若流程需要邮箱、手机号等具体资料,先说明用途并收集必要信息,再提交实际选择。

在 Cart 和 Checkout 请求中怎样传回选择?

Shopify 支持在 Cart 或 Checkout 的创建、更新和完成请求中提交买家选择。接入方应先声明并协商支持的 UCP 扩展版本,再在界面显示店铺提供的用途说明与政策链接。

只有买家确实在你的界面作出选择时,才将 source 字段设为 platform。请求后检查响应警告;若返回 missing_consent_data,补上缺少信息再继续结账。

上线前用一笔测试购物车核对边界

用测试商品检查:扩展协商后是否收到 buyer.consent;买家已选择与未选择时请求字段是否不同;未知国家是否按 opt-out 处理;需要额外资料的用途是否返回可读警告。

这项协议支持 Agent 与店铺交换选择及所需数据,不会替接入方决定应展示哪些选项,也不应被理解为自动满足所有地区的隐私或营销要求。实际展示与处理仍须遵循店铺政策和适用规则。

资料来源

常见问题

所有使用 Shopify MCP 的购物 Agent 都会受这次更新影响吗?

不会自动影响所有旧接入。此次支持针对使用 UCP 2026-08-25 的 Checkout MCP 或 Cart MCP,且 Agent profile 协商了买家同意扩展的流程。

Agent 没有提交 buyer.consent 选择时,会被当成同意吗?

不会。Shopify 会按买家国家应用店铺默认值;买家国家未知时默认 opt-out。

missing_consent_data 会阻止结账吗?

如果某项选择需要额外信息而响应给出 missing_consent_data,结账会在补足必需信息之前无法完成。具体缺什么应以响应说明为准。

什么时候可以将 source 字段设为 platform?

只有买家确实在购物流程界面作出了该选择时才这样标记;不能把未选择或系统默认值冒充买家主动选择。