跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Shoptet，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
Shoptet 网店（捷克、斯洛伐克、匈牙利），只读：带历史和备注的订单，带价格和库存的商品及变体，分类，品牌，库存数量和库存变动，客户，发票，形式发票，红字发票，支付方式和配送方式。
试试这样问
Shoptet 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Shoptet、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Shoptet + Gemini
Shoptet 网店（捷克、斯洛伐克、匈牙利），只读：带历史和备注的订单，带价格和库存的商品及变体，分类，品牌，库存数量和库存变动，客户，发票，形式发票，红字发票，支付方式和配送方式。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
SHOPTET_API_TOKEN
步骤 1 — 获取凭证
设置大约需要 3 分钟。你需要一个 Shoptet Premium 网店（私有 API 只在 Premium 中提供），以及它的后台访问权限。
- 在 Shoptet 后台打开 Connections (Propojení), Private API，创建一个令牌。
- 给令牌授予你希望 AI 能看到的区域的读取权限：订单、商品、库存、客户和单据。令牌无权读取的区域会返回 403。
- 把令牌粘贴到
SHOPTET_API_TOKEN：只粘贴令牌本身，不要带空格或引号。 - 安装连接器并运行
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 — 在 Gemini 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp（或在终端运行gemini mcp list），anythingmcp应显示为已连接。 - 开始输入提示，Gemini CLI 现在可以调用
Shoptet的工具。
可用工具
| Tool | What it does |
|---|---|
shoptet_get_eshop | Get the e-shop's own settings: name, URL, contact and billing details, VAT payer, time zone, default price list, currencies and languages.… |
shoptet_list_orders | List 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_order | Get 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_history | Get 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_statuses | List 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_sources | List the order sources of the shop (e-shop, cash desk, marketplaces, imports) with id and name |
shoptet_list_products | List products, 1 to 100 per page: guid, name, type, visibility, default category, brand, supplier, URL and rating |
shoptet_get_product | Get one product by guid with its variants: code, EAN, price, VAT rate, stock amount, availability, weight and parameters per variant… |
shoptet_get_product_by_code | Get 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_categories | List the product categories: guid, name, parent guid, visibility and URL |
shoptet_list_brands | List the brands (manufacturers) of the shop: guid, code, name, web and whether they show in the brand list |
shoptet_list_stocks | List the stocks (warehouses) of the shop with id, title and whether they are a pickup point, plus the default stock id |
shoptet_list_stock_supplies | List the stock levels in one stock: product guid, code, amount in stock, claimed amount (reserved by orders) and storage location |
shoptet_list_stock_movements | List 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_customers | List registered customers: guid, billing name and company, creation and change time and admin link |
shoptet_get_customer | Get one registered customer: billing and delivery addresses, company id and VAT id, customer group, price ratio, remark and account e-mails |
shoptet_list_customer_groups | List the customer groups (e.g. retail, wholesale, VIP) with id, name, default price list and maximum discount |
shoptet_list_invoices | List invoices: code, order code, issue, due and tax dates, billing name and company, variable symbol, paid flag and price |
shoptet_get_invoice | Get 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_notes | List credit notes (opravné daňové doklady): code, invoice and order code, date, billing name, reason and price |
shoptet_list_proforma_invoices | List proforma invoices (advance invoices): code, order code, date, billing name, paid flag and price |
shoptet_list_payment_methods | List the payment methods of the shop with guid, name, type, visibility and whether they are for wholesale or in-person payment |
shoptet_list_shipping_methods | List the shipping methods of the shop with guid, name, carrier, tracking URL and visibility |
示例提示
- “昨天的订单里哪些还没付款？每笔的总额是多少 CZK？”
- “给我看订单 2026000123 的历史：状态什么时候变的，客户收到了哪些邮件，物流单号是多少？”
- “主仓库里哪些商品快没货了？每个商品已经被订单预留了多少件？”
- “找出 [email protected] 今年的所有订单，告诉我她还有哪些发票没付。”
- “列出本月开出的红字发票，附上原因、金额和对应的发票。”
FAQ
Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?
