n8n-mcp

Сообщество

Romuald Członkowski · лицензия MIT

Агент соберёт сценарий n8n из нужных узлов и проверит его до запуска

На твоём компьютереБез ключаРаботает из РоссииТолько читаетБесплатноДанные остаются на компьютереЧитает тексты посторонних: шаблоны сценариев от авторов n8n.io, описания узлов сообщества

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

Подключить ↓Что можно сделать ↓

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

Найдёт узел n8n под задачу, например Telegram, Google Sheets или HTTP-запрос, и покажет его версию, операции и обязательные поля, чтобы агент не выдумывал параметры.
Проверит сценарий до запуска: пустые обязательные поля, выражения без знака =, связи с несуществующими узлами - и подскажет, как исправить.
Подберёт шаблон из 2 352 сценариев с n8n.io по сервису, узлам или сложности и отдаст его целиком, чтобы агент собрал твой сценарий на его основе.
Работает без своего n8n: агент собирает и проверяет JSON сценария у тебя на компьютере. Готовый сценарий останется вставить в свой n8n или загрузить файлом.

Паспорт

Кто сделал: Romuald Członkowski
Статус: Сообщество
Лицензия: MIT
Проверено: 28.09.2026
Версия: 2.90.0
Где работает: На твоём компьютере
Доступ: Без ключа
Россия: Работает из России
Данные: Данные остаются на компьютере
Цена: Бесплатно
Проверено в: Claude Code
Исходный код: github.com/czlonkowski/n8n-mcp

Подключить

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

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

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

Данные сервера (каталог smyslokod.ru, проверено 28.09.2026):
- имя в конфиге: n8n-mcp
- официальный источник: https://github.com/czlonkowski/n8n-mcp
- запуск: npx -y n8n-mcp@2.90.0
- переменные окружения сервера: N8N_MCP_TELEMETRY_DISABLED=true

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

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

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

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

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

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

Первый запуск дольше обычного: npx скачивает пакет, около 34 МБ, внутри вся база узлов и шаблонов. Переменная N8N_MCP_TELEMETRY_DISABLED=true в команде выключает статистику использования: по умолчанию сервер отправляет автору, какие инструменты ты вызываешь, и сами сценарии после вычистки ключей и адресов. Лучше всего сервер работает на Node.js 20 или 22: для них модуль базы better-sqlite3 скачивается готовым. На Node.js 24 и новее (сейчас nodejs.org предлагает 24) готовой сборки нет, и если собрать модуль на месте не выйдет, сервер работает на запасном варианте со слабым поиском (подробнее в частых проблемах). Если добавить адрес и ключ своего n8n (N8N_API_URL и N8N_API_KEY), у сервера появятся инструменты управления сценариями: создать, изменить, запустить, удалить. Так пишет автор, этот режим мы не проверяли. Ключ n8n клади в настройки подключения сам и агенту в чат не присылай.

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

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

Найди в n8n узел Telegram и скажи, какие поля обязательны для отправки сообщения

Что должно получиться: Агент вызовет search_nodes и get_node и ответит: узел nodes-base.telegram, версия 1.2, для отправки сообщения обязательно поле Chat ID.

Что можно сделать

4 сценария

Ответ validate_workflow из нашего прогона: сценарий из трёх узлов, 2 ошибки в узле «Сообщение в Telegram» - пустой Chat ID и выражение без знака = с исправленной строкой

Заявка с сайта: сообщение в Telegram и строка в таблице

Агент соберёт сценарий n8n: узел Webhook принимает заявку, Telegram присылает тебе имя и телефон, Google Sheets добавляет строку в таблицу. Перед тем как отдать JSON, он прогонит проверку и исправит найденное.

search_nodes и get_node: Webhook, Telegram (версия 1.2) и Google Sheets (версия 4.7), для отправки сообщения в Telegram обязателен Chat ID.
validate_workflow на первом варианте нашёл 2 ошибки: пустой Chat ID и выражение без знака = в тексте сообщения, для выражения сразу дал исправленную строку.
После двух правок проверка прошла: 3 узла, 2 связи, 4 выражения, ошибок нет.

Промпт

Собери сценарий n8n: узел Webhook принимает заявку с сайта методом POST (поля name и phone), узел Telegram присылает мне сообщение с именем и телефоном, узел Google Sheets добавляет строку в таблицу «Заявки» с колонками «Имя» и «Телефон». Узлы найди через search_nodes, их версии и обязательные поля возьми из get_node. Поля заявки для таблицы бери из узла Webhook через $('Имя узла Webhook').item.json: после узла Telegram в $json лежит уже его ответ. Chat ID и ID таблицы оставь как [ВСТАВЬ_CHAT_ID] и [ВСТАВЬ_ID_ТАБЛИЦЫ]. Готовый JSON прогони через validate_workflow и исправляй, пока ошибок не останется. В конце дай JSON целиком и скажи, что заполнить перед запуском.

Бесплатно: почта или сразу Телеграм-канал клуба

Совет. Проверка не видит, откуда берутся данные: вариант, где таблица брала поля заявки через $json после узла Telegram, у нас прошёл её без замечаний. По документации n8n $json - это вход текущего узла, здесь ответ Telegram, поэтому поля заявки бери через $('Заявка с сайта').item.json.
Совет. Готовый JSON вставляется прямо в редактор n8n или импортируется файлом.

Ответ validate_workflow из нашего прогона: связь ведёт к несуществующему узлу «Сообщение в телеграм», два узла недостижимы от запуска

Проверить готовый сценарий и исправить ошибки

Агент прогонит JSON сценария через проверку, объяснит каждую ошибку простыми словами, исправит и проверит ещё раз.

validate_workflow проверяет узлы, связи и выражения и к ошибкам даёт подсказки.
В нашем прогоне опечатка в имени узла в связях дала ошибку «Connection to non-existent node» и предупреждение, что два узла недостижимы от запуска.

Промпт

Вот сценарий n8n: [ВСТАВЬ JSON ИЛИ ПУТЬ К ФАЙЛУ]. Прогони его через validate_workflow. Каждую ошибку и предупреждение объясни простыми словами: что не так и что случится при запуске. Исправь по подсказкам проверки, настройки исправленных узлов сверь с get_node и проверь сценарий ещё раз. Покажи, что поменял, и дай итоговый JSON.

Бесплатно: почта или сразу Телеграм-канал клуба

Совет. Имена узлов в связях сравниваются посимвольно: «Сообщение в телеграм» и «Сообщение в Telegram» для проверки - разные узлы.

Найти готовый шаблон под задачу

Агент найдёт в шаблонах n8n.io подходящие сценарии, покажет, из каких узлов они собраны, возьмёт лучший целиком и проверит его.

search_templates с отбором «сервис telegram, сложность simple» нашёл 20 шаблонов.
get_template 4818 отдал сценарий целиком: триггер WooCommerce и узел Telegram, автор и ссылка на n8n.io.
validate_workflow по этому шаблону: ошибок нет, проверено 6 выражений.

Промпт

Найди в шаблонах n8n готовый сценарий под задачу: [ОПИШИ ЗАДАЧУ, например «присылать в Telegram уведомление о новом заказе»]. Ищи через search_templates по сервису и сложности (searchMode by_metadata, requiredService, complexity simple) и по одному ключевому слову. Покажи 3-5 подходящих: название, из каких узлов собран, ссылка на n8n.io, автор. Лучший возьми целиком через get_template, перескажи, что сценарий делает и куда отправляет данные, потом прогони через validate_workflow и скажи, что в нём заменить на моё: Chat ID, ключи, адреса.

Бесплатно: почта или сразу Телеграм-канал клуба

Совет. Поиск по нескольким узлам (by_nodes) находит шаблоны, где есть хотя бы один из них: у нас по Webhook, Telegram и Google Sheets первым шёл шаблон только с Google Sheets. Проси агента сверять список узлов.
Совет. Шаблоны пишут авторы n8n.io, это чужие тексты: прежде чем запускать, пусть агент перескажет, что сценарий делает и куда отправляет данные.

Узнать, какие поля нужны узлу

Агент покажет версию узла, его операции и обязательные поля и проверит твои настройки узла до запуска.

get_node по узлу Telegram: версия 1.2, 37 операций, для отправки сообщения обязателен Chat ID.
validate_node в быстром режиме на настройках без Chat ID ответил valid: false и назвал недостающее поле.

Промпт

Мне нужен узел n8n для задачи: [СЕРВИС И ДЕЙСТВИЕ, например «отправить сообщение в Telegram»]. Найди его через search_nodes, возьми get_node с detail standard и скажи простыми словами: какую версию узла ставить, какие поля обязательные и где взять их значения. Потом проверь мои настройки через validate_node: [ВСТАВЬ НАСТРОЙКИ ИЛИ ОПИШИ ИХ].

Бесплатно: почта или сразу Телеграм-канал клуба

Совет. Ищи по короткому названию: по «bitrix24» у нас пусто, по «bitrix» нашёлся узел сообщества без проверки n8n (isVerified: false). Узлы сообщества ставятся в n8n отдельно, бери их только после проверки.

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

Задача

Собрать сценарий «заявка через Webhook, сообщение в Telegram, строка в Google Sheets» и проверить его до запуска

Промпт

Собери сценарий n8n: узел Webhook принимает заявку (name, phone), Telegram присылает сообщение, Google Sheets добавляет строку. Проверь его через validate_workflow и исправь ошибки.

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

search_nodes: по словам webhook, telegram и google sheets первыми нашлись нужные узлы Webhook, Telegram и Google Sheets.
get_node: у Telegram версия 1.2 и обязательный Chat ID, у Google Sheets версия 4.7.
validate_workflow на первом варианте: 2 ошибки в узле Telegram - пустой Chat ID и выражение без знака = в тексте, с исправленной строкой.
После двух правок проверка прошла: 3 узла, 2 связи, 4 выражения, ошибок нет.

