Сервер Shopify MCP

MCP Server для Shopify API, позволяющий взаимодействовать с данными магазина через GraphQL API. Этот сервер предоставляет инструменты для управления продуктами, клиентами, заказами и т. д.

Функции

• Управление продуктом : поиск и извлечение информации о продукте

• Управление клиентами : загрузка данных клиентов и управление тегами клиентов

• Управление заказами : расширенные запросы и фильтрация заказов

• Интеграция GraphQL : прямая интеграция с API администратора GraphQL от Shopify

• Комплексная обработка ошибок : понятные сообщения об ошибках API и проблемах аутентификации.

Инструменты

1. get-products

   • Получить все продукты или искать по названию

   • Входные данные:

     • searchTitle (необязательная строка): Фильтрация продуктов по названию

     • limit (число): максимальное количество возвращаемых товаров

   • Возврат: отформатированные сведения о продукте, включая название, описание, номер и варианты.

2. get-products-by-collection

   • Получить продукты из определенной коллекции

   • Входные данные:

     • collectionId (строка): идентификатор коллекции, из которой нужно получить продукты

     • limit (необязательное число, по умолчанию: 10): максимальное количество возвращаемых товаров

   • Возврат: Отформатированные сведения о продукте из указанной коллекции.

3. get-products-by-ids

   • Получить продукты по их идентификаторам

   • Входные данные:

     • productIds (массив строк): Массив идентификаторов продуктов для извлечения

   • Возврат: Отформатированные сведения о продукте для указанных продуктов

4. update-product-price

   • Обновить цены на продукцию по ее идентификатору

   • Входные данные:

     • productId (строка): идентификатор продукта для обновления

     • price (строка): Новая цена на продукт

   • Возврат: Ответ на обновление

5. get-variants-by-ids

   • Получить варианты продукта по их идентификаторам

   • Входные данные:

     • variantIds (массив строк): Массив идентификаторов вариантов для извлечения

   • Возврат: Подробная информация о вариантах, включая сведения о продукте

6. get-customers

   • Получите клиентов Shopify с поддержкой пагинации

   • Входные данные:

     • limit (необязательное число): максимальное количество клиентов для возврата

     • next (необязательная строка): Курсор следующей страницы

   • Возвращает: данные о клиентах в формате JSON.

7. tag-customer

   • Добавить теги к клиенту

   • Входные данные:

     • customerId (строка): идентификатор клиента для тега

     • tags (массив строк): теги для добавления клиенту

   • Возвращает: сообщение об успешном или неудачном выполнении.

8. get-orders

   • Получайте заказы с расширенной фильтрацией и сортировкой

   • Входные данные:

     • first (необязательное число): Лимит заказов для возврата

     • after (необязательная строка): Курсор следующей страницы

     • query (необязательная строка): Фильтрация заказов с использованием синтаксиса запроса

     • sortKey (необязательное перечисление): поле для сортировки ('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')

     • reverse (необязательно логическое значение): обратный порядок сортировки

   • Возврат: Форматированные данные заказа

9. get-order

   • Получить единый заказ по идентификатору

   • Входные данные:

     • orderId (строка): идентификатор заказа для извлечения

   • Возврат: Подробная информация о заказе

10. create-discount

• Создайте базовый код скидки

• Входные данные:

  • title (строка): Название скидки

  • code (строка): код скидки, который будут вводить клиенты

  • valueType (enum): Тип скидки («процент» или «фиксированная_сумма»)

  • value (число): Значение скидки (процент в виде десятичной дроби или фиксированной суммы)

  • startsAt (строка): Дата начала в формате ISO

  • endsAt (необязательная строка): Необязательная дата окончания в формате ISO

  • appliesOncePerCustomer (логическое значение): можно ли использовать скидку только один раз для одного клиента

• Возврат: Созданы сведения о скидках

11. create-draft-order

• Создать проект заказа

• Входные данные:

  • lineItems (массив): Массив элементов с вариантомId и количеством

  • email (строка): Электронная почта клиента

  • shippingAddress (объект): Детали адреса доставки

  • note (необязательная строка): Необязательное примечание к заказу

• Возврат: Создан черновик деталей заказа

12. complete-draft-order

• Завершить проект заказа

• Входные данные:

  • draftOrderId (строка): идентификатор черновика заказа для выполнения

  • variantId (строка): идентификатор варианта в проекте заказа

• Возврат: Детали выполненного заказа

13. get-collections

• Получить все коллекции

• Входные данные:

  • limit (необязательное число, по умолчанию: 10): максимальное количество возвращаемых коллекций

  • name (необязательная строка): Фильтровать коллекции по имени

• Возврат: Подробности сбора

14. get-shop

• Получить данные магазина

• Входы: нет

• Возврат: Основная информация о магазине

15. get-shop-details

• Получите расширенную информацию о магазине, включая страны доставки

• Входы: нет

• Возврат: расширенная информация о магазине, включая страны доставки

16. manage-webhook

• Подписывайтесь, находите или отписывайтесь от веб-хуков

• Входные данные:

  • action (перечисление): Действие для выполнения («подписаться», «найти», «отписаться»)

  • callbackUrl (строка): URL-адрес обратного вызова Webhook

  • topic (перечисление): тема веб-перехватчика, на которую нужно подписаться

  • webhookId (необязательная строка): идентификатор веб-перехватчика (требуется для отмены подписки)

• Возвращает: сведения о веб-перехватчике или сообщение об успешном выполнении.

Настраивать

Токен доступа Shopify

Чтобы использовать этот MCP-сервер, вам необходимо создать пользовательское приложение в вашем магазине Shopify:

1. В панели администратора Shopify перейдите в Настройки > Приложения и каналы продаж.

2. Нажмите «Разработать приложения» (возможно, сначала вам потребуется включить предварительный просмотр для разработчиков).

3. Нажмите «Создать приложение».

4. Задайте имя для вашего приложения (например, «Shopify MCP Server»)

5. Нажмите «Настроить области действия API администратора».

6. Выберите следующие области:

   • read_products , write_products

   • read_customers , write_customers

   • read_orders , write_orders

7. Нажмите «Сохранить».

8. Нажмите «Установить приложение».

9. Нажмите «Установить» , чтобы предоставить приложению доступ к данным вашего магазина.

10. После установки вы увидите свой токен доступа к API администратора.

11. Скопируйте этот токен — он вам понадобится для настройки.

Примечание: Храните свой токен доступа в безопасности. Он обеспечивает доступ к данным вашего магазина и никогда не должен передаваться или передаваться в систему контроля версий. Более подробную информацию о том, как создать приложение Shopify, можно найти здесь .

Использование с Claude Desktop

Добавьте в ваш claude_desktop_config.json :

Разработка

1. Клонировать репозиторий

2. Установите зависимости:

3. Создайте файл .env :

4. Создайте проект:

5. Проведите тесты:

Зависимости

• @modelcontextprotocol/sdk — реализация протокола MCP

• graphql-request — клиент GraphQL для API Shopify

• zod - Проверка типа во время выполнения

Внося вклад

Вклады приветствуются! Пожалуйста, сначала прочтите наши Правила по вкладам .

Лицензия

Массачусетский технологический институт

Сообщество

• Обсуждения MCP GitHub

• Сообщить о проблемах

Создано с ❤️ с использованием протокола контекста модели