Кратко
Магазины SHOPLINE (myshopline.com) через Admin REST API: заказы, выполнение и отслеживание, транзакции и возвраты, продукты и варианты, клиенты, местоположения и уровни запасов. Токен доступа для частного приложения.
Пошаговая настройка
Подключи SHOPLINE к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи SHOPLINE в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для SHOPLINE
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → SHOPLINE, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
SHOPLINE + Microsoft Copilot
Магазины 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 — Добавь коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
SHOPLINE. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
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 сертификата. Введи также идентификатор магазина.
Какие инструменты установлены выключенными? Никакие. Транзакции и возвраты только для чтения, и каждое изменение (заметки по заказам, выполнения, отслеживание, изменения продуктов и запасов) показывается тебе перед выполнением.
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
Это руководство помогло?