(пожалуйста, оставьте звезду, если хотите!)

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

** 📦 Название посылки: shopify-mcp** ** 🚀 Команда: shopify-mcp (НЕ shopify-mcp-server)**

Особенности

• Управление продуктом: Полный CRUD для продуктов, вариантов и опций (8 инструментов)
• Управление клиентами: полное управление CRUD, объединением и управлением адресами (8 инструментов)
• Управление заказами: умный поиск, отмена, закрытие/открытие, пометка как оплаченная, выполнение, возврат средств (10 инструментов)
• Управление метаполями: Получение, установка и удаление метаполей на любом ресурсе (3 инструмента)
• Управление запасами: Установка абсолютных объёмов запасов в местах (1 инструмент)
• Управление тегами: Добавление/удаление тегов на любом ресурсе, который можно отметить (1 инструмент)
• Пагинация и сортировка: Пагинация и ключи сортировки на основе курсора во всех запросах списка
• Расширенная фильтрация: Синтаксис запросов Shopify через проход для всех конечных точек списка
• Интеграция с GraphQL: Прямая интеграция с GraphQL Admin API Shopify (2026-01)
• Комплексная обработка ошибок: Очищение сообщений об ошибках для API и вопросов аутентификации

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

1. Узел.

Shopify MCP Server

(please leave a star if you like!)

MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.

📦 Package Name: shopify-mcp 🚀 Command: shopify-mcp (NOT shopify-mcp-server)

Features

• Product Management: Full CRUD for products, variants, and options (8 tools)
• Customer Management: Full CRUD, merge, and address management (8 tools)
• Order Management: Smart lookup, cancel, close/open, mark as paid, fulfillment, refunds (10 tools)
• Metafield Management: Get, set, and delete metafields on any resource (3 tools)
• Inventory Management: Set absolute inventory quantities at locations (1 tool)
• Tag Management: Add/remove tags on any taggable resource (1 tool)
• Pagination & Sorting: Cursor-based pagination and sort keys on all list queries
• Advanced Filtering: Pass-through Shopify query syntax for all list endpoints
• GraphQL Integration: Direct integration with Shopify’s GraphQL Admin API (2026-01)
• Comprehensive Error Handling: Clear error messages for API and authentication issues

Prerequisites

1. Node.js (version 18 or higher)
2. A Shopify store with a custom app (see setup instructions below)

Setup

Authentication

This server supports two authentication methods:

Option 1: Client Credentials (Dev Dashboard apps, January 2026+)

As of January 1, 2026, new Shopify apps are created in the Dev Dashboard and use OAuth client credentials instead of static access tokens.

1. From your Shopify admin, go to Settings > Apps and sales channels
2. Click Develop apps > Build app in dev dashboard
3. Create a new app and configure Admin API scopes:
   • read_products, write_products
   • read_customers, write_customers
   • read_orders, write_orders
4. Install the app on your store
5. Copy your Client ID and Client Secret from the app’s API credentials

The server will automatically exchange these for an access token and refresh it before it expires (tokens are valid for ~24 hours).

Option 2: Static Access Token (legacy apps)

If you have an existing custom app with a static shpat_ access token, you can still use it directly.

Usage with Claude Desktop

Client Credentials (recommended):

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--clientId",
        "",
        "--clientSecret",
        "",
        "--domain",
        ".myshopify.com"
      ]
    }
  }
}

Static Access Token (legacy):

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [