用途:在无头店面与可组合商务应用中调用 Shopper Commerce API(SCAPI),构建商品、购物车、结账、客户与上下文流程。后端管理场景应使用 b2c-scapi-admin 技能。
主要能力与工具选择:当 B2C MCP 可用时,先通过 resources 或 skills_read 读取 skill://mcp/b2c-mcp-scapi/SKILL.md 一次,并传 skillRead: true。scapi_search 配合 authType: "shopper" 可离线发现内置契约,先定位 method/path/operationId,再查看输入、响应字段与安全设置;Admin 与 Shopper 混合操作可能出现在任一过滤结果中。scapi_execute 不支持 Shopper 执行,添加 SLAS 客户端也无法启用;店面流程应通过应用的 Shopper SDK/客户端配合相应 SLAS 令牌流执行。scapi_schemas_list 获取租户实时契约与自定义属性,scapi_custom_apis_get_status 检查自定义注册,代码模式不执行自定义 API。config_inspect 报告配置值并做掩码,docs_search/docs_read 解答平台语义、认证与限制。CLI 替代命令:b2c scapi schemas list、b2c scapi schemas get <family> <name> <version>、b2c setup inspect;这些 schema 命令使用实时 Schemas API,而 MCP 发现为离线。
集成要点:复用已配置的 shortCode、organizationId 与 siteId,不要自行编造标识符。Shopper 认证使用 SLAS 访客/注册流程与客户端作用域,Account Manager 凭据不能替代;私有客户端密钥与令牌交换应保留在后端。需发现所选 API 版本的契约,示例仅供参考,版本相关行为与限制以官方文档为准。保持购物车/订单状态并显式处理错误,对响应分页/过滤并只返回下一步操作所需字段。无头支付授权前,先查看 b2c-hooks 技能中的 order-PI 钩子(“Headless Order Payment”)与 b2c-ordering 技能中的订单生命周期,再选择放置流程。
条件参考:客户端示例(认证与 API 调用实现)、结账(购物车到订单工作流)、常见模式(错误、分页、字段选择)、作用域(按族的 Shopper 授权)、b2c-slas 技能(CLI 客户端管理)、b2c-slas-auth-patterns 技能(OTP、通行密钥、会话桥接)。官方文档:commerce-api/use-shopper-api、commerce-api/slas、commerce-api/work-with-baskets-orders、commerce-api/shopper-context-best-practices、commerce-api/auth-z-scope-catalog、commerce-api/performance。
限制:Shopper 执行不支持 scapi_execute;代码模式不执行自定义 API;具体版本行为与限制需查官方文档。