shadcn/ui

Официальный

shadcn · лицензия MIT

Агент сам находит компоненты shadcn/ui, смотрит примеры и даёт команду установки

На твоём компьютереБез ключаРаботает из РоссииТолько читаетБесплатноДанные уходят: Vercel (реестр ui.shadcn.com), США

✓ Проверено 24.09.2026 на версии 4.21.0 в Claude Code (macOS) · 7 инструментов

Подключить ↓

Что сможет агент

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

Паспорт

Кто сделал: shadcn
Статус: Официальный
Лицензия: MIT
Проверено: 24.09.2026
Версия: 4.21.0
Где работает: На твоём компьютере
Доступ: Без ключа
Россия: Работает из России
Данные: Данные уходят: Vercel (реестр ui.shadcn.com), США
Цена: Бесплатно
Проверено в: Claude Code
Исходный код: github.com/shadcn-ui/ui
Документация: ui.shadcn.com/docs/mcp

Подключить

Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.

Промпт для агента

Подключи MCP-сервер «shadcn/ui» версии 4.21.0. Работай по шагам и после каждого коротко говори, что сделал.

Данные сервера (каталог smyslokod.ru, проверено 24.09.2026):
- имя в конфиге: shadcn
- официальный источник: https://github.com/shadcn-ui/ui
- запуск: npx -y shadcn@4.21.0 mcp

Правила:
1. Не ставь Node.js, uv или Docker без моего «да». Не хватает - остановись и скажи, что поставить и откуда.
2. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
3. Перед правкой конфига сделай его резервную копию.

Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь окружение: node --version и npx --version (нужен Node.js 18 или новее). Скажи, что нашёл.
2. Проверь, нет ли уже сервера с таким именем: `claude mcp get shadcn` (в Codex: `codex mcp list`).
3. Подключи сервер:
Claude Code: claude mcp add --scope user --transport stdio shadcn -- npx -y shadcn@4.21.0 mcp
Codex: codex mcp add shadcn -- npx -y shadcn@4.21.0 mcp
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. Перечисли инструменты сервера, их около 7. Сделай пробный запрос: «Через shadcn найди компонент для окна подтверждения действия и покажи команду, которой его ставят в проект.». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove shadcn --scope user` (в Codex: `codex mcp remove shadcn`).

Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/shadcn#problemy

Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.

Что нужно на компьютере: Node.js 18 или новее.

Ключ: не нужен.

Работает в папке проекта, где уже есть components.json. Если проекта на shadcn/ui ещё нет, начни с npx shadcn@4.21.0 init.

Проверь, что работает

Пробный запрос

Через shadcn найди компонент для окна подтверждения действия и покажи команду, которой его ставят в проект.

Что должно получиться: Агент найдёт компонент alert-dialog в реестре @shadcn и покажет команду установки под менеджер пакетов твоего проекта.

Пример работы

Задача

Добавить в проект окно подтверждения удаления

Промпт

Через shadcn найди компонент для окна подтверждения действия и покажи команду, которой его ставят в проект.

Что сделал агент

Нашёл в реестре @shadcn компонент alert-dialog и пример alert-dialog-demo (search_items_in_registries).
Получил команду установки под менеджер пакетов проекта (get_add_command_for_items).

Результат

Команда установки компонента за два вызова, меньше секунды.

Редакция, 24.09.2026 · прогон при проверке

Инструменты сервера

7 инструментов, описания около 1,4 тыс. токенов. В Claude Code это почти не мешает: инструменты грузятся по запросу. Если в настройках Claude Code задан свой адрес подключения (ANTHROPIC_BASE_URL), в части других клиентов и на старых моделях описания грузятся целиком и занимают место в памяти агента на каждом сообщении.

Нажми на строку, чтобы увидеть оригинальное описание: ровно его читает агент.

Когда не нужен

Если в проекте нет shadcn/ui, подключение бесполезно: все инструменты читают components.json. Для пары знакомых компонентов агенту хватит команды установки без подключения.

Частые проблемы

В результатах поиска вместо команды установки «[object Promise]»

Ошибка версии 4.21.0 в инструменте поиска. Попроси агента взять команду инструментом get_add_command_for_items: он отдаёт её правильно.

Ошибка про отсутствие components.json

Проект ещё не на shadcn/ui. Сначала выполни npx shadcn@4.21.0 init в папке проекта.

Агент не видит инструментов сервера

Клиент не перезапущен после подключения: 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, возьми фрагмент оттуда.

Безопасность и данные

Кто сделал: shadcn (официальный). Исходный код: github.com/shadcn-ui/ui, лицензия MIT.
Что видит агент: Файл components.json твоего проекта и каталог компонентов из реестров, прописанных в нём.
Куда уходят данные: Данные уходят: Vercel (реестр ui.shadcn.com), США.
Что может изменить: Сам ничего не меняет: даёт команду установки, а ставит компонент агент, запуская её в терминале с твоего разрешения.
Наша проверка: Официальный пакет shadcn в npm из репозитория shadcn-ui/ui, лицензия MIT. В базе OSV записей нет. Описания всех 7 инструментов прочитаны, скрытых указаний агенту нет. Автор не пометил инструменты «только чтение», поэтому уровень ставили по живому вызову: поиск и команда установки ничего не меняют. Версия в команде закреплена.
Версия: В командах закреплена версия 4.21.0: ставится ровно то, что мы проверили.

Проверить самому

Промпт Артемия: агент прочитает код подключения как недоверенный и покажет строки, где читаются секреты, уходят данные или меняются твои настройки.

Журнал проверок

Дата	Версия	Где	Итог	Отпечаток
24.09.2026	4.21.0	Claude Code, macOS	работает	2b29436d367da78b

Отпечаток - контрольная сумма того, что сервер отдаёт агенту: инструкций, инструментов, подсказок и ресурсов. Поменялся при той же версии - поменялось поведение.

Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.