Что сможет агент
- Найдёт узел n8n под задачу, например Telegram, Google Sheets или HTTP-запрос, и покажет его версию, операции и обязательные поля, чтобы агент не выдумывал параметры.
- Проверит сценарий до запуска: пустые обязательные поля, выражения без знака =, связи с несуществующими узлами - и подскажет, как исправить.
- Подберёт шаблон из 2 352 сценариев с n8n.io по сервису, узлам или сложности и отдаст его целиком, чтобы агент собрал твой сценарий на его основе.
- Работает без своего n8n: агент собирает и проверяет JSON сценария у тебя на компьютере. Готовый сценарий останется вставить в свой n8n или загрузить файлом.
- Кто сделал
- Romuald Członkowski, сообщество
- Версия
- 2.90.0
- Проверено
- 28.09.2026, Claude Code
- Лицензия
- MIT
Подключить
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Подключи MCP-сервер «n8n-mcp» версии 2.90.0. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог code.tarasovweb.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://code.tarasovweb.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 сценарияЗаявка с сайта: сообщение в 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 или импортируется файлом.
Проверить готовый сценарий и исправить ошибки
Агент прогонит 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 отдельно, бери их только после проверки.
Пример работы
редакция, прогон при проверке 28.09.2026- Задача
- Собрать сценарий «заявка через 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.
Инструменты
7 · описания около 3,4 тыс. токеновЖёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В 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.
Частые проблемы
7Поиск «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 (по документации автора, мы не проверяли).
- Наша проверка
- Источник - репозиторий 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: ставится ровно то, что мы проверили.
- Проверить самому
- агент прочитает код подключения как недоверенный
Полезные материалы
- Инструкция · на английскомn8n-mcp: репозиторий и инструкцияОфициальный источник: все инструменты, режим управления сценариями, настройка только для чтения.
- Инструкция · на английскомКакие данные n8n-mcp отправляет авторуПолитика статистики: что собирается по умолчанию, где хранится и как выключить.
- Инструкция · на английскомВстроенный MCP-сервер n8nДругое подключение: живёт внутри твоего n8n, ищет и запускает его сценарии, а с версии 2.13 сам собирает новые.
- Инструкция · на английскомКак поставить n8n на свой серверОфициальная инструкция n8n: Docker, установка одной командой, бесплатная версия Community.
Журнал проверок
- 28.09.2026·2.90.0·Claude Code, macOS·работаетdd1fa4e70d7113c4
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
