Ucp Checkout Mcp — Ucp 结账 Mcp

UCP Checkout — MCP 绑定 在编写代码之前 获取实时规范：在 Web 上搜索 site:ucp.dev specification checkout-mcp 并获取页面以获取工具定义、JSON-RPC 封装格式和 _meta 要求的详细信息。 对于 Shopify 的生产 MCP 服务器，请获取 https://shopify.dev/docs/agents/checkout/mcp 以获取认证流程和端点详细信息。

概念架构 MCP 如何映射到 UCP UCP 在 MCP 上是一个 1:1 的映射，使用 JSON-RPC 2.0 将结账操作映射到 MCP 工具。 与 REST 相同的数据模型，不同的封装。

五个 MCP 工具 MCP 工具名称 映射到 键入数据 create_checkout POST /checkout-sessions 结账对象 + idempotency_key get_checkout GET /checkout-sessions/{id} id update_checkout PUT /checkout-sessions/{id} id + 结账对象 complete_checkout POST .../complete id + payment_data + idempotency_key cancel_checkout POST .../cancel id + idempotency_key

元要求 每个 MCP 工具调用必须包含 _meta.ucp.profile，指向平台的 UCP 配置文件 URI。 这取代了 UCP-Agent HTTP 标头从 REST 绑定。

错误映射 UCP 错误嵌入在 JSON-RPC 2.0 错误响应中： JSON-RPC error.code：-32603（内部错误） JSON-RPC error.data：包含一个 errors[] 数组，每个错误都有 code、message、severity 和 details 字段

何时使用 MCP 绑定 您正在构建一个商家 MCP 服务器，AI 代理（Claude、Gemini 等）通过工具使用调用 您正在与现有的 MCP 服务器（例如 Shopify 的）集成 您希望 AI 代理自主浏览和购买，而无需 REST 客户端代码

实现指南 构建商业 MCP 服务器： 使用您的 MCP 框架（例如 @modelcontextprotocol/sdk for Node，mcp for Python）实现 5 个工具 从每个工具调用中提取 _meta.ucp.profile 以进行协商 以 JSON 格式返回结账对象作为 MCP 工具结果 使用 JSON-RPC 错误格式和 UCP 数据有效载荷返回错误 在 create 和 complete 工具上实现幂等性

连接到现有的 MCP 服务器（例如 Shopify）： 认证（Shopify 使用 OAuth2 client_credentials 获取访问令牌） 连接到 MCP 端点 使用正确的 _meta.ucp.profile 和结账有效载荷调用工具 解析工具结果以获取结账状态和消息

Shopify MCP 集成 Shopify 为 UCP 结账提供了一个生产 MCP 服务器。 在实施之前： 获取 https://shopify.dev/docs/agents/checkout/mcp 以获取最新的认证流程、端点 URL 格式和错误代码 认证使用 POST https://api.shopify.com/auth/access_token 以客户端凭据 MCP 端点是 POST https://{shop-domain}/api/ucp/mcp