Undercart MCP配置与使用教程
co.undercart/undercart · v1.9.0
Shopify store intelligence: revenue, app stacks, ads and marketing emails for 1M+ stores.
建议先在本页复制安装配置,再到上游核对文档与权限。
产品介绍
Shopify store intelligence: revenue, app stacks, ads and marketing emails for 1M+ stores. Undercart 是一个MCP Server,收录自 官方 MCP Registry。支持 streamable-http 传输。本页提供产品介绍、配置教程、安装命令与适用场景,支持 Trae、通义灵码、Cursor、Claude Code、VS Code 等。
AgentHub Verified 可用性验证技术测试通过
自动化测试流水线已校验安装命令、传输协议与客户端兼容性
按平台快速复制
选择你的平台查看安装方式
- 打开项目根目录下的 .cursor/mcp.json(没有就新建)
- 点击「复制配置」粘贴进去;若已有其他 MCP,只合并 mcpServers 里的本条目
- 保存后按 Cmd+Shift+P(Windows:Ctrl+Shift+P)→ 输入 Reload Window 并执行
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}配置教程
- 打开 Undercart 详情页,确认这是你需要的 MCP Server(来源 官方 MCP Registry)。
- 按客户端选择 Trae、通义灵码、Cursor、Claude Code 或 VS Code,复制 JSON 配置或 CLI 命令。
- 将配置合并进 mcpServers,并把环境变量占位符替换为真实密钥。
- 重载窗口后,在 Agent 对话中调用该 MCP 提供的工具。
安装命令
以下安装命令与配置步骤已写入页面 HTML,搜索引擎与未启用 JavaScript 的浏览器均可直接读取。
Claude Code(远程)
- 确保已安装 Claude Code CLI(终端可运行 claude 命令)
- 点击下方「复制配置」,在终端粘贴并执行
- 执行成功后重启 Claude Code 客户端
claude mcp add --transport http undercart https://undercart.co/api/mcpCursor — .cursor/mcp.json(远程)
- 打开项目根目录下的 .cursor/mcp.json(没有就新建)
- 点击「复制配置」粘贴进去;若已有其他 MCP,只合并 mcpServers 里的本条目
- 保存后按 Cmd+Shift+P(Windows:Ctrl+Shift+P)→ 输入 Reload Window 并执行
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}VS Code — .vscode/mcp.json(远程)
- 确保 VS Code 已安装 GitHub Copilot 扩展并支持 MCP
- 打开项目根目录下的 .vscode/mcp.json(没有就新建)
- 点击「复制配置」粘贴;若已有其他 MCP,只合并 mcpServers 里的本条目
- 保存后重新加载 VS Code 窗口(Developer: Reload Window)
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}Claude Desktop — claude_desktop_config.json(远程)
- 打开 Claude Desktop 配置文件:macOS ~/Library/Application Support/Claude/claude_desktop_config.json;Windows %APPDATA%\Claude\claude_desktop_config.json
- 点击「复制配置」合并到 mcpServers
- 完全退出并重启 Claude Desktop
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}Trae — .trae/mcp.json(远程)
- 打开 Trae → 设置 → MCP,或编辑项目根目录 .trae/mcp.json(也可在全局 mcp.json 粘贴)
- 选择「手动添加 / 原始配置(JSON)」,点击「复制配置」粘贴;若已有其他 MCP,只合并 mcpServers 本条目
- 保存后选择支持 MCP 的智能体(如 Builder with MCP)并必要时重载窗口
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}Cherry Studio — MCP 设置(远程)
- 打开 Cherry Studio → 设置 → MCP 服务器
- 点击添加,选择从 JSON / 配置文件导入,或手动选 SSE/HTTP 并填 URL
- 点击「复制配置」粘贴 mcpServers 条目后启用该服务
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}通义灵码 — MCP 配置(远程)
- 通义灵码插件/IDE:头像 → 个人设置 → MCP 服务(需智能体模式,插件约 v2.5+)
- 点击「+」选择配置文件添加,或手工添加 SSE/HTTP 并填写服务地址
- 点击「复制配置」合并到 JSON;图标正常即连接成功
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}Cline — MCP Servers(远程)
- 在 VS Code 打开 Cline 面板 → 设置齿轮 → MCP Servers
- 点击「复制配置」,将 mcpServers 条目粘贴到 Cline 的 MCP 配置中
- 保存后 Cline 会自动重连;可在面板中确认工具列表
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}WorkBuddy — .workbuddy/mcp.json(远程)
- 打开 WorkBuddy:侧边栏「插件」→ MCP 服务器 → 配置 MCP;或编辑用户级 ~/.workbuddy/mcp.json / 项目级 .workbuddy/mcp.json
- 点击「复制配置」合并到 mcpServers(腾讯云代码助手 / WorkBuddy 通用)
- 保存后查看连接状态为绿色;必要时完全重启客户端
{
"mcpServers": {
"undercart": {
"url": "https://undercart.co/api/mcp"
}
}
}Windsurf — mcp_config.json(远程)
- 编辑全局配置 ~/.codeium/windsurf/mcp_config.json(Windows:%USERPROFILE%\.codeium\windsurf\mcp_config.json)
- 点击「复制配置」合并;远程 MCP 必须用 serverUrl 字段(不是 url)
- 保存后在 Windsurf Cascade 中刷新 MCP 连接
{
"mcpServers": {
"undercart": {
"serverUrl": "https://undercart.co/api/mcp"
}
}
}常见报错排查与运行避坑 (Troubleshooting)FAQ
针对 Undercart 在 Cursor、Claude Code 中的常见连接错误与解决办法
在 Cursor / Claude Code 中配置 Undercart 提示 connection closed 或 exit code 1?
通常由本地运行时环境缺失或命令路径未被 IDE 继承引起。排查步骤: 1. 确认已安装 Node.js 18+(支持 npx)或 Python 3.10+(支持 uvx); 2. 尝试在终端运行 which npx 或 which uvx,把配置文件中的 "command" 字段改为完整绝对路径; 3. 修改 mcp.json 后,必须完全重载或重启客户端窗口。
# 终端测试命令是否存在: 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),或在系统级开启开发代理工具。
免安装模拟调用 (Playground)
仿真环境Undercart 核心接口调用仿真 · 无需配置本地环境,直接预览调用参数与返回格式
{
"target": "Undercart",
"action": "execute",
"options": {
"mode": "standard",
"timeoutMs": 5000
}
}点击上方「模拟运行」按钮
查看该工具在 Agent 内部的返回数据格式
选型与决策建议(为什么选它?)
帮助你快速判断该资源是否契合当前项目,避免盲目折腾
- 需要让 AI 在此领域调用自主工具能力时
- 替代繁琐的手工重复操作,提升自动化闭环
- 配合支持 MCP / Skill 的现代 AI 编程客户端
- 没有对应环境运行权限或缺少必要 API Key 时
- 单纯需要简单对话、无需外部系统连接的场景
Undercart + 对应场景 Prompt → 组成标准 Agent 自动化任务
MCP 实战教程:从安装到看见效果
按完整实例走一遍(含期望效果与对比验收)。装完本页资源后,用教程里的提示词核对是否真正生效。
相关资源
GlobalGov — Government Contracts, Tenders & Procurement
v1.0.8
io.globalgov/mcp
Find government contracts, tenders and RFPs you can still bid on, in 193 countries. Free, no key.
Fillo
v0.10.0
io.github.jacobfunch/usefillo
Fillo MCP server — provision, scaffold, publish, and query forms from your coding agent.
SecurityScorecard 安全评分
v2.0.0
io.github.CallMarcus/securityscorecard-mcp
社区构建的 SecurityScorecard API 全功能 MCP 服务器(非官方)。
taxapp.nz
v1.0.0
nz.taxapp/taxapp
Your taxapp.nz income, expenses, rental properties and NZ tax figures, and adding new records.
AgentsJunction
v0.1.1
io.github.JakubTrousil/agentsjunction
Discover MCP servers and A2A agents; verify, message, post, follow, react, and receive webhooks.
AI 网页内容托管 WebZum
v1.4.0
io.github.suprraz/webzum
即时托管 AI 生成的 HTML/CSS/JS,支持文件、zip 或克隆现有页面,数秒上线。
常搭配使用
API 网关
v1.2.25
io.clawhub.byungkyu/api-gateway
通过 Maton 网关调用第三方 API,网关会为用户已连接的应用注入凭据。当用户点名某个已连接应用及其中具体操作——读邮箱、查 CRM、提 issue、更新表格等——时使用本技能。
v1.2.6
io.clawhub.byungkyu/linkedin-api
通过托管 OAuth 集成 LinkedIn API。分享帖子、管理资料、访问 LinkedIn 功能。当用户想在 LinkedIn 分享内容、获取资料/组织信息或与 LinkedIn 平台交互时使用。广告功能(营销活动、广告账户)需要额外的 OAuth 权限,使用前请核实已授予的权限。其他第三方应用请使用 api-gateway 技能(https://clawhub.ai/byungkyu/api-gateway)。需要网络访问和有效的 Maton API key。调用通过 `maton` CLI 配合 OAuth 登录,或在无法安装 CLI 时通过原始 HTTP 配合 Maton API key 执行。每次调用都以用户连接身份认证,仅访问该连接授权允许的资源,由服务商在每次请求时强制执行;此处记录的端点是本技能所使用的,应用的其他任何端点都需要用户指名要求才可调用。默认使用读取和列表调用,每次写入或新建连接前都与用户确认。
WhatsApp Business
v1.2.8
io.clawhub.byungkyu/whatsapp-business
WhatsApp Business API 集成,采用托管式 OAuth。发送消息、管理模板并处理会话。当用户需要与 WhatsApp Business 交互时使用本技能;其他第三方应用请使用 api-gateway 技能(https://clawhub.ai/byungkyu/api-gateway)。调用通过 `maton` CLI 配合 OAuth 登录执行,或在无法安装 CLI 时凭 Maton API Key 走原始 HTTP。每次调用都以用户连接身份认证,仅能访问该连接授权范围内的数据,服务端对每个请求强制执行鉴权;此处记录的端点即本技能所用端点,若需该应用的其他端点,须由用户点名提出。默认只做读取与列表调用,任何写入或新连接都需经用户确认。本文件还按使用顺序记录把 WhatsApp Business 连接变成自动化的三个构件:连接(第一步)、通过 Maton SDK 执行 WhatsApp Business 操作的托管函数,以及……(原文截断)
Salesforce
v1.2.7
io.clawhub.byungkyu/salesforce-api
Salesforce CRM API 集成,采用托管式 OAuth。仅在需要管理 Salesforce CRM 时安装。请以可用的最小权限连接,破坏性或批量操作优先使用沙箱组织,每次请求前核对目标连接 ID,并及时吊销未使用的连接。本集成可能修改 CRM 记录——仅在核对确切的 sObject、记录 ID 及影响后,再批准具体写操作。其他第三方应用请使用 api-gateway 技能(https://clawhub.ai/byungkyu/api-gateway)。调用通过 `maton` CLI 配合 OAuth 登录执行,或在无法安装 CLI 时凭 Maton API Key 走原始 HTTP。每次调用都以用户连接身份认证,仅能访问该连接授权范围内的数据,服务端对每个请求强制执行鉴权;此处记录的端点即本技能所用端点,若需该应用的其他端点,须由用户点名提出。默认只做读取与列表调用,任何写……(原文截断)
继续逛 AgentHub
大多数人安装前还会对比同类工具或看场景方案——下面这些能帮你少走弯路。
收录徽章:把 AgentHub 挂到你的官网
复制下面任意一段代码到项目主页、官网或 GitHub README。徽章是 SVG 热链,无需上传文件,链接指向本页,访客可由此直接找到安装方式。
<a href="https://myagenthub.cn/p/co.undercart/undercart" title="AgentHub 已收录:Undercart" target="_blank" rel="noopener">
<img src="https://myagenthub.cn/badge/co.undercart/undercart" alt="AgentHub 已收录:Undercart" height="20" style="border:0"/>
</a>[](https://myagenthub.cn/p/co.undercart/undercart)徽章由 /badge/<资源ID> 动态生成,名称与收录状态变化后自动更新;请保留链接指向,它是收录来源的判定依据。
统一 Manifest
{
"id": "co.undercart/undercart",
"type": "mcp-server",
"version": "1.9.0",
"displayName": "Undercart",
"description": "Shopify store intelligence: revenue, app stacks, ads and marketing emails for 1M+ stores.",
"homepage": "https://undercart.co/docs/mcp",
"distribution": {
"packages": [],
"remotes": [
{
"transport": "streamable-http",
"url": "https://undercart.co/api/mcp"
}
]
},
"dependencies": [],
"installTargets": [
"claude-code",
"claude-desktop",
"cursor",
"vscode",
"trae",
"cherry-studio",
"lingma",
"windsurf",
"cline",
"workbuddy"
],
"keywords": [],
"provenance": {
"origin": "official-mcp-registry",
"originalId": "co.undercart/undercart",
"originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/co.undercart%2Fundercart/versions/latest",
"isOfficial": true,
"status": "active"
}
}