AgentHubAgentHub
UCP Gateway（通用商务协议网关） icon

UCP Gateway（通用商务协议网关） MCP配置与使用教程

MCP Serversmithery官方收录

io.smithery.theagenttimes.ucp-gateway

面向 AI 购物的商品搜索、比价与安全结账工具 商务网关——一个基础设施层，让开源 AI 智能体通过 Universal Commerce Protocol 参与智能体电商。 平台为智能体提供托管的 UCP 档案注册、安全的 MCP 网关以及电商流程接入，无需每个智能体自有域名、GitHub 账号或 Shopify 凭据。 借助该方案，智能体可以发现商品、给出推荐、构建购物车、与用户确认后生成结账跳转链接，由买家在购物平台上安全完成付款。 价值很简单：让开源智能体也能做 AI 电商，同时保证支付安全、商户受保护，并让用户确认始终处于每笔交易的中心。

原文名称：UCP Gateway

原文描述：AI Shopping tools for product search, comparison, and safe checkout Commerce Gateway — an infrastructure layer that enables open-source AI agents to participate in agentic commerce through the Universal Commerce Protocol. Our platform gives agents a hosted UCP profile registry, a secure MCP gateway, and access to commerce flows without requiring every agent to own a domain, GitHub account, or Shopify credentials. With this solution, agents can discover products, recommend options, build carts, validate them with the user, and generate checkout handoff links where the buyer completes payment safely on Shopping platform. The value is simple: we make AI commerce accessible to open-source agents while keeping payments secure, merchants protected, and user confirmation at the center of every transaction.

在 smithery 查看 ↗

建议先在本页复制安装配置，再到上游核对文档与权限。

热度数据

使用量18.3k

产品介绍

面向 AI 购物的商品搜索、比价与安全结账工具 商务网关——一个基础设施层，让开源 AI 智能体通过 Universal Commerce Protocol 参与智能体电商。 平台为智能体提供托管的 UCP 档案注册、安全的 MCP 网关以及电商流程接入，无需每个智能体自有域名、GitHub 账号或 Shopify 凭据。 借助该方案，智能体可以发现商品、给出推荐、构建购物车、与用户确认后生成结账跳转链接，由买家在购物平台上安全完成付款。 价值很简单：让开源智能体也能做 AI 电商，同时保证支付安全、商户受保护，并让用户确认始终处于每笔交易的中心。 UCP Gateway（通用商务协议网关） 是一个MCP Server，收录自 smithery。支持 streamable-http 传输。本页提供产品介绍、配置教程、安装命令与适用场景，支持 Trae、通义灵码、Cursor、Claude Code、VS Code 等。

verifiedremote

AgentHub Verified 可用性验证技术测试通过

自动化测试流水线已校验安装命令、传输协议与客户端兼容性

最近校验时间2026-07-18
安装配置格式测试有效CLI 与 mcpServers JSON 语法校验通过
协议连接与握手响应正常支持标准 JSON-RPC 2.0 规格规范
上游数据源存活来源 smithery，可正常下载依赖
测试可用客户端Claude Code、Claude Desktop、Cursor 等
安全等级： A+ 级 · 官方认证推荐 (A+)·该工具由官方或知名生态团队维护，源码遵循标准开源许可协议，可安全接入 Cursor / Claude。

按平台快速复制

选择你的平台查看安装方式

  1. 打开项目根目录下的 .cursor/mcp.json（没有就新建）
  2. 点击「复制配置」粘贴进去；若已有其他 MCP，只合并 mcpServers 里的本条目
  3. 保存后按 Cmd+Shift+P（Windows：Ctrl+Shift+P）→ 输入 Reload Window 并执行
点击「复制配置」直接粘贴到客户端
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

配置教程

  1. 打开 UCP Gateway（通用商务协议网关） 详情页，确认这是你需要的 MCP Server（来源 smithery）。
  2. 按客户端选择 Trae、通义灵码、Cursor、Claude Code 或 VS Code，复制 JSON 配置或 CLI 命令。
  3. 将配置合并进 mcpServers，并把环境变量占位符替换为真实密钥。
  4. 重载窗口后，在 Agent 对话中调用该 MCP 提供的工具。

安装命令

以下安装命令与配置步骤已写入页面 HTML，搜索引擎与未启用 JavaScript 的浏览器均可直接读取。

Claude Code（远程）

  1. 确保已安装 Claude Code CLI（终端可运行 claude 命令）
  2. 点击下方「复制配置」，在终端粘贴并执行
  3. 执行成功后重启 Claude Code 客户端
claude mcp add --transport http io-smithery-theagenttimes-ucp-gateway https://ucp-gateway--theagenttimes.run.tools

