Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Shoptet одним кликом и направьте свой ИИ-клиент (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 + Cursor
Интернет-магазин Shoptet (Чехия, Словакия, Венгрия), только чтение: заказы с историей и заметками, товары и варианты с ценами и остатками, категории, бренды, складские остатки и движения, покупатели, счета, проформы, кредит-ноты, способы оплаты и доставки.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
SHOPTET_API_TOKEN
Шаг 1 — Получите учётные данные
Настройка занимает около 3 минут. Нужен интернет-магазин на Shoptet Premium, потому что приватный API доступен только в Premium, и доступ к его администрированию.
- В администрировании Shoptet откройте Connections (Propojení), Private API и создайте токен.
- Дайте токену доступ на чтение к разделам, которые должен видеть ИИ: заказы, товары, склад, покупатели и документы. Раздел, который токен читать не может, отвечает 403.
- Вставьте токен в
SHOPTET_API_TOKEN: только сам токен, без пробелов и кавычек. - Установите коннектор и запустите
shoptet_get_eshop: он покажет название магазина, URL, валюты, языки и часовой пояс, а значит, токен работает.
Один токен, один магазин: токен принадлежит ровно одному интернет-магазину. Если у вас есть магазины .cz и .sk, установите коннектор второй раз с токеном другого магазина.
Что он читает: настройки магазина; заказы с адресом плательщика и доставки, позициями, ценами с НДС и без, статусом, отметкой об оплате, способом оплаты и доставки, каналом продаж, заметками и трек-номером; полную историю заказа (смены статуса, отправленные письма, примечания); товары и их варианты с кодом, EAN, ценой, ставкой НДС, наличием и остатком, при желании по каждому складу; категории и бренды; складские остатки с количеством, зарезервированным заказами, и движения по складу; зарегистрированных покупателей с адресами, ИНН компании и номером плательщика НДС и группой покупателей; счета с вариабельным символом, сроком оплаты и разбивкой НДС; проформы; кредит-ноты (opravné daňové doklady) с причиной; а также способы оплаты и доставки.
Сначала настройки магазина: статусы заказов, источники заказов, склады, категории и бренды в каждом магазине свои. Поэтому ИИ сначала читает их ID в вашем магазине (например, через shoptet_list_order_statuses или shoptet_list_stocks) и затем фильтрует по ним. Товар находится по коду, то есть по SKU из администрирования и заказов, через shoptet_get_product_by_code.
Страницы, время и цены: заказы идут от новых к старым, не больше 50 на страницу; товары от 1 до 100 на страницу; кредит-ноты не больше 20 на страницу. Каждый список сообщает число страниц, и ИИ запрашивает следующую, только когда она нужна. Время указывается со смещением, например 2026-10-20T00:00:00+0200: чешские и словацкие магазины работают по времени Europe/Prague. Цены приходят в валюте магазина, например CZK или EUR.
Только чтение: у коннектора нет ни одного инструмента, который что-то меняет. Он не может изменить заказ или его статус, товар, цену, остаток или покупателя, поэтому ИИ нечего согласовывать с вами.
Ограничения: Shoptet допускает 3 одновременных запроса на токен и сдерживает всплески ответом 429. ИИ ждёт несколько секунд перед повтором и запрашивает только нужное, а не листает весь магазин.
Частые ошибки: 401 expired-token или invalid-token означает, что токен удалён или истёк: создайте новый. 403 invalid-token-no-rights означает, что у токена нет доступа к этому разделу: измените его права в Private API. 404 означает, что заказа, товара или документа с таким кодом нет.
Коннектор не создаёт и не меняет заказы, товары, цены, остатки или покупателей, не выставляет счета и кредит-ноты и не отправляет письма вашим покупателям.
Шаг 2 — Установите адаптер
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 читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо
YOUR_MCP_API_KEY. - Сохрани файл и перезапусти Cursor.
- Открой Cursor → Settings → MCP и проверь, что
anythingmcpесть в списке и подключён. - Начинай общаться: агент теперь может вызывать инструменты
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
Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.
Следующие шаги
Это руководство помогло?
