@stronger-ecommerce/gadget-mcp

Универсальный MCP-сервер с правами только на чтение для любого приложения Gadget. Запрашивайте любую модель через интроспекцию GraphQL — создание клиента не требуется.

Создано Stronger eCommerce.

Быстрая настройка (рекомендуется)

Запустите интерактивный мастер настройки из директории вашего проекта Gadget. Он автоматически определяет слаг вашего приложения из .gadget/sync.json и записывает конфигурацию.

npx @stronger-ecommerce/gadget-mcp setup

Мастер выполнит следующие действия:

1. Определит слаг вашего приложения из .gadget/sync.json (если он есть)

2. Запросит ваш API-ключ и окружение

3. Выведет готовую команду claude mcp add для Claude Code

4. Автоматически запишет ваш ~/.cursor/mcp.json для Cursor

Ручная настройка

1. Получите API-ключ для продакшена

Перейдите по адресу https://<your-app>.gadget.app/edit/settings/api-keys и создайте ключ с доступом на чтение.

2. Регистрация в Claude Code

claude mcp add my-app-gadget \
  -e GADGET_APP=my-app \
  -e GADGET_API_KEY=your_key_here \
  -- npx @stronger-ecommerce/gadget-mcp

Регистрируйте несколько приложений под разными именами:

claude mcp add app-one-gadget \
  -e GADGET_APP=my-first-app \
  -e GADGET_API_KEY=key1 \
  -- npx @stronger-ecommerce/gadget-mcp

claude mcp add app-two-gadget \
  -e GADGET_APP=my-second-app \
  -e GADGET_API_KEY=key2 \
  -- npx @stronger-ecommerce/gadget-mcp

3. Регистрация в Cursor

Добавьте в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "app-one-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-first-app",
        "GADGET_API_KEY": "key1"
      }
    },
    "app-two-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-second-app",
        "GADGET_API_KEY": "key2"
      }
    }
  }
}

Переменные окружения

Инструменты

Пример использования

После подключения спросите Claude:

• "List the models in my Gadget app"

• "Show me the fields on the shopifyOrder model"

• "Find orders where email is customer@example.com"

• "Get all records with errors"

Будущие функции

Идеи и заметки об исследованиях (включая логи / интеграцию ggt для агентов) находятся в FUTURE_FEATURES.md.

Участие в разработке

Сообщения об ошибках и пулл-реквесты приветствуются!

• Нашли ошибку? Откройте issue

• Есть исправление или новая функция? Сделайте форк репозитория, внесите изменения и откройте PR в ветку main

• Для значительных изменений сначала откройте issue, чтобы мы могли согласовать подход

Локальный запуск

git clone https://github.com/Stronger-eCommerce/gadget-mcp
cd gadget-mcp
npm install
npm run build
npm test

О проекте

Сделано с ♥ компанией Stronger eCommerce — разработка на Shopify и eCommerce-операции.