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)```bash
claude mcp add shoptet -e SHOPTET_API_TOKEN=your-token -- npx shoptet-mcp
或添加到您的项目 `.mcp.json`:```json
{
"mcpServers": {
"shoptet": {
"command": "npx",
"args": ["shoptet-mcp"],
"env": {
"SHOPTET_API_TOKEN": "your-token"
}
}
}
}
克劳德桌面
打开 设置→ 开发者→ 编辑配置 并添加到 claude_desktop_config.json:```json
{
"mcpServers": {
"shoptet": {
"command": "npx",
"args": ["shoptet-mcp"],
"env": {
"SHOPTET_API_TOKEN": "your-token"
}
}
}
}
### VS代码(复制品/Claude扩展名)
添加 `.vscode/mcp.json` 在您的工作空间中:```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:```json
{
"mcpServers": {
"shoptet": {
"command": "npx",
"args": ["shoptet-mcp"],
"env": {
"SHOPTET_API_TOKEN": "your-token"
}
}
}
}
### 帆板运动
添加 `~/.codeium/windsurf/mcp_config.json`:```json
{
"mcpServers": {
"shoptet": {
"command": "npx",
"args": ["shoptet-mcp"],
"env": {
"SHOPTET_API_TOKEN": "your-token"
}
}
}
}
Cline(VS代码扩展)
在Cline中打开MCP设置并添加:```json
{
"mcpServers": {
"shoptet": {
"command": "npx",
"args": ["shoptet-mcp"],
"env": {
"SHOPTET_API_TOKEN": "your-token"
}
}
}
}
## 可用工具
|类别|工具|
|----------|-------|
| **订单** | `list_orders`, `get_order`, `create_order`, `update_order`, `update_order_status`, `get_order_statuses`, `get_order_pdf`, `get_order_history`, `add_order_remark`, `get_order_changes` |
| **产品** | `list_products`, `get_product`, `create_product`, `update_product`, `delete_product`, `get_product_changes`, `get_stock`, `list_brands`, `create_brand`, `list_categories` |
| **客户** | `list_customers`, `get_customer`, `create_customer`, `update_customer` |
| **文件** | `list_invoices`, `get_invoice`, `create_invoice_from_order`, `get_invoice_pdf`, `list_proforma_invoices`, `get_proforma_invoice`, `list_credit_notes`, `get_credit_note`, `create_credit_note_from_invoice`, `list_delivery_notes`, `create_delivery_note`, `list_proof_payments`, `get_proof_payment` |
| **网络钩子** | `list_webhooks`, `create_webhook`, `delete_webhook` |
| **网上商店** | `get_eshop_info` |
## 使用示例
配置后,只需自然地询问您的AI助手:
- *“显示最新订单”*
- *“订单#12345的详细信息是什么?”*
- *“将订单#123状态更改为已发货”*
- *“为订单#456创建发票”*
- *“我有什么产品?”*
- *“我目前的股票是多少?”*
- *“列出我的客户”*
- *“在订单#789中添加备注:客户致电询问交货事宜”*
- *“为新订单创建webhook”*
- *“显示上周的产品更改”*
- *“根据发票#100生成贷记单”*
- *“我的商店有哪些类别?”*
### 捷克语/捷克语
- *“给我看最后的订单”*
- *“订单#12345的详细信息是什么?”*
- *“将订单状态#123更改为已发货”*
- *“为订单#456发出发票”*
- *“我有什么产品?”*
- *“仓库状况如何?”*
- *“写下我的客户”*
- *“添加注释到订单#789:客户打电话要求交货”*
- *“为新订单创建 webhook”*
- *“显示过去一周的产品变化”*
- *“从发票#100创建信用卡”*
- *“我的商店有哪些类别?”*
## 发展```bash
git clone https://github.com/TomKalina/shoptet-mcp.git
cd shoptet-mcp
npm install
npm run build
``````bash
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)
许可证
麻省理工学院
