nanocart-mcp

nanocart-mcp

官方 NanoCart MCP 服务——通过任何支持 MCP 的 AI Agent（Claude Code、Claude Desktop、Cursor、Codex 等）管理您的商店。 只需提出请求，即可列出和更新商品（包括变体和图片）、管理订单、优惠券、类别、订阅者和设置，以及获取销售报告。

39 个工具。 读取操作会标记为只读；破坏性工具（归档商品、删除优惠券）会加注说明，让您的 Agent 在操作前征求确认。退款、账单变更和 API 密钥管理均刻意不对外提供——请在您的控制面板中执行这些操作。

凭据

在控制面板中获取：Settings → API Keys（sc_live_...，请妥善保密）和 Settings → Store Information（您的商店 ID）。此密钥拥有商店的完整管理员权限——请像对待密码一样妥善保管。

选项 A — 本地（推荐）

Claude Code：

claude mcp add nanocart --env NANOCART_API_KEY=sc_live_... --env NANOCART_STORE_ID=your-store-id -- npx -y nanocart-mcp

任何使用 stdio MCP 的客户端（JSON 配置格式）：

{
  "mcpServers": {
    "nanocart": {
      "command": "npx",
      "args": ["-y", "nanocart-mcp"],
      "env": {
        "NANOCART_API_KEY": "sc_live_...",
        "NANOCART_STORE_ID": "your-store-id"
      }
    }
  }
}

选项 B — 托管（无需安装）

端点：https://mcp.nanocart.io/mcp?store=your-store-id，并附带请求头 Authorization: Bearer sc_live_...（Streamable HTTP）。

Claude Code：

claude mcp add nanocart --transport http "https://mcp.nanocart.io/mcp?store=your-store-id" --header "Authorization: Bearer sc_live_..."

注意：仅支持基于 OAuth 的自定义连接器的网页客户端（例如 claude.ai 的连接器界面）目前无法发送 API 密钥请求头——请在这些客户端中使用选项 A。

示例提示词

• “列出我的草稿商品，并发布带有图片的商品”
• “创建一个 SUMMER20 优惠券——优惠 20%，最低订单金额 $50，8 月底到期”
• “上周我卖出了什么？还有需要发货的订单吗？”
• “将订单 NCT-1042 标记为已发货，追踪号为 9400 1000 0000 0000 0000 00”
• “上传 ./shots 中的照片，并以每件 $24 的价格创建商品”

安全

• 所有响应中的机密信息都会被隐藏；您的密钥绝不会被回显或记录。
• 破坏性工具带有 MCP destructiveHint 注释——行为规范的客户端会在运行前征求确认。
• 价格使用明确的 price_cents 整数表示（不会混淆美元和美分）。

可与 NanoCart skill 搭配使用（提供将购物车集成到网站中的相关知识）。文档： https://docs.nanocart.io/#ai-build · AI 可读版本：https://docs.nanocart.io/llms-full.txt

MIT · © 2026 NanoCart · ByteBunny, LLC 旗下公司