Работа из России нестабильна (на 19.10.2026). Регистрация, ключ и оплата не нужны. 19 октября 2026 года реестр npm ответил на запрос архива пакета с трёх российских узлов check-host.net, двух в Москве и одного в Санкт-Петербурге, но целиком архив они не скачали: узлы не принимают файлы такого размера. Сборка модуля картинок для Linux, @resvg/resvg-js-linux-x64-gnu 2.6.2, с тех же узлов скачалась за 0,3-0,5 секунды. Сервер в сеть не ходит, но полной установки и вызова из России мы не делали. Сверено 19.10.2026.
Что сможет агент
Ищет по смыслу английских слов: на «throw away» сервер вернул trash и trash-2, на опечатку settigns подсказал settings, так что агенту не придётся угадывать имена.
Отдаёт иконку готовым кодом для сайта: SVG, компонент React, Vue, Svelte, Angular или веб-компонент. Для иконки trash в стиле solid пришли импорт TrashSolid из @withicons/react/solid и тег <TrashSolid />.
Делает файлы для презентаций и документов. Ракету в синем цвете #1d4ed8 сервер сохранил PNG 512 на 512 с прозрачным фоном, три иконки за один вызов разложил на SVG, PDF и PowerPoint, а колокол стал GIF из 36 кадров.
Помогает выбрать вид из 34 стилей: от строгих контурных до объёмных и праздничных. preview_icons рисует одну картинку, где рядом стоят несколько иконок в нескольких стилях.
Даёт код анимации иконки для сайта: для колокола при наведении пришёл код с движением ring и пакетом @withicons/motion вместе с командой установки. Как анимация выглядит в браузере, мы не смотрели.
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Промпт для агента
Подключи MCP-сервер «with icons» версии 0.5.0. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог smyslokod.ru, проверено 19.10.2026):
- имя в конфиге: withicons
- официальный источник: https://github.com/withevergrow/withicons/tree/main/packages/mcp
- запуск: npx -y @withicons/mcp@0.5.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 withicons` (в Codex: `codex mcp list`).
3. Подключи сервер:
Claude Code: claude mcp add --scope user --transport stdio withicons -- npx -y @withicons/mcp@0.5.0
Codex: codex mcp add withicons -- npx -y @withicons/mcp@0.5.0
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера 10 инструментов, перечисли их. Сделай пробный запрос: «Через withicons найди иконку для кнопки удаления и дай код для React в стиле solid». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove withicons --scope user` (в Codex: `codex mcp remove withicons`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/withicons#problemy
Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.
Что нужно на компьютере: Node.js 18 или новее.
Ключ: не нужен.
Ключ и регистрация не нужны. Команда подключения: claude mcp add --scope user withicons -- npx -y @withicons/mcp@0.5.0. Нужен Node.js 18 или новее, мы запускали на 22.23.3. Пакет тяжёлый: все иконки лежат внутри, установленный он занял на диске 107 МБ. При запуске через npx были обращения к реестру npm. Установленный пакет в наших вызовах в сеть не ходил. Повторный запуск через npx без интернета мы не проверяли. Для PNG, GIF и других картинок npx ставит вместе с сервером модуль @resvg/resvg-js, если для твоей системы есть готовая сборка. В версии 0.5.0 из npm 750 иконок, а сайт withicons.com уже показывает 1000: часть иконок с сайта сервер пока не знает. В схемах параметров стоит стандарт draft-07, схем ответа нет. В Claude Desktop мы его не запускали, в Claude Code подключение прошло. У набора есть и удалённый сервер по адресу withicons.com/mcp, его мы не проверяли.
Проверь, что работает
Пробный запрос
Через withicons найди иконку для кнопки удаления и дай код для React в стиле solid
Что должно получиться: Промпт просит агента найти иконку и взять её код. Прямые вызовы нашим клиентом вернули: search_icons по delete - trash, trash-2 и file-x, get_icon для trash в стиле solid - import { Trash as TrashSolid } from '@withicons/react/solid'. Что ответит сам агент Claude Code, мы не проверяли. Если вызова withicons нет, посмотри командой /mcp, подключён ли сервер.
Что можно сделать
4 сценария
Иконки для кнопок и меню сайта на React
Сервер нашёл shopping-cart и trash, синоним bin тоже привёл к trash, а на опечатку settigns подсказал settings. get_icon для trash в стиле solid вернул импорт TrashSolid из @withicons/react/solid. Ставить пакет и править кнопки будет агент, в проекте мы это не запускали. Проси ставить пакет с версией, например @withicons/react@0.5.0, она вышла вместе с сервером.
search_icons ищет по словам, resolve_icon проверяет имя или синоним.
get_icon с format react присылает строку импорта и тег.
Промпт
Через подключение withicons подбери иконки для кнопок «Корзина», «Удалить» и «Настройки» на моём сайте на React, все в стиле solid. Ищи по-английски, имена бери только из ответов сервера. Поставь пакет @withicons/react@0.5.0 и вставь иконки в кнопки.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Для кнопок высотой 16-24 пикселя сервер советует стили line, solid и duo, остальные от 32 пикселей.
Набор иконок для слайдов в фирменном цвете
recommend_styles для слайда с ценами предложил duo, solid и suite и посоветовал вставлять в слайды файлы PNG. export_icon сохранил ракету в синем #1d4ed8 файлом PNG 512 на 512 с прозрачным фоном, а три иконки в стиле duo за один вызов разложил по форматам SVG, PDF и PowerPoint. Как файлы лягут в твою презентацию, зависит от программы, мы её не открывали.
recommend_styles с use slides или словами задачи советует стиль.
export_icon с names, format png, size 512 и out_dir пишет файлы в папку.
Промпт
Через withicons подбери стиль иконок для слайда с ценами в презентации и сделай иконки rocket, users и chart-line одним набором: PNG 512 пикселей, цвет #1d4ed8, прозрачный фон. Сохрани их в папку slides/icons.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Точный фирменный цвет держат одноцветные стили solid и line, в объёмных стилях цвет уходит в оттенки.
Совет. Для Google Slides руководство набора советует PNG 512 пикселей.
Посмотреть стили рядом, прежде чем выбрать
preview_icons за 269 мс вернул картинку PNG 439 на 321: три строки иконок, три столбца стилей, подписи целые, стиль clay объёмный, фиолетовый. Картинка ниже - этот ответ сервера. Код для Vue после выбора даёт get_icon, этот шаг на прогоне мы не повторяли.
preview_icons принимает до 24 иконок и до 6 стилей.
Промпт
Через withicons покажи одной картинкой иконки cart, user и settings в стилях line, solid и clay. Я выберу стиль для интернет-магазина, потом дай код выбранных иконок для Vue.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Без out_dir картинка приходит только в ответ и на диск не пишется.
Колокольчик уведомлений, который качается при наведении
animate_icon для bell с trigger hover ответил за 5 мс: импорт Bell из @withicons/react, два файла стилей @withicons/motion и кнопка с классом wm-trigger, движение называется ring. В ответе была и команда npm i @withicons/motion без версии, а ссылки CDN вели на latest, поэтому в промпте версия задана явно. В браузере анимацию мы не запускали.
Промпт
Через withicons сделай, чтобы иконка колокольчика на кнопке уведомлений в моём React-приложении качалась при наведении. Дай код и команду установки, пакет @withicons/motion ставь версии 0.5.0.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Если нужен движущийся значок в слайд или письмо, проси export_icon с форматом gif и цветом фона слайда.
Пример работы
редакция, прогон при проверке 19.10.2026
Задача
Подобрать иконки для сайта и слайдов из набора with icons
Промпт
Через withicons найди иконку корзины, дай код для React и сделай PNG ракеты 512 пикселей в синем цвете для слайда
Что сделал агент
В песочнице Ubuntu 24.04.5 сервер добавили командой claude mcp add, Claude Code 2.1.292 показал Connected.
search_icons по «shopping cart» нашёл shopping-cart и shopping-cart-plus, по-русски «корзина» не нашёл ничего.
export_icon сохранил ракету в цвете #1d4ed8 файлом PNG 512 на 512 с прозрачным фоном.
preview_icons нарисовал сетку из трёх иконок в трёх стилях, export_icon сделал GIF колокола из 36 кадров.
Результат
Через npx и mcp-probe прошли 4 вызова, нашим клиентом на SDK из установленного пакета - 27 вызовов всех 10 инструментов, из них 24 без ошибок за 1-2607 мс. Установленный пакет в сеть не ходил. Инструменты вызывали mcp-probe и наш клиент, агент Claude Code промпт не выполнял.
Инструменты
10 · описания около 8,5 тыс. токенов
Жёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если иконки на сайте уже из другого набора и менять их ты не будешь, подключение мало что даст: оно знает только with icons. В каталоге есть и другой набор иконок, Keyline Icons. По-русски поиск не работает, слова агенту придётся писать по-английски.
Частые проблемы
9
Ответ «No icons for "корзина"» на русское слово
Имена иконок, синонимы и слова для поиска в наборе английские. Попроси агента переводить запрос на английский или сразу назови слова: cart, phone, bell.
В папке пропал твой файл, а на его месте иконка с тем же именем
export_icon и preview_icons с out_dir пишут файл по имени вида rocket-solid-512.png и заменяют существующий без вопроса. Автор при этом пометил export_icon как безопасный для повторов. На прогоне мы положили в папку свой файл с таким именем, и сервер его перезаписал. Давай для иконок отдельную пустую папку, например assets/icons, и не указывай папку с твоими файлами.
Ответ list_styles занимает почти 70 тысяч знаков и съедает место в разговоре
Инструмент отдаёт все 34 стиля целиком, с цветовыми ролями каждого. Для выбора стиля проси recommend_styles с compact: true, его ответ на запрос про слайд с ценами был 1451 знак.
В коде анимации подключение с CDN идёт на @withicons/motion@latest
animate_icon вставляет ссылку на последнюю версию пакета анимаций без номера, и после нового выпуска страница может вести себя иначе. Ставь пакет с номером версии, например npm i @withicons/motion@0.5.0, это выпуск от 12 октября 2026 года, вместе с которым вышел сервер 0.5.0. В ссылке CDN тоже замени latest на 0.5.0.
Агент не видит инструментов сервера
Клиент не перезапущен после подключения: 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, возьми фрагмент оттуда.
Агент путается в инструментах и медленно отвечает
В настройках Claude Code задан свой адрес подключения (ANTHROPIC_BASE_URL): поиск инструментов выключается, и описания всех подключений грузятся целиком. Оставь включёнными только нужные подключения.
Только то, что агент передаёт в вызов: слова для поиска, имя иконки, стиль, цвета и папку для файлов. Сервер ищет по данным внутри пакета и сам в сеть не ходит. Документы проекта и разговор он не просматривает, но для картинок может загрузить модуль @resvg/resvg-js из папки, где запущен. Ответы идут модели агента, у Claude Code это Anthropic. В них код иконок и картинки, а иногда и то, что агент передал: на поиск «корзина» сервер повторил это слово в ответе.
Куда уходят данные
Данные остаются на компьютере.
Что может изменить
Восемь инструментов только отвечают текстом. export_icon и preview_icons с параметром out_dir создают папку и пишут в неё файлы, причём файл с тем же именем заменяют без вопроса. Папку выбирает агент, сервер её не ограничивает. Имя файла с папкой внутри, вроде ../escaped, сервер отклонил. Без out_dir на диск ничего не пишется. Для картинок сервер подключает модуль @resvg/resvg-js, а если рядом с ним модуля нет, ищет его в папке проекта, из которой запущен.
Наша проверка
Пакет @withicons/mcp выпускает команда набора with icons компании Evergrow из США: на него ссылаются сайт withicons.com и репозиторий withevergrow/withicons под MIT. В официальном реестре MCP сервера нет. Репозиторий создан 1 октября 2026 года, у него две звезды, выпуск 0.5.0 вышел 12 октября, так что проект молодой. Установочных скриптов в package.json нет. Мы прочитали код 0.5.0: из модулей Node.js подключены файлы, пути и процесс, сетевых запросов, запуска программ и телеметрии нет. Восемь инструментов автор пометил как только читающие, export_icon и preview_icons - как пишущие, у нас они тоже отмечены как write. Скрытых указаний в инструкции и описаниях нет, инструкция только советует агенту, как выбирать стиль и показывать варианты. В одноразовой песочнице Ubuntu 24.04.5 на Node.js 22.23.3 прошли 4 вызова через npx и 27 вызовов всех 10 инструментов нашим клиентом на SDK из установленного пакета: 24 без ошибок и 3 ожидаемых отказа. Через npx соединения были только с реестром npm. Установленный пакет не открыл ни одного соединения. OSV по трём пакетам дерева записей не нашёл, npm audit показал ноль уязвимостей. Версия в команде закреплена.
Версия
В командах закреплена версия 0.5.0: ставится ровно то, что мы проверили.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
