认证与排查

401 Unauthorized

请求没有 Storefront 登录态，也没有有效的用户 Bearer token。重新登录或刷新用户 token；不要把服务端共享 token 放进浏览器请求。

400 Bad Request

请求体不是合法 JSON-RPC，或者 tools/call 缺少工具名、必需参数或参数类型不正确。先调用 tools/list，按返回的 JSON Schema 组装参数。

404 Not Found

检查路径是否为 /api/mcp，并确认请求发送到了 Storefront，而不是 Saleor GraphQL API 或容器内部地址。

桥接器重启后离线

公网部署时用同一个 HTTPS 根地址配置 SALEOR_STOREFRONT_URL 和桥接器的 MRO_AGENT_URL。中心服务返回 401、403 或 404 时，桥接器应重新注册设备并覆盖本地状态。

MCP 返回的商品资料必须保留 Saleor ID、查询版本、来源和 pending-engineering-review 状态。规则检查通过不等于工程责任结论，关键尺寸、接口和安全结论仍需人工签核。