Кратко
Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнения и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.
Пошаговая настройка
Подключи SHOPLINE к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи SHOPLINE в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для SHOPLINE
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, кликни Connectors → SHOPLINE, вставь свои учетные данные, создай ключ API MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
SHOPLINE
Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнения и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.
Настройка
Настройка занимает около 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 сертификат приложения и скопируй токен доступа в
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 и меньшие лимиты для больших магазинов.
Предварительные условия: SHOPLINE_HANDLE, SHOPLINE_ACCESS_TOKEN
Установи коннектор локально
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
Открой http://localhost:3000/connectors/store, выбери 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, штрих-кодом, весом… |
shopline_count_products | Подсчет продуктов, соответствующих фильтрам (status, collection, dates): ответ с количеством. Только для чтения |
shopline_update_product | Изменение продукта: title, subtitle, description (body_html), status (активный публикует, черновик скрывает, архивированный архивирует), vendor, tags… |
shopline_list_product_variants | Список вариантов продукта: id, sku, штрих-код, цена, цена сравнения, option1 до option5, вес, inventory_quantity, inventory_policy… |
shopline_update_variant | Изменение варианта: цена и цена сравнения (десятичные строки в валюте магазина), sku, штрих-код, вес с единицей измерения веса… |
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), или по точным критериям, таким как теги или orders_count (query). То же… |
shopline_list_customer_orders | Список заказов одного клиента с теми же полями заказа, что и shopline_list_orders. До 100 на страницу |
shopline_list_locations | Список местоположений запасов (склады и магазины): id, name, address, active и является ли это местоположением по умолчанию |
shopline_get_inventory_items | Чтение запасов (по одному на вариант): id, sku, отслеживаемый, стоимость и страна происхождения. 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 единиц на нашем основном складе?"
- "Покажи все заказы клиента Анны Берг."
- "Какие заказы были возвращены в прошлом месяце и на какую сумму?"
Следующие шаги
Это руководство помогло?