Агент находит иконку по английскому слову. На запрос cart сервер вернул четыре иконки, первой shopping-cart, и у каждой указал стили: контур, два тона, полупрозрачная заливка, сплошная заливка и вариант с острыми углами.
Код SVG приходит готовым для вставки в страницу: размер 24 на 24, а цвет иконка берёт у текста вокруг, поэтому красить её можно обычным свойством color.
Если сайт на React, сервер выдаёт строку импорта из пакета @keyline-icons/react с нужным стилем, у корзины со сплошной заливкой это import { ShoppingCart } from "@keyline-icons/react/fill".
Имена из других наборов сервер тоже понимает. По CheckCircle2 он нашёл circle-check, на опечатку chekc предложил check, а старое имя rocket-2 перевёл в новое rocket-fast.
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Промпт для агента
Подключи MCP-сервер «Keyline Icons» версии 1.8.0. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог smyslokod.ru, проверено 14.10.2026):
- имя в конфиге: keyline-icons
- официальный источник: https://github.com/keyline-icons/keyline-icons/tree/main/packages/mcp
- запуск: npx -y @keyline-icons/mcp@1.8.0
Правила:
1. Не ставь Node.js, uv или Docker без моего «да». Не хватает - остановись и скажи, что поставить и откуда.
2. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
3. Перед правкой конфига сделай его резервную копию.
Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь окружение: node --version и npx --version (нужен Node.js 20 или новее). Скажи, что нашёл.
2. Проверь, нет ли уже сервера с таким именем: `claude mcp get keyline-icons` (в Codex: `codex mcp list`).
3. Подключи сервер:
Claude Code: claude mcp add --scope user --transport stdio keyline-icons -- npx -y @keyline-icons/mcp@1.8.0
Codex: codex mcp add keyline-icons -- npx -y @keyline-icons/mcp@1.8.0
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера 4 инструмента, перечисли их. Сделай пробный запрос: «Через keyline-icons найди иконку корзины и дай строку импорта для React в стиле со сплошной заливкой». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove keyline-icons --scope user` (в Codex: `codex mcp remove keyline-icons`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/keyline-icons#problemy
Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.
Что нужно на компьютере: Node.js 20 или новее.
Ключ: не нужен.
Ключ и аккаунт не нужны. Весь набор лежит внутри пакета, на диске он занимает 7,1 МБ, так что интернет нужен только npx, чтобы скачать пакет. Сами иконки в проект попадают кодом SVG или через пакет @keyline-icons/react, его агент ставит отдельно. Пакет просит Node.js 20.9 или новее, мы проверяли на Node.js 22.
Проверь, что работает
Пробный запрос
Через keyline-icons найди иконку корзины и дай строку импорта для React в стиле со сплошной заливкой
Что должно получиться: Промпт просит найти корзину и строку импорта. Прямые вызовы через mcp-probe вернули: search_icons по cart - четыре иконки, первой shopping-cart, get_react_usage - import { ShoppingCart } from "@keyline-icons/react/fill". Что ответит сам агент, мы не проверяли. Если вызова keyline-icons в ответе нет, посмотри командой /mcp, подключён ли сервер.
Что можно сделать
3 сценария
Иконки для кнопок «В корзину» и «Позвонить» на сайте на React
На прогоне search_icons по cart нашёл shopping-cart, а поиск phone со стилем fill дал пять иконок телефона. get_react_usage для корзины вернул импорт из @keyline-icons/react/fill и разметку с className="size-4". Сами кнопки агент в проекте не собирал.
search_icons ищет по словам cart и phone, для телефона можно сразу указать стиль fill.
get_react_usage присылает строку импорта и пример разметки для каждой найденной иконки.
Промпт
Через подключение keyline-icons подбери иконки для кнопок «В корзину» и «Позвонить» на моём сайте на React, обе в стиле со сплошной заливкой. Поставь пакет @keyline-icons/react и вставь иконки в кнопки. Имена бери только из ответов сервера.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Если кнопки на shadcn/ui, сервер советует убрать у иконки className, тогда размер ей задаст сама кнопка.
Перевести сайт с другого набора иконок на Keyline
Сервер умеет искать по чужим именам, это видно на прогоне: по CheckCircle2 пришёл circle-check, по «help circle» - circle-question. Переименованную иконку rocket-2 он вернул новым именем RocketFast с пометкой, что старое ещё работает до следующего крупного выпуска. Замену по всему проекту мы не запускали, так что полноту списка не обещаем.
search_icons принимает имя компонента как есть, например CheckCircle2.
get_react_usage даёт строку импорта для каждой найденной замены.
Промпт
В проекте иконки из другого набора. Через keyline-icons найди замену каждой иконке, которую импортирует проект, и покажи таблицу: старое имя, имя в Keyline, строка импорта. Если замены нет, так и напиши, ничего не подбирай наугад.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Пустой ответ поиска сервер просит считать честным: значит, такой иконки в наборе нет.
Иконка кодом SVG в обычной странице без React
Здесь нужен один вызов get_icon. Корзину в стиле duotone с острыми углами он прислал кодом в 785 знаков: заливка корзины полупрозрачная, цвет взят из currentColor. Мы отрисовали этот код в картинку и узнали тележку с ручкой и двумя колёсами. Вставку в index.html на прогоне не проверяли.
get_icon с именем shopping-cart, стилем duotone и углами sharp присылает готовый код.
Промпт
Через keyline-icons возьми код SVG иконки корзины в стиле duotone с острыми углами и вставь его в ссылку на корзину в шапке index.html. Цвет иконки пусть совпадает с цветом текста ссылки.
Бесплатно: почта или сразу Телеграм-канал клуба
Пример работы
редакция, прогон при проверке 14.10.2026
Задача
Подобрать иконки для сайта по точным именам из набора Keyline
Промпт
Через подключение keyline-icons найди иконку корзины, дай её код SVG и строку импорта для React
Что сделал агент
В песочнице Ubuntu 24.04.5 сервер добавили командой claude mcp add, Claude Code 2.1.292 показал Connected.
describe_set ответил, что в наборе 1435 иконок и у каждой четыре стиля.
search_icons по cart нашёл shopping-cart, get_icon прислал её код SVG, get_react_usage - строку импорта.
Русское слово «корзина» поиск не нашёл, на опечатку chekc сервер подсказал check.
Результат
15 вызовов всех четырёх инструментов заняли от 0 до 22 мс, ключ и сеть серверу не понадобились. Вызывал их mcp-probe, сам Claude Code этот промпт не запускал.
Инструменты
4 · описания около 0,6 тыс. токенов
Жёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если на сайте уже стоит другой набор иконок и менять его ты не собираешься, сервер не пригодится: он знает только Keyline. Значка рубля и логотипов соцсетей в наборе нет. Ту же базу иконок автор выпускает и консольной программой @keyline-icons/cli, её агент может запускать в терминале без подключения MCP.
Частые проблемы
7
Ответ «No icon matches "корзина".»
Имена иконок и слова для поиска в наборе английские, русское слово сервер не находит. Пусть агент ищет по-английски: cart, phone, bell.
Иконку просили со сплошной заливкой, а пришли одни линии
У открытых рисунков вроде bar-chart заливать нечего, и сервер молча отдаёт тот же контур. В описании пакета обещано, что он об этом скажет, но версия 1.8.0 на прогоне ничего не сказала. По данным внутри пакета так устроены 423 иконки из 1435. Для заливки бери тот же рисунок в рамке: у square-bar-chart заливка настоящая. Или попроси агента сверить код fill с кодом stroke, прежде чем ставить иконку.
Ответ «No icon named ... Did you mean: ...»
Агент угадывал имя, и такого в наборе не оказалось. Подсказки после ответа бывают мимо: для no-such-icon сервер предложил x, at, tv, bot и box. Попроси агента сначала вызвать search_icons и брать имя из его ответа.
Агент не видит инструментов сервера
Клиент не перезапущен после подключения: Claude Code читает подключения при старте сессии. Закрой и открой сессию, потом проверь: claude mcp list.
«spawn npx ENOENT» при запуске
Клиент не видит npx: приложения с иконкой не читают PATH из настроек терминала. Пропиши полный путь к npx. Узнать его: which npx на Mac, where npx на Windows.
«Unsupported engine» или падение при старте
Старая версия Node.js. Нужна 20 или новее, проверить: node --version.
Codex: сервер не успевает запуститься
Codex ждёт запуска 10 секунд, а первый запуск npx скачивает пакет дольше. Во вкладке Codex уже стоит startup_timeout_sec = 30, возьми фрагмент оттуда.
Только то, что агент передаёт в вызов: слово для поиска, имя иконки, стиль и вид углов. Наружу это не уходит, сервер ищет по файлу внутри пакета. Файлы проекта и разговор он не читает.
Куда уходят данные
Данные остаются на компьютере.
Что может изменить
Все четыре инструмента только отдают текст из набора иконок и ничего не меняют, на диск сервер не пишет. Код с иконками в проект вставляет сам агент.
Наша проверка
Пакет @keyline-icons/mcp выпускает автор набора Keyline Icons: он лежит в репозитории keyline-icons/keyline-icons под лицензией MIT, а в официальном реестре MCP записан как com.keylineicons/mcp с сайтом keylineicons.com. В npm у пакета один сопровождающий, выпуски он загружает сам. Мы прочитали код версии 1.8.0. Зависимостей у пакета нет, протокол написан вручную, из модулей Node.js подключены только чтение файла набора и работа с путями. Сетевых запросов, запуска команд и записи файлов в коде нет. Из скриптов в package.json есть только start, установочных хуков нет. Инструкций у сервера нет, скрытых указаний в описаниях четырёх инструментов мы не нашли. Автор не пометил инструменты как безопасные для чтения, поэтому метку read мы поставили сами, по коду и ответам. В одноразовой песочнице Ubuntu 24.04.5 было 15 вызовов всех четырёх инструментов, ответы пришли за 0-22 мс. Запрос длиннее 200 знаков сервер отклонил, как и написано в коде. В журнале соединений при запуске через npx только реестр npm. Установленный пакет, запущенный без npx, не открыл ни одного соединения. База OSV записей по пакету не нашла, npm audit показал ноль уязвимостей. Версия в команде закреплена.
Версия
В командах закреплена версия 1.8.0: ставится ровно то, что мы проверили.
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
