Кратко
Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.
Пошаговая настройка
Подключи SHOPLINE к Cursor за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи SHOPLINE в пошаговой настройке и добавь свой MCP URL в Cursor. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для SHOPLINE
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → SHOPLINE, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
SHOPLINE + Cursor
Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
SHOPLINE_HANDLE, SHOPLINE_ACCESS_TOKEN
Шаг 1 — Получи учетные данные
Настройка занимает около 5 минут.
- Войди в админку SHOPLINE по адресу
https://admin.myshopline.comи открой Apps, затем Develop Apps (в правом верхнем углу), и создай частное приложение. - Установи необходимые области доступа для инструментов:
read_orders,write_orders,read_products,write_products,read_customers,read_inventory,write_inventory,read_location,read_assigned_fulfillment_ordersиwrite_assigned_fulfillment_orders(только области чтения достаточно для инструментов чтения). - Открой API certificate приложения и скопируй access token в
SHOPLINE_ACCESS_TOKEN. Токен частного приложения действителен в течение 3 лет и может быть обновлён там; удаление приложения аннулирует его. - Введи идентификатор магазина, первую часть
<handle>.myshopline.com, вSHOPLINE_HANDLE.
С чего начать: shopline_list_orders с status любым (и fulfillment_status, когда ищешь отправленные заказы), затем shopline_list_order_fulfillments. Для продуктов shopline_list_products, shopline_get_product и shopline_list_product_variants.
Заказы: shopline_list_orders, shopline_count_orders, shopline_update_order (теги, контакт, заметки, адрес доставки), shopline_list_order_transactions, shopline_list_order_refunds. id — это идентификатор заказа; name — это номер заказа, который видит клиент (1001 и выше, с необязательным префиксом). Отмена и возврат не включены, потому что они возвращают деньги.
Доставка: shopline_create_fulfillment отправляет заказ с номером отслеживания, shopline_list_order_fulfillments перечисляет отправления, shopline_update_fulfillment_tracking заменяет список отслеживания одной отправки (отправь все записи, остальные будут очищены).
Продукты: shopline_list_products, shopline_get_product, shopline_count_products, shopline_update_product (статус активен публикует, черновик скрывает), shopline_list_product_variants, shopline_update_variant (цена, цена сравнения, SKU, штрих-код). Теги передаются в виде списка и возвращаются в виде строки, разделенной запятыми. Продукты могут иметь до пяти опций на вариант.
Клиенты: shopline_list_customers, shopline_get_customer, shopline_search_customers, shopline_list_customer_orders.
Запасы: каждый вариант имеет inventory_item_id. shopline_list_locations, shopline_get_inventory_items, shopline_get_inventory_levels, затем shopline_set_inventory (абсолютное значение) или shopline_adjust_inventory (дельта).
Пагинация: списки используют курсор. Когда есть другая страница, ответ содержит _pagination.nextUrl; передай его значение page_info с тем же лимитом. _pagination отсутствует на последней странице.
Идентификаторы и форматы: идентификаторы — это длинные строковые числа (26 цифр): всегда передавай их как текст. Времена — ISO 8601; цены — десятичные строки в валюте магазина.
Лимит запросов: 4 запроса в секунду на приложение и магазин, с всплесками до 40 в очереди; выше этого SHOPLINE отвечает 429 Слишком много запросов. Ответы ограничены 8 МБ, поэтому используй fields и меньшие лимиты для больших магазинов.
Шаг 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есть в списке и подключён. - Начинай общаться: агент теперь может вызывать инструменты
SHOPLINE.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
shopline_list_orders | Список заказов: id, name (номер заказа, например, 1001), order_at, financial_status, fulfillment_status, status, currency, current_total_price… |
shopline_count_orders | Подсчет заказов, соответствующих фильтрам (status, payment, shipment, dates): ответ с количеством. Только для чтения |
shopline_update_order | Изменение тегов заказа, электронной почты или телефона покупателя, заметок продавца (note_attributes) или адреса доставки. Отправляются только указанные поля; теги… |
shopline_list_order_fulfillments | Список выполнений (отправок) заказа: id, status, tracking_company, tracking_number, tracking_url, line_items и created_at |
shopline_create_fulfillment | Отправка заказа (всего или указанных позиций) с номером отслеживания и перевозчиком. notify_customer отправляет электронное письмо о доставке. Ответы… |
shopline_update_fulfillment_tracking | Замена информации об отслеживании выполнения. Список заменяет то, что хранится: записи отслеживания, которые не включены, удаляются |
shopline_list_order_transactions | Список платежных транзакций заказа: id, kind (продажа, возврат и т. д.), status, amount, currency, gateway и processed_at. Только для чтения |
shopline_list_order_refunds | Список возвратов заказа: id, created_at, note, refund_line_items и транзакции с суммами. Только для чтения |
shopline_list_products | Список продуктов: id, title, handle, status (активен, черновик, архивирован), vendor, tags, product_category, created_at, updated_at, options и… |
shopline_get_product | Чтение одного продукта: title, body_html, status, vendor, tags, handle, options, images, media и варианты с ценой, sku, barcode, weight… |
shopline_count_products | Подсчет продуктов, соответствующих фильтрам (status, collection, dates): ответ с количеством. Только для чтения |
shopline_update_product | Изменение продукта: title, subtitle, description (body_html), status (активен публикует, черновик скрывает, архивирован архивирует), vendor, tags… |
shopline_list_product_variants | Список вариантов продукта: id, sku, barcode, price, compare_at_price, option1 до option5, weight, inventory_quantity, inventory_policy… |
shopline_update_variant | Изменение варианта: цена и compare_at_price (десятичные строки в валюте магазина), sku, barcode, weight с weight_unit… |
shopline_list_customers | Список клиентов: id, email, phone, first_name, last_name, state, tags, orders_count, total_spent, accepts_marketing, addresses и… |
shopline_get_customer | Чтение одного клиента: email, phone, names, state, tags, note, orders_count, total_spent, согласие на маркетинг и адреса |
shopline_search_customers | Поиск клиентов по имени, email, телефону или тексту адреса (query_param), или по точным критериям, таким как tags или orders_count (query). То же самое… |
shopline_list_customer_orders | Список заказов одного клиента с теми же полями заказа, что и в shopline_list_orders. До 100 на страницу |
shopline_list_locations | Список местоположений запасов (склады и магазины): id, name, address, active и является ли это местоположением по умолчанию |
shopline_get_inventory_items | Чтение запасных единиц (по одной на вариант): id, sku, tracked, cost и страна происхождения. inventory_item_id есть у каждого варианта |
shopline_get_inventory_levels | Чтение доступных запасов на каждую запасную единицу и местоположение: inventory_item_id, location_id, available и updated_at |
shopline_set_inventory | Установка доступного запаса запасной единицы в местоположении на абсолютное число (заменяет текущее количество) |
shopline_adjust_inventory | Изменение доступного запаса запасной единицы в местоположении на дельту: положительное добавляет, отрицательное удаляет |
Примеры подсказок
- "Сколько заказов SHOPLINE пришло на этой неделе, и сколько из них не выполнено?"
- "Добавь отслеживание DHL 1234567890 к выполнению заказа #1052."
- "Какие варианты имеют менее 5 единиц на нашем основном складе?"
- "Покажи все заказы клиента Анны Берг."
- "Какие заказы были возвращены в прошлом месяце и на какую сумму?"
Часто задаваемые вопросы
Какой SHOPLINE охватывается? Магазины на myshopline.com через Admin REST API SHOPLINE. Старая платформа SHOPLINE на shoplineapp.com имеет другой API и не охватывается.
Откуда берется токен доступа? Админка SHOPLINE, Apps, Develop Apps: создай частное приложение с необходимыми областями доступа для инструментов и скопируй токен доступа из его API сертификата. Введи также идентификатор магазина.
Какие инструменты установлены выключенными? Никакие. Транзакции и возвраты только для чтения, и каждое изменение (заметки по заказам, выполнения, отслеживание, изменения продуктов и запасов) показывается тебе перед выполнением.
Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да — MCP доступен на тарифах Hobby, Pro и Business.
Следующие шаги
Это руководство помогло?