Как подключить MCP-сервер ВкусВилла к Claude или GPT: пошаговая инструкция

Зачем подключать MCP-сервер ВкусВилла к AI-моделям?

MCP (Model Context Protocol) стал стандартом де-факто для подключения внешних инструментов к языковым моделям. Если вы работаете с Claude или GPT и хотите автоматизировать взаимодействие с сервисами ВкусВилла — заказ продуктов, проверку акций, управление корзиной — интеграция через MCP-сервер это оптимальное решение.

Что вам понадобится перед началом

• API ключ ВкусВилла (получается в личном кабинете разработчика)
• Доступ к Claude Desktop или ChatGPT с поддержкой MCP
• Node.js версии 18+ (для запуска локального MCP-сервера)
• Базовое понимание работы API REST
• Терминал или командная строка

1Получение API ключа ВкусВилла

Первым делом нужно получить доступ к API ВкусВилла. Это официальный способ взаимодействия с их сервисами.

1. Перейдите на developer.vkusvill.ru
2. Зарегистрируйтесь как разработчик (потребуется подтверждение email)
3. В разделе "Мои приложения" создайте новое приложение
4. Выберите необходимые scopes (области доступа):
   • products:read — чтение каталога товаров
   • orders:write — создание заказов
   • cart:manage — управление корзиной
   • promotions:read — получение информации об акциях
5. После создания приложения вы получите:
   • Client ID — публичный идентификатор
   • Client Secret — секретный ключ (храните в безопасности!)
   • API Endpoint — базовый URL API

2Настройка MCP-сервера ВкусВилла

MCP-сервер — это промежуточное звено между AI-моделью и API ВкусВилла. Мы будем использовать официальный или community-driven сервер.

# Клонируем репозиторий MCP-сервера для ВкусВилла
git clone https://github.com/community/mcp-vkusvill-server.git
cd mcp-vkusvill-server

# Устанавливаем зависимости
npm install

# Создаем файл конфигурации .env
cp .env.example .env

# Редактируем .env файл
nano .env

Содержимое .env файла:

# Конфигурация ВкусВилл API
VKUSVILL_CLIENT_ID=your_client_id_here
VKUSVILL_CLIENT_SECRET=your_client_secret_here
VKUSVILL_API_BASE=https://api.vkusvill.ru/v1

# Настройки MCP-сервера
MCP_PORT=3000
MCP_HOST=localhost
LOG_LEVEL=info

3Запуск и тестирование MCP-сервера

После настройки конфигурации запустим сервер и проверим его работоспособность.

# Запуск сервера в development режиме
npm run dev

# Или запуск в production режиме
npm start

# Проверка здоровья сервера
curl http://localhost:3000/health

Если сервер запущен корректно, вы увидите ответ:

{
  "status": "healthy",
  "timestamp": "2024-01-15T10:30:00Z",
  "services": {
    "vkusvill_api": "connected",
    "mcp_protocol": "ready"
  }
}

Для проверки доступных инструментов используйте:

# Получение списка доступных инструментов
curl http://localhost:3000/tools

4Интеграция с Claude Desktop

Claude Desktop имеет встроенную поддержку MCP. Вот как подключить наш сервер:

1. Откройте Claude Desktop
2. Перейдите в настройки (Settings → Developer)
3. Добавьте новую конфигурацию MCP:

{
  "mcpServers": {
    "vkusvill": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-vkusvill",
        "--client-id", "YOUR_CLIENT_ID",
        "--client-secret", "YOUR_CLIENT_SECRET"
      ],
      "env": {
        "VKUSVILL_API_BASE": "https://api.vkusvill.ru/v1"
      }
    }
  }
}

Альтернативный способ — использование MCP Inspector для отладки:

# Установка MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Запуск инспектора с нашим сервером
mcp-inspector --server "node ./server.js"

5Интеграция с ChatGPT/OpenAI через Manus

