Как подключить Shoper к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Shoper, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Shoper + Cursor

Интернет-магазины Shoper (Польша): заказы с позициями и посылками, товары и остатки по вариантам, категории, зарегистрированные клиенты, статусы заказов, способы доставки и оплаты. Задаёт остатки; смена статуса заказа, которая может отправить клиенту письмо, отключена при установке.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

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 (Права): разрешите чтение заказов, товаров, клиентов и тех настроек, которые должен видеть ИИ. Разрешайте редактирование товаров, только если ИИ должен задавать остатки, а заказов — только если вы включите смену статуса. Сохраните.
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: он выведет ваши заказы и подтвердит логин.

Коннектор входит через /webapi/rest/auth по HTTP Basic и получает токен на 30 дней, который сам обновляет.

Что он читает: заказы с датой, статусом, клиентом, адресами для счёта и доставки, суммой, оплаченной суммой и флагом оплаты, способом доставки и оплаты, стоимостью доставки, заметками, источником, тегами и числом посылок; один заказ целиком, с пунктом выдачи и дополнительными полями; позиции заказа с товаром, вариантом (stock id), названием, кодом, опцией, количеством, единицей, ценой, скидкой, налогом и весом; посылки с трек-номером, флагом отправки и датой отправки, наложенным платежом и страховкой; товары с переводами, категориями, производителем, остатком, опциями, атрибутами, связанными товарами, размерами и налогом; остатки товаров, то есть продаваемые варианты, с количеством, количеством по складам, ценой, специальной, оптовой и закупочной ценой и наличием; категории и всё дерево категорий; зарегистрированных клиентов с логином, e-mail, именем, группой клиентов, скидкой, согласием на рассылку, датой регистрации, последним визитом и бонусными баллами; статусы заказов (с email_change), способы доставки и способы оплаты.

Как найти заказ: ИИ выводит заказы с 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; ИИ использует вместо него e-mail заказа.

Фильтры: filters — объект из условий по полям, объединённых через AND. Простое значение означает «равно»; операторы: =, !=, >, >=, <, <=, LIKE (с %), NOT LIKE, IN и NOT IN (со списком). Вложенные поля указываются через точку, например translations.pl_PL.name.

Что он записывает: shoper_update_product_stock включён при установке. Он перезаписывает количество одного варианта (или количество по складам, если магазин использует склады) и сразу меняет то, что могут заказать покупатели, поэтому ИИ сначала сверяет с вами stock id, текущее и новое количество.

Отключено при установке: shoper_update_order_status. Статусы с email_change 1 сразу отправляют клиенту письмо, когда заказ переходит в них, поэтому администратор включает этот инструмент осознанно. Даже тогда ИИ показывает вам заказ, текущий и новый статус и ждёт вашего «да».

Форматы: списки отвечают полями count, pages, page и list. Даты в формате YYYY-MM-DD HH:MM:SS в часовом поясе магазина; суммы — строки в валюте магазина. Тексты хранятся по языкам в translations (например, pl_PL, en_GB).

Ограничения: не более 50 элементов на страницу; ИИ запрашивает следующую page, пока page не станет равно pages. Leaky bucket Shoper допускает всплеск примерно из 10 вызовов, а затем 2 в секунду.

Частые ошибки: 401 означает неверный логин или пароль либо группу без доступа к webapi. 403 (insufficient_scope или access_denied) означает, что у группы администраторов нет прав на этот раздел: расширьте их в Uprawnienia. 404 при каждом вызове обычно означает неверный SHOPER_SHOP_HOST. 429 означает, что лимит запросов исчерпан: дождитесь Retry-After.

Коннектор не создаёт и не меняет заказы, товары, цены или клиентов, не создаёт посылки или транспортные этикетки и ничего не удаляет.

Шаг 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" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Shoper.

Доступные инструменты

Примеры запросов

• «Какие заказы пришли с понедельника и какие из них ещё не оплачены?»
• «Покажи позиции и трек-номер заказа 1234.»
• «У каких вариантов товаров на складе 5 штук или меньше?»
• «Найди заказы [email protected] за этот год и скажи, что она купила.»
• «Установи остаток варианта SKU-1-RED равным 20. Сначала покажи текущее количество.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot