如何通过 MCP 将 Shoper 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Shoper、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Shoper + Cursor

Shoper 网店（波兰）：含订单行和包裹的订单，商品及各变体的库存，分类，注册客户，订单状态，配送方式和支付方式。可以设置库存数量；修改订单状态可能会给客户发邮件，因此在安装时关闭。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

SHOPER_SHOP_HOST, SHOPER_API_LOGIN, SHOPER_API_PASSWORD

步骤 1 — 获取凭证

设置大约需要 5 分钟。你需要该店铺 Shoper 管理面板的管理员权限。

1. 在 Shoper 管理面板中打开 Ustawienia、Ogólne、Administratorzy sklepu（设置、常规、店铺管理员）。点击 WIĘCEJ、Dodaj grupę administratorów，为其命名（例如 AI），并选择访问类型 dostęp do webapi。保存。
2. 打开该组的 Uprawnienia（权限）选项卡：允许读取订单、商品、客户以及 AI 需要看到的设置。只有在 AI 需要设置库存时才允许编辑商品，只有在你开启状态修改时才允许编辑订单。保存。
3. 在 Administratorzy 选项卡点击 DODAJ ADMINISTRATORA：创建登录名和密码，填入 SHOPER_API_LOGIN 和 SHOPER_API_PASSWORD。已注册的 Shoper 应用也可以在这里改用其 client_id 和 client_secret。
4. 把 SHOPER_SHOP_HOST 设为不带 https:// 和路径的店铺地址，例如 myshop.shoparena.pl 或你自己的域名 sklep.example.pl。
5. 安装连接器并运行 shoper_list_orders：它会列出你的订单并确认登录可用。

连接器通过 HTTP Basic 在 /webapi/rest/auth 登录，获得有效期 30 天的令牌，并自动续期。

可读取的内容：订单，包括日期、状态、客户、账单和收货地址、总额、已付金额和已付标志、配送和支付方式、运费、备注、来源、标签和包裹数量；单个订单的完整信息，包括自提点和附加字段；订单行，包括商品、变体（stock id）、名称、编码、选项、数量、单位、价格、折扣、税和重量；包裹，包括运单号、已发货标志和发货日期、货到付款和保险；商品，包括翻译、分类、生产商、库存、选项、属性、相关商品、尺寸和税；商品库存，即可售的变体，包括数量、各仓库数量、价格、特价、批发价和进价以及可售状态；分类和完整的分类树；注册客户，包括登录名、邮箱、姓名、客户组、折扣、订阅同意、注册日期、最近访问和积分；订单状态（含 email_change）、配送方式和支付方式。

查找订单：AI 用 filters 和 order 列出订单（例如日期筛选加 -date 让最新的排在前面），用 shoper_get_order 读取单个订单，再用 shoper_list_order_products 读取订单行、用 shoper_list_parcels 读取运单号，两者都使用 order_id 筛选。状态、支付和配送方式的名称来自 shoper_list_statuses、shoper_list_payments 和 shoper_list_shippings。游客订单没有 user_id；AI 会改用订单中的邮箱。

筛选：filters 是一个由字段条件组成的对象，条件之间为 AND。只写值表示等于；运算符有 =、!=、>、>=、<、<=、LIKE（配合 %）、NOT LIKE、IN 和 NOT IN（配合列表）。嵌套字段用点表示，例如 translations.pl_PL.name。

可写入的内容：shoper_update_product_stock 在安装时即开启。它会覆盖某个变体的数量（店铺使用仓库功能时则覆盖各仓库的数量），并立即改变客户可以下单的数量，因此 AI 会先与你确认 stock id、当前数量和新数量。

安装时关闭：shoper_update_order_status。email_change 为 1 的状态会在订单转入时立即给客户发邮件，因此由管理员有意开启此工具。即使开启后，AI 也会先向你展示订单、当前状态和新状态，等你同意。

格式：列表以 count、pages、page 和 list 返回。日期为店铺时区的 YYYY-MM-DD HH:MM:SS；金额是以店铺币种表示的字符串。文本按语言存放在 translations 下（例如 pl_PL、en_GB）。

限制：每页最多 50 条；AI 会用下一个 page 继续请求，直到 page 等于 pages。Shoper 的漏桶限流允许约 10 次突发调用，之后每秒 2 次。

常见错误：401 表示登录名或密码错误，或该组没有 webapi 访问权限。403（insufficient_scope 或 access_denied）表示管理员组缺少该区域的权限：请在 Uprawnienia 中扩展。每次调用都返回 404，通常表示 SHOPER_SHOP_HOST 填错了。429 表示已达到速率限制：请等待 Retry-After。

连接器不会创建或修改订单、商品、价格或客户，不会创建包裹或运单标签，也不会删除任何内容。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Shoper 的工具。

可用工具

示例提示

• “周一以来进来了哪些订单？其中哪些还没有付款？”
• “显示订单 1234 的订单行和运单号。”
• “哪些商品变体的库存只有 5 件或更少？”
• “找出 [email protected] 今年的订单，告诉我她买了什么。”
• “把变体 SKU-1-RED 的库存设为 20。先给我看当前数量。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot