Агент берёт с сервера свойства нужного компонента VKUI: тип, значение по умолчанию и описание по-русски. У кнопки Button на прогоне их было 28, у модального окна ModalPage 31.
По тегу сервер подбирает компоненты под задачу: на тег forms пришло 27 компонентов для форм, от полей ввода до календаря и загрузки файлов.
Готовые примеры кода с русскими подписями приходят по имени компонента или хука, а полную страницу документации сервер присылает в Markdown.
К переходу на VKUI 8 у сервера припасены советы по компонентам, хукам и отдельным свойствам, на прогоне их пришло 40. В совет бывает вложен код до и после, у Alert он был.
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Промпт для агента
Подключи MCP-сервер «VKUI» версии 1.1.0. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог smyslokod.ru, проверено 10.10.2026):
- имя в конфиге: vkui
- официальный источник: https://github.com/VKCOM/VKUI/tree/master/packages/vkui-mcp
- запуск: npx -y @vkontakte/vkui-mcp@1.1.0
Правила:
1. Не ставь Node.js, uv или Docker без моего «да». Не хватает - остановись и скажи, что поставить и откуда.
2. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
3. Перед правкой конфига сделай его резервную копию.
Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь окружение: node --version и npx --version (нужен Node.js 18 или новее). Скажи, что нашёл.
2. Проверь, нет ли уже сервера с таким именем: `claude mcp get vkui` (в Codex: `codex mcp list`).
3. Подключи сервер:
Claude Code: claude mcp add --scope user --env 'VKUI_VERSION=${VKUI_VERSION}' --transport stdio vkui -- npx -y @vkontakte/vkui-mcp@1.1.0
Codex: добавь в ~/.codex/config.toml
[mcp_servers.vkui]
command = "npx"
args = ["-y", "@vkontakte/vkui-mcp@1.1.0"]
env_vars = ["VKUI_VERSION"]
startup_timeout_sec = 30
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера 10 инструментов, перечисли их. Сделай пробный запрос: «Через vkui покажи свойства кнопки Button и какие значения бывают у mode и size». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove vkui --scope user` (в Codex: `codex mcp remove vkui`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/vkui#problemy
Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.
Что нужно на компьютере: Node.js 18 или новее.
Ключ: не нужен.
Для запуска хватит Node.js, на прогоне стоял Node.js 22. Ключ и аккаунт заводить не надо. Справку по компонентам и хукам сервер берёт с сервера VK vkui-mcp.cdn-vk.ru и до перезапуска держит полученные ответы в памяти, а советы по переходу на VKUI 8 лежат внутри пакета. Без переменной VKUI_VERSION ответы придут по последней версии библиотеки. Если проект на VKUI 7 или на старой восьмой версии, сначала сверь номер со списком в описании переменной: справка на сервере VK есть для восьмой версии начиная с 8.0.1 и для семи выпусков седьмой. Нашёл свою версию - впиши её в VKUI_VERSION.
Проверь, что работает
Пробный запрос
Через vkui покажи свойства кнопки Button и какие значения бывают у mode и size
Что должно получиться: Промпт просит агента вызвать get_component_metadata с компонентом Button. Прямой вызов через mcp-probe вернул 28 свойств: mode со значениями link, primary, secondary, tertiary и outline, по умолчанию primary, и size со значениями s, m и l, по умолчанию s. Как ответит сам агент, мы не проверяли. Если вызова vkui в ответе нет, посмотри командой /mcp, подключён ли сервер.
Что можно сделать
4 сценария
Форма записи в мини-приложении ВКонтакте
На тег forms сервер вернул 27 компонентов. В примерах FormItem нашлись поле с заголовком, пояснение под полем и состояния ошибки и успеха, все с подписями по-русски. Форму целиком агентом на прогоне не собирали.
list_components_by_tag с тегом forms даёт компоненты для форм.
get_examples по FormItem присылает примеры поля с заголовком и состояниями проверки.
Промпт
Через подключение vkui собери в моём мини-приложении ВКонтакте на React форму записи: имя, телефон, дата, комментарий и кнопка «Записаться». Имя и телефон обязательны, под пустым полем показывай ошибку. Перед тем как писать код, найди через сервер компоненты для форм и посмотри примеры FormItem.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Поиск по тегам работает с VKUI 8.2.0. Для седьмой версии проси агента взять список через list_components.
Какую кнопку где ставить
Здесь пригодится страница документации Button на 13 725 знаков. В ней пять режимов кнопки и подсказки, где какой ставить: primary для «Сохранить» и «Отправить», secondary для «Отмена» и «Редактировать». Свойства пришли отдельным вызовом, их 28. Как агент применит это к твоему экрану, не проверяли.
Страницу с разделом «Режимы отображения» присылает get_docs.
Допустимые значения mode, appearance и size есть в ответе get_component_metadata.
Промпт
Посмотри через vkui кнопки на экране оформления заказа в моём проекте: какие режимы mode и appearance стоят у кнопок «Оплатить», «Назад» и «Подробнее о доставке», и подходят ли они по документации Button. Предложи правки списком, код пока не меняй.
Бесплатно: почта или сразу Телеграм-канал клуба
Модальное окно с подтверждением
У ModalPage сервер насчитал 31 свойство, среди них open, onClose, header и footer. К окну есть хук useModalManager с 13 параметрами, по описанию он управляет окнами ModalPage и ModalCard. Готовое окно по этим ответам мы не собирали.
Свойства окна приходят из get_component_metadata с именем ModalPage.
Хук для управления окнами описан в ответе get_hook_metadata.
Промпт
Добавь в мини-приложение модальное окно с деталями заказа и кнопкой «Подтвердить» внизу. Открывай его по нажатию на заказ в списке. Сначала сверь в подключении vkui свойства ModalPage и хук useModalManager, потом покажи код.
Бесплатно: почта или сразу Телеграм-канал клуба
Что поправить при переходе на VKUI 8
Советов по восьмой версии пришло 40, от целых компонентов до отдельных свойств. По Alert ответ пришёл за 2 мс: обработчик onClose переименован в onClosed, рядом код до и после. Поиск этих мест в твоём проекте остаётся агенту, этот шаг на прогоне не делали.
list_migration_targets перечисляет, что меняется.
get_migration_target по имени из списка объясняет правку. У Alert в ответе был ещё код до и после.
Промпт
Возьми у сервера vkui список компонентов и хуков, которые меняются при переходе на VKUI 8, и найди их в моём проекте. По каждому найденному месту покажи, что поменять, по рекомендации сервера. Файлы пока не меняй.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Список миграций лежит внутри пакета, в сеть за ним сервер не ходит.
Пример работы
редакция, прогон при проверке 10.10.2026
Задача
Подобрать компоненты для формы и сверить кнопку в мини-приложении
Промпт
Через подключение vkui найди компоненты для форм и покажи свойства Button
Что сделал агент
list_components за 7 мс перечислил 136 компонентов с тегами.
По тегу forms пришло 27 компонентов, среди них FormItem, Input, Select и DateInput.
У Button пришло 28 свойств с типом и описанием по-русски, значение по умолчанию указано у шести.
На имя Buttn сервер ответил ошибкой 404 без подсказки верного имени.
Результат
Все 13 вызовов заняли от 2 до 127 мс, ключ не понадобился, сервер ходил только на vkui-mcp.cdn-vk.ru. Вызовы делал mcp-probe, сам агент Claude Code этот промпт не выполнял.
Инструменты
10 · описания около 1,1 тыс. токенов
Жёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если интерфейс собран на другой библиотеке компонентов или без React, сервер не пригодится, потому что справка у него только по VKUI, а сама библиотека сделана для React.
Частые проблемы
7
Ответ «Не удалось загрузить» с адресом, который кончается на buttn.json, и кодом 404
В имени компонента опечатка, и сервер не нашёл страницу с таким адресом. Верное имя он не подсказывает. Попроси агента сначала взять список имён через list_components, а потом запросить компонент.
У компонента нет тегов, а поиск по тегам и полная документация для выбранной версии не открываются
В VKUI_VERSION стоит старая версия. По документации VKUI теги появились в 8.2.0, а get_docs работает с 8.3.0. На прогоне с версией 7.11.7 у Button не было поля tags. Для проекта на седьмой версии хватит get_component_metadata и get_examples. Если проект уже на 8.3.0 или новее, поставь эту версию в VKUI_VERSION.
Свойство из ответа сервера не работает в проекте
Без VKUI_VERSION сервер отвечает по последней версии VKUI, а в проекте может стоять другая. Посмотри версию @vkontakte/vkui в package.json. Если это 8.0.1 или новее либо одна из седьмых версий из описания VKUI_VERSION, впиши её в эту переменную подключения. Для остальных версий справки на сервере VK нет: на 8.0.0 и 7.11.6 он ответил 404.
Агент не видит инструментов сервера
Клиент не перезапущен после подключения: Claude Code читает подключения при старте сессии. Закрой и открой сессию, потом проверь: claude mcp list.
«spawn npx ENOENT» при запуске
Клиент не видит npx: приложения с иконкой не читают PATH из настроек терминала. Пропиши полный путь к npx. Узнать его: which npx на Mac, where npx на Windows.
«Unsupported engine» или падение при старте
Старая версия Node.js. Нужна 18 или новее, проверить: node --version.
Codex: сервер не успевает запуститься
Codex ждёт запуска 10 секунд, а первый запуск npx скачивает пакет дольше. Во вкладке Codex уже стоит startup_timeout_sec = 30, возьми фрагмент оттуда.
Только то, что агент передаёт в вызов: имя компонента или хука, тег, имя цели миграции. Файлы проекта и разговор сервер не читает.
Куда уходят данные
Данные уходят: VK, Россия.
Что может изменить
Сервер ничего не меняет: все его инструменты только читают справку и на диск не пишут. Код в файлы проекта по этой справке добавляет уже агент.
Наша проверка
Пакет @vkontakte/vkui-mcp выпускает команда VK: он лежит в репозитории VKCOM/VKUI под лицензией MIT, на него ссылается документация vkui.io, а версию 1.1.0 опубликовал в npm сборщик GitHub Actions этого репозитория. Мы прочитали код сервера. Команд он не запускает и с файлами на диске не работает. Скриптов установки в пакете тоже нет, мы проверили package.json. Все запросы идут на один адрес, vkui-mcp.cdn-vk.ru, его можно сменить переменной DATA_URL. Имя компонента сервер подставляет в путь на этом адресе. Путь с ../ на прогоне ушёл на тот же сервер VK и получил 404, на другие сайты такое имя запрос не уводит. Инструкций и подсказок у сервера нет, в описаниях инструментов скрытых указаний мы тоже не нашли. В одноразовой песочнице Ubuntu 24.04.5 мы сделали 13 вызовов и задели каждый из 10 инструментов, ответы пришли за 2-127 мс. В журнале соединений сервера, запущенного через mcp-probe, только адреса VK и реестр npm, туда ходит сам npx. Claude Code при проверке подключения соединялся ещё и со своими адресами. В базе OSV записей по пакету и по 94 пакетам его зависимостей нет, npm audit тоже чист. Версия в команде закреплена.
Версия
В командах закреплена версия 1.1.0: ставится ровно то, что мы проверили.
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
