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

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

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。

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

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

Shoptet

Shoptet

Shoptet e-shop (Czech Republic, Slovakia, Hungary), read-only: orders with history and notes, products and variants with prices and stock, categories, brands, stock levels and movements, customers, invoices, proforma invoices, credit notes, payment and shipping methods.

个工具

23

区域

INTL

类别

电子商务

身份验证

API Key

所需环境变量

SHOPTET_API_TOKEN
在 Cloud 上一键安装

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

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

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

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

开始免费试用

摘要

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。

试试这样问

Shoptet 的示例提示

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

Shoptet · 通过 MCP 实时
分享
Opus 4.7

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

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

Shoptet + Microsoft Copilot

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。

前提条件

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

SHOPTET_API_TOKEN

步骤 1 — 获取凭证

设置大约需要 3 分钟。你需要一个 Shoptet Premium 网店(私有 API 只在 Premium 中提供),以及它的后台访问权限。

  1. 在 Shoptet 后台打开 Connections (Propojení), Private API,创建一个令牌。
  2. 给令牌授予你希望 AI 能看到的区域的读取权限:订单、商品、库存、客户和单据。令牌无权读取的区域会返回 403。
  3. 把令牌粘贴到 SHOPTET_API_TOKEN:只粘贴令牌本身,不要带空格或引号。
  4. 安装连接器并运行 shoptet_get_eshop:它会显示网店的名称、URL、货币、语言和时区,说明令牌可用。

一个令牌对应一个网店:每个令牌只属于一个网店。如果你同时经营 .cz 和 .sk 网店,请用另一个网店的令牌再安装一次连接器。

读取的内容:网店本身的设置;订单,包括账单地址和收货地址、商品行、含税和不含税价格、状态、已付款标记、支付和配送方式、销售渠道、备注和物流单号;订单的完整历史(状态变更、已发送的邮件、备注);商品及其变体,包括编码、EAN、价格、税率、可售状态和库存,需要时可按仓库查看;分类和品牌;库存数量(含被订单预留的数量)和库存变动;注册客户,包括地址、公司编号和增值税号以及客户组;发票,包括可变符号、到期日和增值税明细;形式发票;红字发票(opravné daňové doklady)及其原因;以及支付方式和配送方式。

先读网店设置:订单状态、订单来源、仓库、分类和品牌在每个网店都不一样,所以 AI 会先从你的网店读取它们的 ID(例如用 shoptet_list_order_statuses 或 shoptet_list_stocks),再用这些 ID 筛选。商品可以按编码查找,也就是后台和订单里显示的 SKU,用 shoptet_get_product_by_code。

分页、时间和价格:订单从新到旧排列,每页最多 50 条;商品每页 1 到 100 条;红字发票每页最多 20 条。每个列表都会给出总页数,AI 只在需要时才取下一页。时间带有时区偏移,例如 2026-10-20T00:00:00+0200:捷克和斯洛伐克的网店使用 Europe/Prague 时间。价格以网店货币返回,例如 CZK 或 EUR。

只读:这个连接器没有任何会修改数据的工具。它不能修改订单或订单状态、商品、价格、库存或客户,所以 AI 不需要找你确认任何操作。

限制:Shoptet 每个令牌最多允许 3 个并发请求,突发请求会被 429 限流。AI 会等几秒再重试,并且只取需要的数据,而不是把整个网店翻一遍。

常见错误:401 expired-token 或 invalid-token 表示令牌已被删除或已过期:请新建一个。403 invalid-token-no-rights 表示令牌没有该区域的权限:请在 Private API 中修改它的权限。404 表示没有该编码的订单、商品或单据。

这个连接器不会创建或修改订单、商品、价格、库存或客户,不会开具发票或红字发票,也不会给你的客户发邮件。

步骤 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 窗格中试一试:提出需要用到 Shoptet 的工具的请求。
  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
