Shopify Multi Store

Этот плагин Codex позволяет держать несколько магазинов Shopify Admin в одной задаче. У каждого магазина есть отдельный псевдоним и токен доступа, поэтому переключение магазинов не отключает другой магазин.

Требования

• macOS с доступом к Keychain

• Node.js 20 или новее

• Токен доступа Shopify Admin API для каждого магазина

Related MCP server: Shopify Storefront MCP Server

Установка

Клонируйте репозиторий и установите его зависимости:

git clone https://github.com/alex-brecher/shopify-multi-store.git
cd shopify-multi-store
npm ci
npm run build

Установите локальный плагин в Codex, используя клонированный каталог. Репозиторий включает манифест плагина Codex и конфигурацию сервера MCP.

Добавление магазина

1. Откройте терминал в каталоге этого плагина.

2. Выполните эту команду:

npm run configure -- add

3. Введите короткий псевдоним магазина.

4. Введите постоянный домен *.myshopify.com.

5. Введите токен доступа Admin API.

6. Повторите команду для каждого магазина.

Скрипт сохраняет каждый токен в macOS Keychain под именем службы codex-shopify-multi-store. Файл конфигурации не содержит токенов доступа.

Импорт существующего набора инструментов

Импортируйте совместимый файл stores.json для нескольких магазинов:

npm run import-legacy -- /absolute/path/to/stores.json

Импорт сохраняет каждый токен в macOS Keychain. Он изменяет оба файла конфигурации на доступ только для владельца. Удалите устаревший файл учётных данных, когда он больше не нужен.

Используйте только те области Admin API, которые нужны каждой задаче. Shopify управляет доступными данными через эти области.

Управление магазинами

Выведите список настроенных магазинов:

npm run configure -- list

Удалите один магазин и его токен Keychain:

npm run configure -- remove store-alias

Доступные инструменты

• shopify_list_stores выводит список псевдонимов подключённых магазинов.

• shopify_get_shop_info получает данные об одном магазине.

• shopify_graphql_query выполняет запрос Admin GraphQL только для чтения.

• shopify_graphql_mutation изменяет один магазин после точной авторизации.

Каждое действие с магазином требует псевдоним магазина. Это требование снижает риск изменения не того магазина.

Безопасность

• Никогда не сохраняйте в коммитах токены доступа, секреты клиента OAuth, файлы .env или файлы stores.json с учётными данными.

• Предоставляйте только те области Shopify Admin API, которые необходимы для поставленных задач.

• Подтвердите целевой магазин перед выполнением мутации.

• См. SECURITY.md с инструкциями по сообщению об уязвимостях.

Разработка

npm ci
npm test

Лицензия

MIT