Для интеграции с GPT или ChatGPT через OpenAI API используем Manus — платформу для создания AI-агентов с поддержкой MCP.

1. Установите Manus CLI:

# Установка через npm
npm install -g @manus/cli

# Или через curl
curl -fsSL https://manus.ai/install.sh | sh

2. Создайте новый проект Manus:

manus init vkusvill-assistant
cd vkusvill-assistant

3. Настройте конфигурацию в manus.config.json:

{
  "name": "VkusVill Assistant",
  "description": "AI assistant for VkusVill shopping",
  "mcpServers": [
    {
      "name": "vkusvill",
      "url": "http://localhost:3000",
      "config": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  ],
  "llm": {
    "provider": "openai",
    "model": "gpt-4-turbo-preview",
    "apiKey": "your_openai_api_key"
  }
}

4. Запустите агента:

manus run

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

Теперь, когда интеграция настроена, можно использовать возможности ВкусВилла через AI.

Пример 1: Поиск продуктов через Claude

Промпт для Claude:
"Пожалуйста, найди молочные продукты на ВкусВилле. Мне нужны:
1. Молоко 3.2% жирности
2. Творог 5%
3. Сметана 15%
Дай мне список с ценами и акциями, если они есть."

Пример 2: Создание заказа через GPT

Промпт для GPT:
"Я хочу заказать продукты на ужин:
- Куриное филе 500г
- Огурцы 3 шт
- Помидоры 4 шт
- Салат айсберг
- Оливковое масло
Проверь наличие в моем городе (Москва), добавь в корзину и создай заказ на доставку сегодня с 18:00 до 20:00."

Распространенные ошибки и их решение

Оптимизация производительности

Для работы в production среде рекомендую следующие оптимизации:

• Кэширование запросов: Redis для кэширования результатов поиска товаров
• Пул соединений: Поддерживайте пул HTTP-соединений к API ВкусВилла
• Асинхронная обработка: Используйте очереди для фоновых задач (создание заказов)
• Мониторинг: Настройте логирование всех запросов и ошибок
• Резервирование: Запустите несколько экземпляров MCP-сервера за балансировщиком нагрузки

FAQ: Часто задаваемые вопросы

Нужно ли платить за API ВкусВилла?

На момент написания статьи API ВкусВилла предоставляется бесплатно для разработчиков, но с ограничениями по количеству запросов. Для коммерческого использования требуется заключение договора.

Можно ли использовать эту интеграцию для автоматических заказов?

Да, но с осторожностью. Рекомендую добавлять подтверждение пользователя для критических операций (создание заказа, оплата).

Поддерживает ли ВкусВилл OAuth 2.0 для авторизации пользователей?

Да, API поддерживает OAuth 2.0 для авторизации действий от имени конкретного пользователя. Это необходимо для работы с корзиной и заказами.

Как часто обновляются данные о товарах и ценах?

Данные обновляются в реальном времени при каждом запросе. Однако для уменьшения нагрузки на API можно кэшировать результаты на 5-10 минут.

Можно ли использовать эту интеграцию с локальными LLM?

Да, если локальная LLM поддерживает MCP протокол. Например, можно использовать Claude Code локально или другие решения с поддержкой MCP.

Заключение

Интеграция MCP-сервера ВкусВилла с Claude или GPT открывает новые возможности для автоматизации покупок и взаимодействия с сервисом. Главные преимущества этого подхода:

• Единый интерфейс для разных AI-моделей
• Безопасность — API ключи хранятся на стороне сервера
• Масштабируемость — можно добавлять новые инструменты без изменения промптов
• Отладка — стандартизированный протокол упрощает разработку

Начните с простых запросов (поиск товаров), затем постепенно добавляйте более сложную логику (формирование корзины, применение промокодов, создание заказов). Помните, что успешная интеграция — это не только техническая настройка, но и понимание бизнес-логики сервиса ВкусВилла.