Что сможет агент
- Найдёт готовый компонент по описанию: окно подтверждения, таблицу, календарь, выпадающее меню.
- Покажет примеры использования с кодом, чтобы агент собрал экран так, как задумано в библиотеке.
- Даст точную команду установки компонента для твоего проекта, агенту не нужно угадывать.
- Кто сделал
- shadcn
- Версия
- 4.21.0
- Проверено
- 24.09.2026, Claude Code
- Лицензия
- MIT
- Документация
- ui.shadcn.com/docs/mcp
Подключить
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Подключи MCP-сервер «shadcn/ui» версии 4.21.0. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог code.tarasovweb.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://code.tarasovweb.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 и покажет команду установки под менеджер пакетов твоего проекта.
Пример работы
редакция, прогон при проверке 24.09.2026- Задача
- Добавить в проект окно подтверждения удаления
- Промпт
- Через shadcn найди компонент для окна подтверждения действия и покажи команду, которой его ставят в проект.
- Что сделал агент
- Нашёл в реестре @shadcn компонент alert-dialog и пример alert-dialog-demo (search_items_in_registries).
- Получил команду установки под менеджер пакетов проекта (get_add_command_for_items).
- Результат
- Команда установки компонента за два вызова, меньше секунды.
Инструменты
7 · описания около 1,4 тыс. токеновЖёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если в проекте нет shadcn/ui, подключение бесполезно: все инструменты читают components.json. Для пары знакомых компонентов агенту хватит команды установки без подключения.
Частые проблемы
6В результатах поиска вместо команды установки «[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
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
