Отвечает агенту по архитектуре продукта, описанной файлами LikeC4: что от чего зависит, где персональные данные, какой путь у заказа, в каком файле что описано
На твоём компьютере·Без ключа·Бесплатно·20 инструментов·проверено 17.10.2026 на версии 1.60.0
Читает тексты посторонних: файлы модели LikeC4 и файл настроек проекта, в том числе написанные другими людьми. В таком тексте могут прятаться команды для агента.
Осторожно в паре с подключениями, которые могут отправлять наружу.
Персональные данные клиентов могут уйти за границу. Если через подключение пойдут данные твоих клиентов, это передача за границу по 152-ФЗ: нужны согласие людей и уведомление Роскомнадзора.
Что сможет агент
Перед правкой части продукта агент узнаёт, что от неё зависит. На тестовой модели про сервис «Заказы» сервер одним вызовом вернул пять элементов ниже по цепочке: базу данных, платёжный сервис, уведомления, старую CRM и почтовый сервис.
Можно спросить, где в архитектуре лежат персональные данные. По тегу pii без тега legacy сервер нашёл только базу данных, а по метаданным owner = core нашёл API и старую CRM.
Агент прослеживает путь от покупателя до письма: на тестовой модели нашлась цепочка из четырёх связей, от «оформляет заказ» до «отправляет письмо».
В ответах есть файл и строка, где описан элемент, поэтому агент может сразу открыть нужное место в модели и поправить его. Файлы модели сервер не меняет, правит их сам агент.
Сервер следит за файлами модели: элемент, дописанный в файл, нашёлся поиском через четыре секунды без перезапуска.
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Промпт для агента
Подключи MCP-сервер «LikeC4» версии 1.60.0. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог smyslokod.ru, проверено 17.10.2026):
- имя в конфиге: likec4
- официальный источник: https://github.com/likec4/likec4/tree/main/packages/mcp
- запуск: npx -y @likec4/mcp@1.60.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 likec4` (в Codex: `codex mcp list`).
3. Подключи сервер:
Claude Code: claude mcp add --scope user --env 'LIKEC4_WORKSPACE=${LIKEC4_WORKSPACE}' --transport stdio likec4 -- npx -y @likec4/mcp@1.60.0
Codex: добавь в ~/.codex/config.toml
[mcp_servers.likec4]
command = "npx"
args = ["-y", "@likec4/mcp@1.60.0"]
env_vars = ["LIKEC4_WORKSPACE"]
startup_timeout_sec = 30
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера 20 инструментов, перечисли их. Сделай пробный запрос: «Через likec4 перечисли проекты в этой папке и для первого скажи, сколько в нём элементов и схем». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove likec4 --scope user` (в Codex: `codex mcp remove likec4`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/likec4#problemy
Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.
Что нужно на компьютере: Node.js 18 или новее.
Ключ: не нужен.
Ключ и регистрация не нужны. Команда подключения: claude mcp add --scope user likec4 -- npx -y @likec4/mcp@1.60.0. Claude Code потом запускай из папки с моделью или укажи путь в переменной LIKEC4_WORKSPACE. Сам пакет приходит из реестра npm. Автор требует Node.js 22.22.3 или новее, мы запускали на 22.23.3. Сервер ищет в папке и её подпапках файлы модели с расширениями .c4, .likec4 и .like-c4, папки node_modules и .git пропускает. Файлы модели он не меняет и следит за ними сам: правка видна без перезапуска. Чтобы сервер меньше нагружал компьютер на неизменной модели, автор советует добавить в конце команды --no-watch. Пакет весит 4,8 МБ, вместе с зависимостями около 47 МБ. Описания инструментов у этого сервера длинные, около 16 тысяч токенов. Команду с ключом --http, которую дают для других редакторов, мы не советуем, потому что в таком режиме сервер слушал порт 33335 на всех сетевых адресах компьютера.
Проверь, что работает
Пробный запрос
Через likec4 перечисли проекты в этой папке и для первого скажи, сколько в нём элементов и схем
Что должно получиться: Промпт просит агента вызвать list-projects и read-project-summary. Когда мы вызывали их напрямую нашим клиентом на SDK на тестовой модели, пришёл проект shop «Тестовый проект» с 12 элементами, 9 узлами развёртывания и 5 схемами. Как ответит сам агент Claude Code, мы не проверяли. Если вызовов likec4 нет, посмотри командой /mcp, подключён ли сервер и запущен ли Claude Code из папки с моделью.
Что можно сделать
4 сценария
Узнать, что заденет правка сервиса
На тестовой модели query-outgoers-graph по сервису «Заказы» вернул пять зависимых элементов с глубиной: базу данных по SQL, платёжный сервис, уведомления, старую CRM и почтовый сервис через уведомления. Файл и строку отдаёт read-element. Список в ответе собирает уже агент, его по этому промпту мы не запускали.
search-element находит элемент по слову «заказ» и отдаёт его полное имя.
query-outgoers-graph собирает зависимых одним вызовом, а read-element показывает связи и место в файле.
Промпт
Через likec4 найди в модели архитектуры сервис заказов и покажи всё, что от него зависит, прямо и через другие части. Для каждой зависимости назови связь, технологию и файл со строкой, где она описана. Код пока не меняй.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Сервер ищет по названию на том языке, на котором написана модель: на тестовой модели «заказ» нашёл «Заказы».
Найти части продукта с персональными данными
Нужен тег pii в самой модели: сервер ищет по тегам, смысл описаний он не разбирает. На тестовой модели query-by-tags с условием «pii, но не legacy» вернул одну базу данных. К ней, по ответу query-incomers-graph, ходят «Заказы» и старая CRM. Свод для человека пишет агент, этот шаг мы не проверяли.
query-by-tags принимает условия «все из», «любой из» и «ни одного из».
query-incomers-graph отвечает, что ведёт к элементу, на несколько шагов назад.
Промпт
Через likec4 найди в архитектуре все элементы с тегом pii. Отдельно перечисли те, у которых нет тега legacy, и для каждого покажи, кто к нему обращается.
Бесплатно: почта или сразу Телеграм-канал клуба
Проследить путь заказа от покупателя до письма
find-relationship-paths на тестовой модели вернул одну цепочку из четырёх шагов: покупатель оформляет заказ на сайте, сайт создаёт заказ по REST, «Заказы» шлют уведомлениям событие «заказ оплачен», уведомления отправляют письмо. Пересказ по шагам остаётся за агентом.
Сначала агент узнаёт имена элементов через search-element или read-project-summary.
find-relationship-paths ищет до 100 цепочек, самые короткие первыми.
Промпт
Через likec4 найди все цепочки связей от покупателя до почтового сервиса и распиши каждую по шагам: кто кому что передаёт.
Бесплатно: почта или сразу Телеграм-канал клуба
Набросать новую схему, не трогая файлы
preview-view собрал черновик «Кто ходит в старую CRM» за 264 мс, в папке проекта новых файлов не появилось. С нашим текстом схемы в черновик попал один элемент без связей, так что формулировку правила включения агенту, возможно, придётся подбирать. Как агент напишет этот текст сам, мы не смотрели.
Схема пишется на языке LikeC4, имя должно быть новым.
Сохранить схему агент может, дописав её в файл модели, сервер этого не делает.
Промпт
Через likec4 собери черновую схему crmdraft «Кто ходит в старую CRM»: старая CRM и всё, что к ней обращается и к чему обращается она. Ничего не сохраняй, только скажи, какие элементы и связи попали на схему.
Бесплатно: почта или сразу Телеграм-канал клуба
Пример работы
редакция, прогон при проверке 17.10.2026
Задача
Узнать, что заденет правка сервиса заказов
Промпт
Через likec4 найди сервис заказов и покажи всё, что от него зависит, со связями и местом в файлах
Что сделал агент
search-element по слову «заказ» за 5 мс нашёл элемент «Заказы» и схемы, на которых он есть.
read-element показал входящую связь от сайта по REST и четыре исходящие: в базу данных, платёжный сервис, уведомления и старую CRM, с файлом и строкой.
query-outgoers-graph за 3 мс собрал пять зависимых элементов, включая почтовый сервис через уведомления.
После того как мы дописали в файл модели сервис «Отчёты», поиск нашёл его через четыре секунды без перезапуска сервера.
Результат
Через npx сервер отработал 24 вызова всех 20 инструментов, три ошибки из них ожидаемые. Ещё 26 вызовов нашим клиентом на SDK из установленного пакета прошли без единого соединения. Инструменты вызывали mcp-probe и наш клиент, агент Claude Code промпт не выполнял.
Инструменты
20 · описания около 16,1 тыс. токенов
Жёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если архитектура продукта не описана в файлах LikeC4, сервер ничего не даст: он читает только такую модель и сам её не пишет. Одну небольшую схему агент прочитает и без сервера, прямо из файла .c4. Сервер добавляет в память агента около 16 тысяч токенов описаний, и это заметно, если в настройках Claude Code выключен поиск инструментов.
Частые проблемы
8
apply-semantic-layout в Claude Code отвечает «Failed to generate layout hints»
Инструмент просит у клиента ответ модели через запрос sampling. Claude Code 2.1.292 такую возможность серверу не объявляет, и на прогоне без неё инструмент вернул эту ошибку за 4 мс. Расположение схемы задавай в самом файле модели или в редакторе с расширением LikeC4. Остальные 19 инструментов работают без этой возможности.
Черновая схема не собирается, пришло «View "index" already exists in the project»
preview-view принимает только новое имя схемы. Сохранённую схему с тем же именем он показывать отказывается. Дай черновику новое имя, например crmdraft. Сохранённую схему показывает render-view.
Агент уверен, что сервер только читает, а в папке проекта появилась папка .likec4 с файлом снимка
Инструкция сервера говорит агенту «All tools are read-only». Это неверно для apply-semantic-layout: на прогоне наш тестовый клиент объявил поддержку таких запросов и вернул заготовленный ответ без всякой модели, и инструмент записал файл .likec4/orderflow.likec4.snap. Считай apply-semantic-layout записью на диск и не запускай его, если папку проекта менять нельзя. В Claude Code 2.1.292 он до записи не доходит и отвечает ошибкой. Если файл появился, его можно удалить или добавить папку .likec4 в .gitignore.
Агент не видит инструментов сервера
Клиент не перезапущен после подключения: 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): поиск инструментов выключается, и описания всех подключений грузятся целиком. Оставь включёнными только нужные подключения.
Файлы модели LikeC4 в папке проекта и её подпапках и файл настроек проекта. Всё, что агент запросил, сервер отдаёт агенту, и это вместе с разговором попадает к его модели, у Claude Code это Anthropic. Если в описаниях модели есть имена людей, адреса или другие личные данные, они уйдут туда же. Сам сервер из установленного пакета за 30 обращений не открыл ни одного соединения. При запуске через npx идёт обращение к реестру npm. В клиентах, которые открывают окно MCP Apps, окно схемы по коду может загружать значки элементов с icons.like-c4.dev, этот путь мы не проверяли: в Claude Code такого окна нет, а у тестовой модели значков не было. Тексты из файлов модели, в том числе написанные другими людьми, агент получает как есть.
Куда уходят данные
Данные уходят: модель лежит на твоём диске, а то, что сервер из неё прочитал, получает модель агента: у Claude Code это Anthropic. В клиентах с окнами MCP Apps окно схемы может загружать значки с icons.like-c4.dev, это мы не проверяли, страна обработки не указана сервисом.
Что может изменить
Файлы модели сервер не меняет. Один инструмент пишет на диск: apply-semantic-layout кладёт снимок расположения схемы в папку .likec4 проекта, но в Claude Code он не срабатывает, потому что клиент не даёт серверу запросов к модели. Если файл настроек проекта написан на JavaScript или TypeScript (likec4.config.js, .mjs, .ts, .mts), сервер выполняет его при запуске через esbuild: такой файл может делать на компьютере что угодно, поэтому чужой проект с таким файлом сначала прочитай. Файл настроек в JSON ничего не выполняет.
Наша проверка
Пакет @likec4/mcp выпускает проект LikeC4: страница документации likec4.dev даёт для Claude Code команду подключения этого пакета, код лежит в папке packages/mcp репозитория likec4/likec4, а версию 1.60.0 выложил в npm GitHub Actions из этого репозитория с подтверждением происхождения, лицензия MIT. В официальном реестре MCP записи нет. Скриптов preinstall, install и postinstall в package.json нет. Инструкция сервера говорит агенту, что все инструменты только читают, и просит давать ссылку на место в файле. Но apply-semantic-layout пишет файл, и пометки «только чтение» нет только у него. Просьб что-то скрыть, отправить или прочитать ключи в инструкции и описаниях нет. В коде есть запуск программ Graphviz dot и unflatten, он включается только ключом --graphviz binary, которого в нашей команде нет. С файлом настроек в JSON сервер, по журналу запусков, не стартовал никаких программ, кроме node. В одноразовой песочнице Ubuntu 24.04.5 на Node.js 22.23.3 мы вызвали все 20 инструментов на тестовой модели. На id ../../etc/passwd read-element ответил, что такого элемента нет. OSV и npm audit по 114 пакетам дерева зависимостей записей не нашли. Версия в команде закреплена.
Версия
В командах закреплена версия 1.60.0: ставится ровно то, что мы проверили.
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
