Shopify Agentic MCP Gateway

Shopify代理MCP网关

Shopify上第一个用于自主AI代理的三协议商务网关。

让AI代理完全自主地浏览、协商、购物车、支付和跟踪订单。

    

______________________________________________________________________

为什么存在

AI代理正在学习购物。但今天，代理商没有标准的方法来发现商家的能力、协商条款、构建购物车、授权付款和完成购买——所有这些都不需要人工点击按钮。

Shopify代理MCP网关 通过在单个可部署的网关中实现三种新兴协议来解决这个问题：

______________________________________________________________________

特性

• 5个MCP工具 -- scout_inventory, manage_cart, negotiate_terms, execute_checkout, track_order
• UCP配置文件发现 -- /.well-known/ucp 具有能力协商和传输通告的端点
• AP2授权链 --加密ES256签名链（意向->购物车->付款），具有完整验证
• 护栏 --AI幻觉卫士验证价格、库存、授权金额和结账状态转换
• 收费 --自动计算平台费用（可配置费率）并跟踪分类账
• 结账状态机 --三态机(incomplete -> requires_escalation -> ready_for_complete)具有自动检测功能
• 双运行时 --作为Claude Desktop的stdio MCP服务器在本地运行，或通过API网关部署到AWS Lambda
• DynamoDB就绪 --带有带注释的DynamoDB迁移路径的内存存储，用于授权、会话和分类账

______________________________________________________________________

快速开始

先决条件

• Node.js>=22.0.0
• 可访问Storefront API的Shopify商店
• （可选）用于Lambda部署的AWS帐户

1.安装

git clone https://github.com/kuro-tomo/shopify-agentic-mcp.git
cd shopify-agentic-mcp
npm install

2.配置

cp .env.example .env

编辑 .env 使用您的Shopify凭据：

SHOPIFY_STORE_DOMAIN=your-store.myshopify.com
SHOPIFY_STOREFRONT_TOKEN=your_storefront_token
SHOPIFY_ACCESS_TOKEN=your_access_token
SHOPIFY_API_KEY=your_api_key
SHOPIFY_API_SECRET=your_api_secret

3.构建和运行

npm run build
npm start

MCP服务器以stdio模式启动，为Claude Desktop或任何MCP客户端做好准备。

4.连接到克劳德桌面

将此添加到您的Claude Desktop配置中(claude_desktop_config.json):

{
  "mcpServers": {
    "shopify-agentic": {
      "command": "node",
      "args": ["/absolute/path/to/shopify-agentic-mcp/dist/index.js"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_STOREFRONT_TOKEN": "your_token"
      }
    }
  }
}

现在问克劳德： *“搜索价格低于50美元的无线耳机，并将最好的耳机添加到我的购物车中。”*

______________________________________________________________________

建筑

                          +------------------+
                          |   AI Agent       |
                          | (Claude / GPT)   |
                          +--------+---------+
                                   |
                          MCP (stdio / HTTP)
                                   |
                          +--------v---------+
                          |  MCP Server      |
                          |  5 Tool Handlers |
                          +--------+---------+
                                   |
              +--------------------+--------------------+
              |                    |                     |
     +--------v-------+  +--------v--------+  +---------v--------+
     | UCP Layer       |  | AP2 Layer       |  | Middleware        |
     | - Profile       |  | - Signer        |  | - Guardrail      |
     | - Negotiate     |  | - Verifier      |  | - Fee Collector  |
     | - Checkout SM   |  | - Mandate Store |  | - Rate Limiter   |
     | - Discovery     |  |                 |  | - Auth           |
     +--------+--------+  +-----------------+  +------------------+
              |
     +--------v--------+
     | Shopify APIs     |
     | - Storefront GQL |
     | - Admin REST     |
     +------------------+

______________________________________________________________________

工具参考

所有价格都在 小型单位 （美分）。一个29.99美元的产品 price: 2999.

______________________________________________________________________

环境变量

______________________________________________________________________

部署

AWS Lambda（无服务器）

npm run build
npm run deploy

这将通过无服务器框架进行部署，其中包括：

• 运行时：ARM64上的Node.js 22.x（Graviton2）
• 路线: /.well-known/ucp （GET）， /ucp/v1/* （任何）， /mcp （POST）， /a2a （职位）
• DynamoDB：自动配置三个表（授权、分类账、会话），并使用PAY_PER_REQUEST计费

看 docs/deployment.md 查看完整部署指南。

______________________________________________________________________

文档

______________________________________________________________________

例子

• examples/claude-desktop.json --Claude桌面MCP配置
• examples/autonomous-purchase.ts --完全自主的购买流程
• examples/mandate-flow.ts --AP2任务生成和验证

______________________________________________________________________

许可证

MIT许可证。看 许可证 了解详情。

______________________________________________________________________

为代理商业时代而建。