Shoptet MCP

Shoptet MCP服务器

MCP（模型上下文协议）服务器 商店 电子商务平台API。提供48种工具，用于管理订单、产品、客户、文档、webhooks等，直接来自Claude等人工智能助手。

\[！警告\] 该工具为您的AI助手 完全控制您的网店 通过Shoptet API。AI可以创建、编辑和删除产品、订单、客户和其他数据。在使用之前，请仔细考虑您授予API令牌的权限。 我们建议先在测试网店上进行测试。 作者对使用此工具造成的任何损坏不承担任何责任。

特性

• 订单 --列表、创建、更新状态、获取PDF、历史记录、备注、更改跟踪
• 产品 --列表、详细信息、库存水平、品牌、类别、变更跟踪
• 客户 --带有过滤功能的列表和详细信息
• 文件 --发票、形式发票、信用证、送货单、付款证明
• 网络钩子 --创建、列出、删除webhook订阅
• 网店信息 --基本店铺元数据
• AI提示 --内置订单分析、低库存检查、每日摘要、客户查找提示
• 资源 --快速访问网店信息和订单状态

先决条件

• Node.js 18+
• Shoptet API代币(如何获得一个)
• Shoptet API文档

设置

无需安装——只需配置您的AI客户端 npx:

克劳德代码（CLI）

claude mcp add shoptet -e SHOPTET_API_TOKEN=your-token -- npx shoptet-mcp

或添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "shoptet": {
      "command": "npx",
      "args": ["shoptet-mcp"],
      "env": {
        "SHOPTET_API_TOKEN": "your-token"
      }
    }
  }
}

克劳德桌面

打开 设置→ 开发者→ 编辑配置 并添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "shoptet": {
      "command": "npx",
      "args": ["shoptet-mcp"],
      "env": {
        "SHOPTET_API_TOKEN": "your-token"
      }
    }
  }
}

VS代码（复制品/Claude扩展名）

添加 .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "shoptet": {
      "command": "npx",
      "args": ["shoptet-mcp"],
      "env": {
        "SHOPTET_API_TOKEN": "your-token"
      }
    }
  }
}

JetBrains 集成开发环境

首选 设置→ 工具→ AI助手→ MCP服务器→ Add，然后配置：

• 姓名： shoptet
• 命令： npx
• Args： shoptet-mcp
• 环境： SHOPTET_API_TOKEN=your-token

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "shoptet": {
      "command": "npx",
      "args": ["shoptet-mcp"],
      "env": {
        "SHOPTET_API_TOKEN": "your-token"
      }
    }
  }
}

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "shoptet": {
      "command": "npx",
      "args": ["shoptet-mcp"],
      "env": {
        "SHOPTET_API_TOKEN": "your-token"
      }
    }
  }
}

Cline（VS代码扩展）

在Cline中打开MCP设置并添加：

{
  "mcpServers": {
    "shoptet": {
      "command": "npx",
      "args": ["shoptet-mcp"],
      "env": {
        "SHOPTET_API_TOKEN": "your-token"
      }
    }
  }
}

可用工具

使用示例

配置后，只需自然地询问您的AI助手：

• *“显示最新订单”*
• *“订单#12345的详细信息是什么？”*
• *“将订单#123状态更改为已发货”*
• *“为订单#456创建发票”*
• *“我有什么产品？”*
• *“我目前的股票是多少？”*
• *“列出我的客户”*
• *“在订单#789中添加备注：客户致电询问交货事宜”*
• *“为新订单创建webhook”*
• *“显示上周的产品更改”*
• *“根据发票#100生成贷记单”*
• *“我的商店有哪些类别？”*

捷克语/捷克语

• *“给我看最后的订单”*
• *“订单#12345的详细信息是什么？”*
• *“将订单状态#123更改为已发货”*
• *“为订单#456发出发票”*
• *“我有什么产品？”*
• *“仓库状况如何？”*
• *“写下我的客户”*
• *“添加注释到订单#789：客户打电话要求交货”*
• *“为新订单创建 webhook”*
• *“显示过去一周的产品变化”*
• *“从发票#100创建信用卡”*
• *“我的商店有哪些类别？”*

发展

git clone https://github.com/TomKalina/shoptet-mcp.git
cd shoptet-mcp
npm install
npm run build

npm run dev          # Watch mode (TypeScript compilation)
npm run test         # Run tests
npm run test:watch   # Watch mode tests
npm run lint         # Lint
npm run typecheck    # Type check
npm run check        # All checks (typecheck + lint + test)

许可证

麻省理工学院