Cursor — .cursor/mcp.json（远程）

  1. 打开项目根目录下的 .cursor/mcp.json（没有就新建）
  2. 点击「复制配置」粘贴进去；若已有其他 MCP，只合并 mcpServers 里的本条目
  3. 保存后按 Cmd+Shift+P（Windows：Ctrl+Shift+P）→ 输入 Reload Window 并执行
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

VS Code — .vscode/mcp.json（远程）

  1. 确保 VS Code 已安装 GitHub Copilot 扩展并支持 MCP
  2. 打开项目根目录下的 .vscode/mcp.json（没有就新建）
  3. 点击「复制配置」粘贴；若已有其他 MCP，只合并 mcpServers 里的本条目
  4. 保存后重新加载 VS Code 窗口（Developer: Reload Window）
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

Claude Desktop — claude_desktop_config.json（远程）

  1. 打开 Claude Desktop 配置文件：macOS ~/Library/Application Support/Claude/claude_desktop_config.json；Windows %APPDATA%\Claude\claude_desktop_config.json
  2. 点击「复制配置」合并到 mcpServers
  3. 完全退出并重启 Claude Desktop
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

Trae — .trae/mcp.json（远程）

  1. 打开 Trae → 设置 → MCP，或编辑项目根目录 .trae/mcp.json（也可在全局 mcp.json 粘贴）
  2. 选择「手动添加 / 原始配置（JSON）」，点击「复制配置」粘贴；若已有其他 MCP，只合并 mcpServers 本条目
  3. 保存后选择支持 MCP 的智能体（如 Builder with MCP）并必要时重载窗口
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

Cherry Studio — MCP 设置（远程）

  1. 打开 Cherry Studio → 设置 → MCP 服务器
  2. 点击添加，选择从 JSON / 配置文件导入，或手动选 SSE/HTTP 并填 URL
  3. 点击「复制配置」粘贴 mcpServers 条目后启用该服务
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

通义灵码 — MCP 配置（远程）

  1. 通义灵码插件/IDE：头像 → 个人设置 → MCP 服务（需智能体模式，插件约 v2.5+）
  2. 点击「+」选择配置文件添加，或手工添加 SSE/HTTP 并填写服务地址
  3. 点击「复制配置」合并到 JSON；图标正常即连接成功
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

Cline — MCP Servers（远程）

  1. 在 VS Code 打开 Cline 面板 → 设置齿轮 → MCP Servers
  2. 点击「复制配置」，将 mcpServers 条目粘贴到 Cline 的 MCP 配置中
  3. 保存后 Cline 会自动重连；可在面板中确认工具列表
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

WorkBuddy — .workbuddy/mcp.json（远程）

  1. 打开 WorkBuddy：侧边栏「插件」→ MCP 服务器 → 配置 MCP；或编辑用户级 ~/.workbuddy/mcp.json / 项目级 .workbuddy/mcp.json
  2. 点击「复制配置」合并到 mcpServers（腾讯云代码助手 / WorkBuddy 通用）
  3. 保存后查看连接状态为绿色；必要时完全重启客户端
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "url": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

Windsurf — mcp_config.json（远程）

  1. 编辑全局配置 ~/.codeium/windsurf/mcp_config.json（Windows：%USERPROFILE%\.codeium\windsurf\mcp_config.json）
  2. 点击「复制配置」合并；远程 MCP 必须用 serverUrl 字段（不是 url）
  3. 保存后在 Windsurf Cascade 中刷新 MCP 连接
{
  "mcpServers": {
    "io-smithery-theagenttimes-ucp-gateway": {
      "serverUrl": "https://ucp-gateway--theagenttimes.run.tools"
    }
  }
}

常见报错排查与运行避坑 (Troubleshooting)FAQ

针对 UCP Gateway（通用商务协议网关） 在 Cursor、Claude Code 中的常见连接错误与解决办法

在 Cursor / Claude Code 中配置 UCP Gateway 提示 connection closed 或 exit code 1？

通常由本地运行时环境缺失或命令路径未被 IDE 继承引起。排查步骤： 1. 确认已安装 Node.js 18+（支持 npx）或 Python 3.10+（支持 uvx）； 2. 尝试在终端运行 which npx 或 which uvx，把配置文件中的 "command" 字段改为完整绝对路径； 3. 修改 mcp.json 后，必须完全重载或重启客户端窗口。

Fix Snippet
# 终端测试命令是否存在：
which npx
node -v
提示 spawn npx ENOENT 或 command not found？

这是因为编辑器后台进程未加载完整的终端环境变量（PATH）。解决方案：在全局安装该包（如 npm install -g 包名），或在配置文件中将 command 设置为系统的实际路径（如 Windows 下的 C:\Program Files\nodejs\npx.cmd，Mac 下的 /usr/local/bin/npx）。

调用工具时响应超时或网络下载依赖失败？

国内环境下首次执行 npx 或拉取依赖时可能因网络受限而超时。建议将 npm 镜像源切换为国内高速镜像（npm config set registry https://registry.npmmirror.com），或在系统级开启开发代理工具。

