连接器指南阅读约 4 分钟17 个 MCP 工具7 种语言

如何通过 MCP 将 Shoper 连接到 Microsoft Copilot

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

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Shoper

Shoper

Shoper online shops (Poland): orders with line items and parcels, products and stock per variant, categories, registered customers, order statuses, shipping and payment methods. Can set stock quantities; changing an order status (which may e-mail the customer) is installed switched off.

个工具

17

区域

INTL

类别

电子商务

身份验证

OAuth 2.0

所需环境变量

SHOPER_SHOP_HOSTSHOPER_API_LOGINSHOPER_API_PASSWORD
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 Shoper,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

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

试试这样问

Shoper 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Shoper · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

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

Shoper + Microsoft Copilot

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 — 在 Microsoft Copilot 中添加连接器

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

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 Shoper 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。

可用工具

ToolWhat it does
shoper_list_ordersList orders of the shop (pass order -date for newest first): order id, date, status_id, customer (user_id, e-mail, billing and delivery…
shoper_get_orderGet one order with all its fields: status, customer, billing and delivery address, sums, payment and shipping, pickup point, notes…
shoper_list_order_productsList order line items: order_id, product_id, stock_id, name, code, option (variant), quantity, unit, price, discount, tax rate and value…
shoper_list_productsList products of the catalogue: product_id, code, EAN, category, producer, translations (name, description, active, SEO per language such…
shoper_get_productGet one product with translations, categories, stock (price, quantity, availability), options, attributes, related products, dimensions and…
shoper_list_product_stocksList product stocks, i.e. the sellable variants of products: stock_id, product_id, code, EAN, stock quantity, warehouse quantities, price…
shoper_get_product_stockGet one product stock (variant) with its quantity, warehouse quantities, prices, availability and options
shoper_list_categoriesList product categories: category_id, order, root flag and translations (name, description, active, SEO per language)
shoper_get_category_treeGet the whole category tree as nested nodes (id and children)
shoper_list_customersList registered customers (Shoper users): user_id, login, e-mail, first and last name, customer group, discount, newsletter consent, active…
shoper_get_customerGet one registered customer by user_id (e.g. the user_id of an order)
shoper_list_statusesList the order statuses of the shop: status_id, type (1 new, 2 opened, 3 closed, 4 not completed), translations (names per language)…
shoper_list_shippingsList shipping methods: shipping_id, name, translations, cost, free shipping threshold, weight and order value limits, zone, allowed…
shoper_list_paymentsList payment methods: payment_id, name, translations, currencies and amount limits
shoper_list_parcelsList parcels (shipments) of orders: parcel_id, order_id, shipping_id, shipping_code (tracking number), sent flag and send date, weight…
shoper_update_order_statusMove an order to another status (status_id from shoper_list_statuses)
shoper_update_product_stockSet the quantity of one product stock (variant)

示例提示

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

FAQ

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

你的 Shoper 智能体只差一次点击。

安装连接器,粘贴密钥,向 Microsoft Copilot 提问。免费试用 7 天,无需信用卡。

相关指南

连接器

如何通过 MCP 将 Shoper 连接到 ChatGPT

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

连接器

如何通过 MCP 将 Shoper 连接到 Claude

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

连接器

如何通过 MCP 将 Shoper 连接到 Cursor

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

连接器

如何通过 MCP 将 Shoper 连接到 Gemini

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

连接器

如何通过 MCP 将 Shoper 连接到 Meta Muse

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

连接器

Shoper 接入 MCP:在任意 AI 智能体中查看 Shoper 店铺的订单、商品、库存和客户

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