Руководство по коннектору7 мин чтенияMCP-инструментов: 237 языков

SHOPLINE MCP для Gemini CLI: заказы и остатки

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.

HCАвтор: команда HelpCodeОбновлено 7 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

SHOPLINE

SHOPLINE

SHOPLINE stores (myshopline.com) through the Admin REST API: orders, fulfillments and tracking, transactions and refunds, products and variants, customers, locations and inventory levels. Private app access token.

инструментов

23

Регион

INTL

Категория

Электронная коммерция

Аутентификация

Bearer Token

Требуемые env-vars

SHOPLINE_HANDLESHOPLINE_ACCESS_TOKEN
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.

Пошаговая настройка

Подключи SHOPLINE к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи SHOPLINE в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для SHOPLINE

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

SHOPLINE · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

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

SHOPLINE + Gemini

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.

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

Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

SHOPLINE_HANDLE, SHOPLINE_ACCESS_TOKEN

Шаг 1 — Получи учетные данные

Настройка занимает около 5 минут.

  1. Войди в админку SHOPLINE по адресу https://admin.myshopline.com и открой Apps, затем Develop Apps (в правом верхнем углу), и создай частное приложение.
  2. Установи необходимые области доступа для инструментов: read_orders, write_orders, read_products, write_products, read_customers, read_inventory, write_inventory, read_location, read_assigned_fulfillment_orders и write_assigned_fulfillment_orders (только области чтения достаточно для инструментов чтения).
  3. Открой API certificate приложения и скопируй access token в SHOPLINE_ACCESS_TOKEN. Токен частного приложения действителен в течение 3 лет и может быть обновлён там; удаление приложения аннулирует его.
  4. Введи идентификатор магазина, первую часть <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 — Добавь коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. Сохрани файл и перезапусти gemini.
  3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
  4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты 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 сертификата. Введи также идентификатор магазина.

Какие инструменты установлены выключенными? Никакие. Транзакции и возвраты только для чтения, и каждое изменение (заметки по заказам, выполнения, отслеживание, изменения продуктов и запасов) показывается тебе перед выполнением.

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

Это руководство помогло?

Подключи SHOPLINE к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи SHOPLINE в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

SHOPLINE MCP для ChatGPT: заказы и остатки

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.

Коннекторы

SHOPLINE MCP для Claude: заказы и остатки

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.

Коннекторы

SHOPLINE MCP для Microsoft Copilot

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.

Коннекторы

SHOPLINE MCP для Cursor: товары и остатки

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.

Коннекторы

SHOPLINE MCP для Meta Muse: заказы и остатки

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.

Коннекторы

SHOPLINE MCP-сервер: заказы, товары и остатки

Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнения и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.