ВкусВилл MCP-сервер: подключение и проверка корзины

ВкусВилл MCP-сервер: подключение и проверка корзины

MCP-сервер ВкусВилла позволяет подключить каталог продуктов к совместимому ИИ-клиенту и подготовить ссылку на корзину. Заказ оформляйте сами после проверки товаров, адреса и итоговой суммы. Ниже показан безопасный путь через официальный MCP Inspector: он помогает увидеть инструменты сервера без передачи агенту управления вашим аккаунтом.

Что подключается и чего ждать от результата

ВкусВилл назвал сервер экспериментальным и опубликовал адрес https://mcp.vkusvill.ru/mcp в собственном блоге компании. В исходном описании есть поиск товаров, получение карточки и создание ссылки на корзину. Перед работой смотрите текущий список инструментов: набор возможностей может измениться.

Это подключение внешнего сервиса к клиенту, а не установка магазина на компьютер. Если термин пока незнаком, прочитайте как устроен MCP-сервер. Корзина по ссылке ещё не подтверждает наличие товаров по вашему адресу, оформление заказа или оплату.

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

Для проверки используйте компьютер и Node.js: официальная документация MCP Inspector требует версию 22.19.0 или новее. Inspector запускает интерфейс в браузере и показывает ответы сервера. Этот технический тест не требует языковой модели; для дальнейшего диалога с агентом понадобится отдельный клиент и доступ к его модели.

  • Проверьте версию Node.js командой node --version; при отсутствии программы установите её с официального сайта проекта.
  • Выберите обычный продукт без специальных медицинских требований и сложных замен.
  • Не передавайте в проверку адрес, телефон, пароль, банковские сведения или данные другого человека.
  • Оставьте оформление и оплату в привычном сайте или приложении ВкусВилла.

Наличие публичного адреса не гарантирует доступ из каждой сети. При редакционной проверке 5 октября 2026 года запрос инициализации с сервера портала получил HTTP 403; причина отказа не установлена. Поэтому здесь не заявлен успешно выполненный заказ или гарантированное подключение. Если ваш клиент тоже получает отказ, действуйте по разделу диагностики.

Поставить инструмент получится за пару минут. А что он умеет на самом деле, покажут завтра в 12:00 МСК на бесплатном мастер-классе: Codex и Claude Code с нуля и агент, который работает без единой строчки кода.

Хочу на мастер-класс

Как увидеть инструменты сервера

Сначала проверьте соединение и список доступных действий, затем переходите к товарам. Официальный Inspector позволяет открыть веб-интерфейс и подключить удалённый HTTP-сервер; порядок и команда описаны в его руководстве.

npx @modelcontextprotocol/inspector --server-url https://mcp.vkusvill.ru/mcp --transport http
  1. Откройте терминал и выполните команду. npx может предложить загрузить пакет: проверьте, что имя точно @modelcontextprotocol/inspector.
  2. Откройте адрес интерфейса, который напечатан в терминале. Не публикуйте ссылку с одноразовым токеном доступа.
  3. Проверьте адрес сервера и подключитесь. Если соединение завершилось ошибкой, не переходите к созданию корзины.
  4. Откройте список инструментов. Прочитайте описания и схемы параметров поиска, карточки товара и корзины.
  5. Для первого вызова используйте только поиск. Заполняйте поля по текущей схеме интерфейса, не копируйте неизвестные параметры из чужого примера.

В публикации ВкусВилла названы vkusvill_products_search, vkusvill_product_details и vkusvill_cart_link_create (источник компании). Если этих имён нет в текущем списке, ориентируйтесь на описания живого сервера. Не вызывайте похожий инструмент, пока не поняли его действие.

Правило первого прогона: один обычный товар, одна проверенная карточка, затем небольшая корзина. Ошибка на одном товаре означает, что расширять задачу ещё рано.

По теме: MCP-сервер локально: как запустить и проверить в 2026

Как проверить найденный товар

Сверяйте конкретный товар, а не только похожее название. Получив результат поиска, откройте детальную карточку по возвращённому идентификатору и сопоставьте её с исходной потребностью. Если клиент не показывает сведения, откройте товар на сайте вручную.

  • Название: продукт для еды не должен подменяться средством для уборки или товаром другой категории.
  • Фасовка: одна упаковка и один килограмм не означают одинаковое количество.
  • Состав: нужный ингредиент должен подтверждаться карточкой; отсутствие слова в коротком описании не доказывает отсутствие аллергена.
  • Количество: различайте число упаковок и массу одной упаковки.
  • Замена: другой вкус, жирность или состав требуют вашего решения, даже если модель назвала их аналогом.

