← 返回
未分类 Key

Ucp Checkout Mcp

Implement UCP Checkout over the MCP (Model Context Protocol) binding — expose checkout operations as MCP tools for AI agents. Use when building an MCP server...
通过MCP(模型上下文协议)绑定实现UCP结账功能,将结账操作暴露为MCP工具供AI代理调用。适用于构建MCP服务器场景。
ichiorca ichiorca 来源
未分类 clawhub v1.0.0 1 版本 100000 Key: 需要
★ 0
Stars
📥 237
下载
💾 0
安装
1
版本
#latest

概述

UCP Checkout — MCP Binding

Before writing code

Fetch live spec: Web-search site:ucp.dev specification checkout-mcp and fetch the page for exact tool definitions, JSON-RPC envelope format, and _meta requirements.

For Shopify's production MCP server, fetch https://shopify.dev/docs/agents/checkout/mcp for auth flow and endpoint details.

Conceptual Architecture

How MCP Maps to UCP

UCP over MCP is a 1:1 mapping of checkout operations to MCP tools using JSON-RPC 2.0. The same data model as REST, different envelope.

Five MCP Tools

MCP Tool NameMaps ToKey Inputs
------------------------------------
create_checkoutPOST /checkout-sessionscheckout object + idempotency_key
get_checkoutGET /checkout-sessions/{id}id
update_checkoutPUT /checkout-sessions/{id}id + checkout object
complete_checkoutPOST .../completeid + payment_data + idempotency_key
cancel_checkoutPOST .../cancelid + idempotency_key

Meta Requirements

Every MCP tool call MUST include _meta.ucp.profile pointing to the platform's UCP profile URI. This replaces the UCP-Agent HTTP header from the REST binding.

Error Mapping

UCP errors embed inside JSON-RPC 2.0 error responses:

  • JSON-RPC error.code: -32603 (Internal Error)
  • JSON-RPC error.data: Contains an errors[] array, where each error has code, message, severity, and details fields

When to Use MCP Binding

  • You're building a merchant MCP server that AI agents (Claude, Gemini, etc.) call via tool use
  • You're integrating with an existing MCP server (e.g., Shopify's)
  • You want AI agents to autonomously browse and purchase without REST client code

Implementation Guidance

Building a Business MCP Server:

  1. Implement the 5 tools using your MCP framework (e.g., @modelcontextprotocol/sdk for Node, mcp for Python)
  2. Extract _meta.ucp.profile from every tool call for negotiation
  3. Return checkout objects as JSON in the MCP tool result
  4. Return errors using JSON-RPC error format with UCP data payload
  5. Implement idempotency on create and complete tools

Connecting to an existing MCP server (e.g., Shopify):

  1. Authenticate (Shopify uses OAuth2 client_credentials for access tokens)
  2. Connect to the MCP endpoint
  3. Call tools with proper _meta.ucp.profile and checkout payloads
  4. Parse tool results for checkout status and messages

Shopify MCP Integration

Shopify provides a production MCP server for UCP checkout. Before implementing:

  • Fetch https://shopify.dev/docs/agents/checkout/mcp for the latest auth flow, endpoint URL format, and error codes
  • Authentication uses POST https://api.shopify.com/auth/access_token with client credentials
  • MCP endpoint is POST https://{shop-domain}/api/ucp/mcp

版本历史

共 1 个版本

  • v1.0.0 当前
    2026-05-21 14:59 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

ai-agent

Agent Browser

rez0
用于 AI 代理的浏览器自动化 CLI。当用户需要与网站交互(包括浏览页面、填写表单、点击按钮、截图等)时使用。
★ 844 📥 325,122
ai-agent

Self-Improving + Proactive Agent

ivangdavila
自我反思+自我批评+自我学习+自组织记忆。智能体评估自身工作、发现错误并持续改进。
★ 1,410 📥 325,206
dev-programming

Ucp Checkout Rest

ichiorca
实现 UCP Checkout REST 绑定:创建、获取、更新、完成、取消结算会话,使用正确的请求头、幂等性及状态转换。
★ 0 📥 311