仍连不上？查看 MCP 连接失败排查指南 →

免安装模拟调用 (Playground)

仿真环境

UCP Gateway 核心接口调用仿真 · 无需配置本地环境，直接预览调用参数与返回格式

沙盒就绪 (Virtual Mock)
fn: register_ucp_profileAI Shopping tools for product search, comparison, and safe checkout Commerce Gateway — an infrastru
请求入参 (Arguments)JSON Schema
{
  "target": "UCP Gateway",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}
💡Agent 在规划任务时会自动生成并传递上述入参
Agent Tool Output

点击上方「模拟运行」按钮

查看该工具在 Agent 内部的返回数据格式

测试环境：AgentHub Virtual SandboxJSON-RPC 2.0

选型与决策建议（为什么选它？）

帮助你快速判断该资源是否契合当前项目，避免盲目折腾

适合什么任务？
  • 需要让 AI 在此领域调用自主工具能力时
  • 替代繁琐的手工重复操作，提升自动化闭环
  • 配合支持 MCP / Skill 的现代 AI 编程客户端
什么时候不建议用？
  • 没有对应环境运行权限或缺少必要 API Key 时
  • 单纯需要简单对话、无需外部系统连接的场景
推荐工作流搭配：

UCP Gateway + 对应场景 Prompt → 组成标准 Agent 自动化任务

MCP 实战教程：从安装到看见效果

按完整实例走一遍（含期望效果与对比验收）。装完本页资源后，用教程里的提示词核对是否真正生效。

打开教程 →

相关资源

常搭配使用

继续逛 AgentHub

大多数人安装前还会对比同类工具或看场景方案——下面这些能帮你少走弯路。

浏览更多同类搜索相似资源按场景选型场景提示词MCP 实战教程评测与对比

收录徽章：把 AgentHub 挂到你的官网

复制下面任意一段代码到项目主页、官网或 GitHub README。徽章是 SVG 热链，无需上传文件，链接指向本页，访客可由此直接找到安装方式。

预览AgentHub 已收录：UCP Gateway（通用商务协议网关）
HTML
<a href="https://myagenthub.cn/p/io.smithery.theagenttimes.ucp-gateway" title="AgentHub 已收录：UCP Gateway（通用商务协议网关）" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.smithery.theagenttimes.ucp-gateway" alt="AgentHub 已收录：UCP Gateway（通用商务协议网关）" height="20" style="border:0"/>
</a>
Markdown（GitHub README）
[![AgentHub 已收录：UCP Gateway（通用商务协议网关）](https://myagenthub.cn/badge/io.smithery.theagenttimes.ucp-gateway)](https://myagenthub.cn/p/io.smithery.theagenttimes.ucp-gateway)

徽章由 /badge/<资源ID> 动态生成，名称与收录状态变化后自动更新；请保留链接指向，它是收录来源的判定依据。

统一 Manifest

{
  "id": "io.smithery.theagenttimes.ucp-gateway",
  "type": "mcp-server",
  "version": "latest",
  "displayName": "UCP Gateway",
  "description": "AI Shopping tools for product search, comparison, and safe checkout\n\nCommerce Gateway — an infrastructure layer that enables open-source AI agents to participate in agentic commerce through the Universal Commerce Protocol.\n\nOur platform gives agents a hosted UCP profile registry, a secure MCP gateway, and access to commerce flows without requiring every agent to own a domain, GitHub account, or Shopify credentials.\n\nWith this solution, agents can discover products, recommend options, build carts, validate them with the user, and generate checkout handoff links where the buyer completes payment safely on Shopping platform.\n\nThe value is simple: we make AI commerce accessible to open-source agents while keeping payments secure, merchants protected, and user confirmation at the center of every transaction.\n",
  "iconUrl": "https://api.smithery.ai/servers/theagenttimes/ucp-gateway/icon",
  "homepage": "https://ucpg.ai",
  "distribution": {
    "packages": [],
    "remotes": [
      {
        "transport": "streamable-http",
        "url": "https://ucp-gateway--theagenttimes.run.tools"
      }
    ]
  },
  "capabilities": {
    "tools": [
      "register_ucp_profile",
      "get_ucp_profile",
      "shopping_product_search",
      "shopping_product_get",
      "shopping_cart_create",
      "shopping_cart_get",
      "shopping_cart_update",
      "shopping_cart_cancel",
      "shopping_checkout_create",
      "shopping_checkout_get",
      "shopping_checkout_update",
      "shopping_checkout_cancel"
    ]
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [
    "use_count:18283",
    "verified",
    "remote"
  ],
  "provenance": {
    "origin": "smithery",
    "originalId": "theagenttimes/ucp-gateway",
    "originalUrl": "https://smithery.ai/servers/theagenttimes/ucp-gateway",
    "isOfficial": true,
    "status": "active"
  }
}