shoptet_get_eshopGet the e-shop's own settings: name, URL, contact and billing details, VAT payer, time zone, default price list, currencies and languages.…
shoptet_list_ordersList orders, newest first, at most 50 per page: code, creation and change time, customer name, e-mail and phone, status, paid flag, total…
shoptet_get_orderGet one order by its code (order number): billing and delivery address, items with code, name, amount, unit price and VAT, prices, status…
shoptet_get_order_historyGet the history of an order: every status change, e-mail sent, remark and system event with time, text and the user who did it
shoptet_list_order_statusesList the order statuses of the shop (they differ from shop to shop): id, name, whether it is a system status, whether it marks the order…
shoptet_list_order_sourcesList the order sources of the shop (e-shop, cash desk, marketplaces, imports) with id and name
shoptet_list_productsList products, 1 to 100 per page: guid, name, type, visibility, default category, brand, supplier, URL and rating
shoptet_get_productGet one product by guid with its variants: code, EAN, price, VAT rate, stock amount, availability, weight and parameters per variant…
shoptet_get_product_by_codeGet a product by the code of the product or of one of its variants (the SKU shown in the admin and on orders), with the same details and…
shoptet_list_categoriesList the product categories: guid, name, parent guid, visibility and URL
shoptet_list_brandsList the brands (manufacturers) of the shop: guid, code, name, web and whether they show in the brand list
shoptet_list_stocksList the stocks (warehouses) of the shop with id, title and whether they are a pickup point, plus the default stock id
shoptet_list_stock_suppliesList the stock levels in one stock: product guid, code, amount in stock, claimed amount (reserved by orders) and storage location
shoptet_list_stock_movementsList stock movements in one stock, oldest first: product code, amount after the change, the change, time and who or what changed it (an…
shoptet_list_customersList registered customers: guid, billing name and company, creation and change time and admin link
shoptet_get_customerGet one registered customer: billing and delivery addresses, company id and VAT id, customer group, price ratio, remark and account e-mails
shoptet_list_customer_groupsList the customer groups (e.g. retail, wholesale, VIP) with id, name, default price list and maximum discount
shoptet_list_invoicesList invoices: code, order code, issue, due and tax dates, billing name and company, variable symbol, paid flag and price
shoptet_get_invoiceGet one invoice by its code: items, prices and VAT breakdown, billing and delivery address, payment method, due date, paid flag and symbols
shoptet_list_credit_notesList credit notes (opravné daňové doklady): code, invoice and order code, date, billing name, reason and price
shoptet_list_proforma_invoicesList proforma invoices (advance invoices): code, order code, date, billing name, paid flag and price
shoptet_list_payment_methodsList the payment methods of the shop with guid, name, type, visibility and whether they are for wholesale or in-person payment
shoptet_list_shipping_methodsList the shipping methods of the shop with guid, name, carrier, tracking URL and visibility

示例提示

  • “昨天的订单里哪些还没付款?每笔的总额是多少 CZK?”
  • “给我看订单 2026000123 的历史:状态什么时候变的,客户收到了哪些邮件,物流单号是多少?”
  • “主仓库里哪些商品快没货了?每个商品已经被订单预留了多少件?”
  • “找出 [email protected] 今年的所有订单,告诉我她还有哪些发票没付。”
  • “列出本月开出的红字发票,附上原因、金额和对应的发票。”

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" 即可使用新版本。

下一步

这份指南对你有帮助吗?

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

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

相关指南

连接器

如何通过 MCP 将 Shoptet 连接到 ChatGPT

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。

连接器

如何通过 MCP 将 Shoptet 连接到 Claude

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。

连接器

如何通过 MCP 将 Shoptet 连接到 Cursor

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。

连接器

如何通过 MCP 将 Shoptet 连接到 Gemini

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。

连接器

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

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。

连接器

Shoptet 接入 MCP:在任意 AI 智能体中查看网店的订单、库存和发票

Shoptet 网店(捷克、斯洛伐克、匈牙利),只读:带历史和备注的订单,带价格和库存的商品及变体,分类,品牌,库存数量和库存变动,客户,发票,形式发票,红字发票,支付方式和配送方式。