Безопасный учебный пример: попросите подобрать молоко в упаковке заданного объёма и показать карточку, но не добавлять замену автоматически. Сначала подтвердите вариант, затем разрешите подготовить ссылку. Это правило проверки, а не утверждение о текущем ассортименте.

После установки главный вопрос: что поручить агенту первым делом. На бесплатном мастер-классе завтра в 12:00 МСК задачу ставят голосом, и агент сам открывает браузер, собирает товары с OZON и сводит их в Google-таблицу с рейтингом. В реальном времени, без кода.

Увидеть агента в деле

Как принять корзину без случайной покупки

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

  1. Составьте окончательный перечень: идентификатор товара, название и число упаковок.
  2. Сверьте его с карточками. Удалите неподтверждённые позиции и неясные замены.
  3. В инструменте создания ссылки заполните параметры по его текущей схеме. Сохраните список, которому эта ссылка должна соответствовать.
  4. Откройте ссылку в браузере и проверьте домен магазина, состав корзины и количество.
  5. Укажите адрес обычным способом на сайте. Повторно проверьте наличие, цену, доставку и итог перед подтверждением заказа.
  6. Если корзина отличается от согласованного списка, исправьте её вручную и не продолжайте автоматический сценарий.

Для диалога с агентом используйте клиент с поддержкой удалённого MCP. Порядок настройки зависит от программы: разбор MCP в OpenCode помогает проверить её собственную конфигурацию. Не смешивайте файл настроек одной программы со схемой другой.

По теме: Как создать MCP сервер на Python: код и проверка

Что делать при отказе или неправильном результате

Разделяйте сбой подключения и ошибку выбора продукта. Если сервер не открылся, изменение промпта про молоко не поможет. Если связь есть, но товар не подходит, сначала уточните параметры поиска и сверку карточки.

  • HTTP 403: перепроверьте официальный адрес и сообщение клиента. Причина может зависеть от доступа, но по одному коду её установить нельзя. Не отключайте защиту компьютера и не вводите пароль магазина в случайный посредник.
  • Таймаут: повторите один небольшой запрос позже; не запускайте параллельно много одинаковых поисков.
  • Нет нужного инструмента: заново получите список и сравните описания. Старый пример может относиться к другой версии сервера.
  • Неверная позиция: уточните категорию, упаковку и состав, затем повторите поиск. Не исправляйте только красивый текст ответа.
  • Ссылка есть, корзина пустая или отличается: считайте подготовку незавершённой и соберите покупку вручную на сайте.

Когда этот сервер не пригодится

Для срочной покупки надёжнее использовать привычное приложение магазина. Экспериментальный сервер и ИИ-клиент могут быть недоступны; условия доставки по подготовленной ссылке придётся проверять отдельно. При аллергии, лечебном питании или покупке для человека с медицинскими ограничениями не поручайте модели принимать решение о составе.

Не превращайте эту инструкцию в корпоративную закупку с автоматическими согласованиями. Для внутренних заявок, резервов и открытых поставок нужен отдельный процесс проверки закупок. Здесь конечный результат ограничен проверяемой корзиной для личного просмотра.

Частые вопросы

MCP-сервер оформляет и оплачивает заказ?

В рассматриваемом сценарии результатом служит ссылка на корзину. Оформление и оплату проверяйте и выполняйте сами на сайте магазина.

Обязательно подключать языковую модель?

Для просмотра инструментов через Inspector нет. Для диалога, в котором агент сам выбирает и вызывает инструменты, нужна модель в совместимом клиенте.

Почему ссылка сервера не открывается как обычная страница?

Это адрес протокольного подключения. Проверяйте его через MCP-клиент; результат открытия в обычной вкладке работоспособность не подтверждает.

Что делать, если доступ запрещён?

Сохраните сообщение об ошибке, проверьте официальный адрес и остановите тест. Подготовьте корзину вручную; успешный ответ чужого клиента не гарантирует доступ из вашей сети.

Корзина ВкусВилла собирается через MCP, оформление остаётся за вами. Завтра в 12:00 МСК на бесплатном мастер-классе агент делает похожую работу масштабнее: сам собирает 15 товаров на OZON и сводит их в таблицу с рейтингом.

Посмотреть бесплатно
Разборы, кейсы и фишки вайбкодинга каждую неделю в телеграм-канале «Яков вайбкодит».
Смотрите ИИ-агента в деле: завтра в 12:00 МСК, бесплатно Записаться