MCP-сервер с авторизацией: что мы сделали, чтобы это было безопасно

Привет! У нас новость: ВкусВилл приготовил MCP-сервер с авторизацией!

Адрес тот же, mcp.vkusvill.ru/mcp, а для доступа к полному функционалу пройдите регистрацию https://vkusvill.ru/oauth/registration/ и авторизацию по ссылке от вашего агента. Подробности далее.

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

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

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

Очевидно, нужен доступ в личный кабинет. И он должен удовлетворять требованиям информационной безопасности:

– Агент входит под своими учетными данными.

– У агента нет доступа к персональным данным клиента.

– Человек выбирает, что готов делегировать агенту.

– Человек может отозвать доступ.

Этим условиям удовлетворяет протокол OAuth 2.0, который к тому же является рекомендуемым способом авторизации в спецификации MCP.

Итак, наше решение основано на OAuth 2.0 + PKCE и предполагает следующий процесс:

Шаг 1: Регистрация OAuth-клиента

Чтобы зарегистрировать клиента авторизации, перейдите по ссылке https://vkusvill.ru/oauth/registration/ и следуйте инструкции.

В настоящее время возможно создать только персонального агента — учетные данные OAuth-клиента будут привязаны к карте лояльности создателя. Это значит, что созданный клиент авторизации сможет запросить доступ только к его личному кабинету.

Скоро мы добавим возможность регистрировать OAuth-клиента, способного работать на нескольких людей. И, кстати, прорабатываем партнерскую программу. Оставьте заявку, если хотите подключиться к тестированию.

Redirect URI — это адрес веб-страницы или приложения, куда OAuth-сервер ВкусВилла направит временный код авторизации после того, как пользователь подтвердит доступ. У платформ агентов есть свой redirect URI. Уточните в документации и укажите его. На момент написания статьи URI у ChatGPT необходимо получить из окна создания плагина, у Claude.ai — https://claude.ai/api/mcp/auth_callback. Если ваш агент на OpenClaw или Hermes, то, скорее всего, у вас нет публичного адреса, который слушает агент. Тогда выбираете «У моего сервиса нет публичного URI».

Результат: в OAuth-сервере ВкусВилла заведен клиент авторизации, привязанный к вашей карте лояльности.

Шаг 2: Подключение к MCP серверу и передача учетных данных агенту

После регистрации на указанную почту придет письмо с учетными данными. Их необходимо передать вашему агенту, чтобы он имел доступ к тулам под авторизацией. Как это сделать, можно узнать у самого агента или в документации. Главное — ни в коем случае не пишите учетные данные в чат агенту и не передавайте третьим лицам/в недоверенные сервисы, т. к. это чувствительные данные, открывающие доступ к вашему личному кабинету.

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

Адрес сервера: mcp.vkusvill.ru/mcp.

Результат: ваш агент подключен к MCP-серверу ВкусВилла и может запросить авторизацию.

Шаг 3: Авторизация агента

При первом обращении к MCP-серверу агент запросит авторизацию. Для этого он сгенерирует ссылку, по которой человеку необходимо пройти и выбрать, какие действия и данные будут доступны агенту (scopes). После отправки формы пользователь и код авторизации будут направлены на redirect URI (указан на шаге 1). Если это был localhost и ваш агент развернут в облаке, необходимо скопировать и передать ему текст из адресной строки страницы, открывшейся после отправки. Временный код агент обменяет на JWT access token, срок жизни которого 24 часа. То есть на данный момент по истечении этого времени необходимо снова повторить этот шаг.

Результат: у вашего агента есть JWT access token со скоупами, которые вы одобрили.

Шаг 4: Использование тулов с авторизацией

Вызывая тул, агент передает и JWT access token. MCP-сервер проверяет скоупы токена и исполняет только согласованное. Таким образом, агент не сможет выполнить действие, которое ему на предыдущем шаге не одобрил пользователь.

На сегодняшний день авторизованному агенту с максимальными скоупами доступно:

– Тул публичного MCP-сервера;

– Тул поиска по каталогу, релевантному для адреса, установленного в личном кабинете ВкусВилл;

– Тул просмотра истории онлайн-заказов;

– Тул просмотра любимого продукта;

– Тул просмотра персональных скидок («6 скидок»).

Мы продолжим добавлять тулы, актуальный список вы можете найти на странице MCP-сервера mcp.vkusvill.ru/mcp. И ваш агент, конечно, тоже имеет способ запросить список тулов (tools/list).

Результат: ваш персональный агент готов собрать подходящую вам корзину.

Заключение

Этот релиз — минимально возможный инкремент с учетом ваших комментариев и идей. Одновременно с расширением возможностей агента мы работаем над повышением защищенности личного кабинета клиента. А значит, появятся: – Мгновенный отзыв доступа – Автоматическое обновление access token – Тулы программы лояльности и заказа – Панель управления доступами.

Будем ждать в форме обратной связи ваши идеи, как еще улучшить агентный опыт при работе с MCP-сервером ВкусВилла.

Впереди много интересного! Узнавать об обновлениях можно на странице сервера mcp.vkusvill.ru/mcp и на нашей странице на github.