Результат

Восемь вызовов на Node.js 22 заняли от 2 до 10 мс каждый, сам сервер в сеть не ходил. Проверка пропустила вариант, где таблица брала поля заявки через $json после Telegram: такие места агенту стоит поправить через $('Заявка с сайта').item.json.

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

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

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

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

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

Если у тебя свой n8n версии 2.13 или новее, сначала попробуй встроенный MCP-сервер n8n: он включается в настройках самого n8n (Settings → Instance-level MCP), сам ищет узлы, проверяет сценарий и создаёт его прямо в твоём n8n, ставить на компьютер ничего не нужно. n8n-mcp нужен, когда своего n8n нет или он старше 2.13, когда нужны шаблоны с n8n.io и узлы сообщества или когда хочешь собрать и проверить JSON сценария у себя на компьютере, не трогая рабочий n8n.

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

Поиск «google sheets» выдаёт Google Ads и Analytics, поиск шаблонов по двум словам пустой

Не поставился модуль базы better-sqlite3: у версии 2.90.0 нет его готовых сборок для Node.js 24 и новее, а собрать на месте не вышло. Сервер работает на запасном варианте, где поиск проще и не работает отбор узлов по source. Поставь Node.js 22: там модуль скачивается готовым, и поиск у нас работал полностью. Если остаёшься на новой версии, ищи по одному отличительному слову: «sheets», «telegram», а у узлов сообщества сам смотри поле isVerified.

Ответ «Workflow patterns not generated yet. Run: npm run mine:patterns»

В пакете из npm нет заготовки для режима patterns у search_templates. Команда из ответа к установке через npx не относится. Проси искать шаблоны по слову, по узлам или по параметрам: сервис и сложность (searchMode by_metadata).

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

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

Агент путается в инструментах и медленно отвечает

В настройках Claude Code задан свой адрес подключения (ANTHROPIC_BASE_URL): поиск инструментов выключается, и описания всех подключений грузятся целиком. Оставь включёнными только нужные подключения.

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

Кто сделал: Romuald Członkowski (сообщество). Исходный код: github.com/czlonkowski/n8n-mcp, лицензия MIT.
Что видит агент: Только то, что агент сам передаёт серверу: названия узлов, запросы поиска, JSON сценариев на проверку. Узлы и шаблоны сервер берёт из своей базы внутри пакета, к аккаунтам и к n8n без адреса и ключа не обращается. Всё, что он возвращает, уходит в модель вместе с разговором.
Куда уходят данные: Данные остаются на компьютере.
Что может изменить: Без адреса и ключа n8n твои данные и сценарии он не меняет: все 7 инструментов читают базу и проверяют присланный сценарий. Пишет только в свою базу в кеше npx: при запуске с модулем better-sqlite3 проверяет, умеет ли база полнотекстовый поиск, и для этого создаёт и удаляет пробную таблицу. Папку статистики ~/.n8n-mcp с выключенной статистикой не создаёт. С адресом и ключом n8n сможет создавать, менять, запускать и удалять сценарии в твоём n8n (по документации автора, мы не проверяли).
Тексты посторонних: Читает тексты посторонних: шаблоны сценариев от авторов n8n.io, описания узлов сообщества. В таком тексте могут прятаться команды для агента.
Наша проверка: Источник - репозиторий czlonkowski/n8n-mcp и пакет n8n-mcp в npm: его собрал GitHub Actions из этого репозитория, есть подпись происхождения, лицензия MIT. В официальном реестре MCP сервера нет, в документации n8n ссылок на него нет, поэтому метка «Сообщество». В базе OSV у версии 2.90.0 записей нет: 11 прежних уязвимостей закрыты не позже версии 2.57.4; у 150 зависимостей на дату проверки тоже чисто. У самого пакета команд, которые запускаются при установке, нет; необязательная зависимость better-sqlite3 при установке скачивает готовую сборку с GitHub или собирает её на месте. Описания всех 7 инструментов прочитаны целиком, скрытых указаний агенту нет, своих инструкций у сервера нет. По умолчанию сервер отправляет статистику и сценарии на сервер автора в Германии (Microsoft Azure), обезличенные сценарии идут в наборы данных для моделей ИИ, автор может передавать их другим компаниям; в команде каталога это выключено переменной. С выключенной статистикой сам сервер за время проверки не открыл ни одного соединения, npx при запуске сверяется с реестром npm. Версия в команде закреплена.
Версия: В командах закреплена версия 2.90.0: ставится ровно то, что мы проверили.

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

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

Полезные материалы

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

Дата	Версия	Где	Итог	Отпечаток
28.09.2026	2.90.0	Claude Code, macOS	работает	dd1fa4e70d7113c4

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

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