Агент получает список всех 98 компонентов библиотеки, у большинства есть описание на русском: например, PhoneInput для мобильного номера, AmountInput для суммы, BankCard для номера карты или счёта. У Confirmation и Modal описания пустые.
По имени компонента агент видит его свойства с типами и значениями по умолчанию. У PhoneInput их 38, у таблицы Table шесть, и к ним ещё составные части: шапка, ячейка с сортировкой, раскрывающаяся строка, пагинация.
Агент берёт код готовых примеров из документации: поле телефона с подсказкой +7 000 000 00 00, таблицу, где строки сортируются по дате и сумме, форму ввода кода подтверждения в шести состояниях.
При обновлении библиотеки агент запрашивает, что поменялось в компоненте между двумя версиями, и по Select между 50.0.0 и 50.26.1 сервер вернул 11 записей.
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Промпт для агента
Подключи MCP-сервер «Альфа-Банк core-components» версии 0.2.3. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог smyslokod.ru, проверено 15.10.2026):
- имя в конфиге: core-components-mcp
- официальный источник: https://github.com/core-ds/core-components/tree/master/packages/mcp
- запуск: npx -y @alfalab/core-components-mcp@0.2.3
Правила:
1. Не ставь Node.js, uv или Docker без моего «да». Не хватает - остановись и скажи, что поставить и откуда.
2. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
3. Перед правкой конфига сделай его резервную копию.
Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь окружение: node --version и npx --version (нужен Node.js 24 или новее). Скажи, что нашёл.
2. Проверь, нет ли уже сервера с таким именем: `claude mcp get core-components-mcp` (в Codex: `codex mcp list`).
3. Подключи сервер:
Claude Code: claude mcp add --scope user --transport stdio core-components-mcp -- npx -y @alfalab/core-components-mcp@0.2.3
Codex: codex mcp add core-components-mcp -- npx -y @alfalab/core-components-mcp@0.2.3
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера 4 инструмента, перечисли их. Сделай пробный запрос: «Через core-components-mcp найди компонент для мобильного номера и покажи его пример». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove core-components-mcp --scope user` (в Codex: `codex mcp remove core-components-mcp`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/alfa-core-components#problemy
Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.
Что нужно на компьютере: Node.js 24 или новее.
Ключ: не нужен.
Команда подключения: claude mcp add --scope user core-components-mcp -- npx -y @alfalab/core-components-mcp@0.2.3, пакет приходит из реестра npm. Ключ и регистрация не нужны. В package.json пакет просит Node.js 24 или новее, через npx мы запускали его на Node.js 24. Справка лежит внутри пакета (5,2 МБ), поэтому интернет нужен только npx, чтобы его скачать. Сервер отвечает по библиотеке версии 50.26.1 и версию в твоём проекте не проверяет. Если у тебя стоит другая, сверяй свойства с историей изменений компонента, её сервер тоже отдаёт.
Проверь, что работает
Пробный запрос
Через core-components-mcp найди компонент для мобильного номера и покажи его пример
Что должно получиться: Здесь агенту нужны component_list и component_demo. Когда мы вызывали их напрямую через mcp-probe, в списке был PhoneInput, а его пример - поле «Телефонный номер» с подсказкой +7 000 000 00 00. Ответ самого агента мы не проверяли. Если вызовов core-components-mcp в ответе нет, проверь командой /mcp, подключён ли сервер.
Что можно сделать
4 сценария
Поле телефона в форме заявки
В списке нашёлся PhoneInput из пакета phone-input с 38 свойствами, среди них error и hint. Пример у него один: поле «Телефонный номер» с подсказкой +7 000 000 00 00. Форму по этому промпту агент не собирал, мы смотрели только ответы сервера.
В списке от component_list есть PhoneInput и InternationalPhoneInput для номеров в международном формате.
Свойства PhoneInput отдаёт component_info, а код примера присылает component_demo с названием «Пример».
Промпт
Через core-components-mcp найди компонент для ввода мобильного номера и добавь в форму заявки поле «Телефон» с подсказкой формата. Поле обязательное, ошибку показывай под ним. Сначала посмотри свойства компонента и его пример.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. В примере стоят isMobile() и BREAKPOINT из документации, в проекте агенту придётся их заменить.
Таблица платежей с сортировкой по дате и сумме
У Table пять примеров, в «Сортировке» код на TSortableHeadCell с сортировкой по sum и date. Документация предупреждает, что сам порядок строк считает разработчик, а таблица только рисует значок и вызывает обработчик. Что соберёт агент, мы не смотрели.
component_demo по Table без названия перечисляет примеры: Примеры, Настройка колонок, Сортировка, Пагинация, Раскрывающаяся строка.
С названием «Сортировка» приходит код целиком, а component_info показывает составные части таблицы.
Промпт
Сделай через core-components-mcp таблицу платежей: дата, получатель, назначение, сумма. Таблица должна сортироваться по дате и по сумме. Возьми из примеров Table тот, что про сортировку, и сверь составные части таблицы.
Бесплатно: почта или сразу Телеграм-канал клуба
Экран ввода кода подтверждения
Пример «Примеры» у Confirmation описывает шесть состояний, от верного кода до блокировки формы на 24 часа, и присылает код примера. Экран по этому промпту мы не собирали.
component_demo с компонентом Confirmation и названием «Примеры».
Промпт
Добавь в кабинет экран подтверждения входа кодом. Найди через core-components-mcp пример Confirmation и разбери, какие состояния в нём есть: неверный код, устаревший код, кончились попытки. Покажи, как подключить компонент.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. В списке компонентов у Confirmation нет описания, ищи его по имени.
Что поменялось в выпадающем списке после обновления
Сервер отдал 11 записей истории Select между этими версиями, последняя про «Выбрать все»: теперь отмечаются все пункты, кроме недоступных. Какие из правок заденут твои формы, агенту ещё предстоит разобрать, этот шаг мы не запускали.
component_changelog с параметрами v1 и v2 возвращает записи после первой версии и до второй включительно.
Промпт
В проекте стоит @alfalab/core-components 50.0.0, хочу обновиться до 50.26.1. Через core-components-mcp собери, что поменялось в Select между этими версиями, и отметь то, что может сломать мои формы. Код пока не трогай.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. У части компонентов истории нет совсем: по Table пришёл ответ, что данных нет.
Пример работы
редакция, прогон при проверке 15.10.2026
Задача
Найти поле телефона и таблицу платежей среди компонентов Альфа-Банка
Промпт
Через core-components-mcp найди поле для телефона и таблицу с сортировкой и покажи их примеры
Что сделал агент
component_list за 62 мс отдал 98 компонентов версии 50.26.1, у большинства описания на русском, у Confirmation и Modal пусто.
Свойств у PhoneInput пришло 38, у Table шесть и ещё восемь составных частей.
Из примеров сервер прислал поле телефона и таблицу, которая сортирует строки по дате и сумме.
На «Кнопка» и Buton сервер ответил, что компонент не найден, без подсказок.
Результат
18 вызовов заняли от 6 до 64 мс, ключ не понадобился, сам сервер в сеть не ходил. Вызывал инструменты mcp-probe, агент Claude Code этот промпт не выполнял.
Инструменты
4 · описания около 0,5 тыс. токенов
Жёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Сервер не пригодится, если интерфейс собран на другой библиотеке или без React: справка у него только по компонентам Альфа-Банка. Если нужны один-два компонента, хватит страницы в документации библиотеки на core-ds.github.io.
Частые проблемы
7
На имя компонента пришёл ответ Component "..." not found
Сервер ищет по английскому имени компонента или имени его пакета, и при опечатке ничего не подсказывает: на «Кнопка» и Buton на прогоне пришёл именно такой ответ. Попроси агента сначала взять список через component_list и найти там нужное имя, например Button или PhoneInput.
В коде от агента остались isMobile(), BREAKPOINT или обёртка render(() => ...)
Примеры взяты из живой документации библиотеки, где эти функции и константа заданы заранее, а в самом ответе сервера их объявлений нет. Попроси агента переписать пример под твой проект: убрать render, а isMobile и BREAKPOINT заменить своей проверкой ширины экрана или постоянным размером.
Свойства из ответа не совпадают с теми, что есть в установленной библиотеке
Справка внутри пакета 0.2.3 собрана по версии 50.26.1. Свою версию в проекте сервер не определяет, так что у тебя может стоять другая. Узнай версию @alfalab/core-components в package.json проекта и попроси агента запросить историю изменений компонента между ней и 50.26.1.
Агент не видит инструментов сервера
Клиент не перезапущен после подключения: Claude Code читает подключения при старте сессии. Закрой и открой сессию, потом проверь: claude mcp list.
«spawn npx ENOENT» при запуске
Клиент не видит npx: приложения с иконкой не читают PATH из настроек терминала. Пропиши полный путь к npx. Узнать его: which npx на Mac, where npx на Windows.
«Unsupported engine» или падение при старте
Старая версия Node.js. Нужна 24 или новее, проверить: node --version.
Codex: сервер не успевает запуститься
Codex ждёт запуска 10 секунд, а первый запуск npx скачивает пакет дольше. Во вкладке Codex уже стоит startup_timeout_sec = 30, возьми фрагмент оттуда.
Только то, что агент передаёт в вызов: имя компонента, название примера и номера версий. Сервер ищет по файлам внутри пакета, наружу эти слова не уходят. Файлы проекта и разговор он не читает.
Куда уходят данные
Данные остаются на компьютере.
Что может изменить
Все четыре инструмента только отдают справку и ничего не меняют, на диск сервер не пишет. В пакете есть отдельная команда add-skill, она кладёт файлы памятки для агента в папку .agents/skills проекта, но запускается только руками и сервер её не вызывает.
Наша проверка
Пакет @alfalab/core-components-mcp собран из папки packages/mcp репозитория core-ds/core-components. Это библиотека React-компонентов Альфа-Банка. Раньше она лежала в репозитории alfa-laboratory/core-components с подписью Alfa-Bank UI library, сейчас тот репозиторий в архиве. Сервер добавили разработчики библиотеки, а выпуск 0.2.3 загрузил в npm тот же бот, что публикует саму библиотеку. Страницы на сайте банка со ссылкой на пакет мы не нашли. Лицензия репозитория MIT, в package.json пакета поле лицензии пустое. Мы прочитали код версии 0.2.3. Запуска программ и сетевых запросов в нём нет, установочных скриптов тоже. Скрытых указаний в описаниях инструментов мы не нашли, инструкций у сервера нет. Автор не пометил инструменты как безопасные для чтения, метку read мы поставили сами по коду и ответам. В одноразовой песочнице Ubuntu 24.04.5 на Node.js 24 было 18 вызовов всех четырёх инструментов, ответы пришли за 6-64 мс. Имя ../../../../etc/passwd сервер не нашёл: файл он выбирает из списка своих, путь из имени не собирает. Через npx соединения шли только к реестру npm, установленный пакет без npx не открыл ни одного. По базе OSV записей нет ни у пакета, ни у 93 пакетов его дерева, npm audit тоже показал ноль. Версия в команде закреплена: npx -y @alfalab/core-components-mcp@0.2.3, пакет из реестра npm.
Версия
В командах закреплена версия 0.2.3: ставится ровно то, что мы проверили.
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
