n8n-mcp - n8n-MCP, агент собирает сценарии n8n

Что понадобится: Node.js и npm; для управления сценариями - свой n8n с включённым доступом по API.

Когда звать

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

Что это

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

n8n-MCP решает это базой знаний. По README в ней 3 143 узла (841 основной и 2 302 из сообщества), свойства и операции узлов, документация, примеры настроек из популярных шаблонов и библиотека из 2 352 шаблонов сценариев. Цифры привязаны к версии 2.95.0 и меняются с каждым выпуском.

Это сторонний проект, его ведёт отдельный автор, не команда n8n. По README он начался как личный инструмент.

Два режима, и разница огромная

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

С управлением. Если дать адрес и ключ своего n8n, агент получает инструменты создания, правки, запуска и удаления сценариев, а также работы с учётными данными и таблицами. Автор предупреждает прямо: никогда не правь рабочие сценарии через ИИ напрямую. Сделай копию, проверь на тестовом экземпляре, держи резервные копии.

Как подключить справочный режим

Из руководств автора для клиентов.

В Claude Code:

claude mcp add n8n-mcp -e MCP_MODE=stdio -e LOG_LEVEL=error -e DISABLE_CONSOLE_OUTPUT=true -- npx n8n-mcp

В Codex нужно добавить блок в файл ~/.codex/config.toml:

[mcp_servers.n8n]
command = "npx"
args = ["n8n-mcp"]
env = { "MCP_MODE" = "stdio", "LOG_LEVEL" = "error", "DISABLE_CONSOLE_OUTPUT" = "true" }

Проверка: после подключения попроси агента найти узел для отправки сообщения в Telegram и показать его обязательные параметры. Он должен вызвать инструменты базы и не отвечать по памяти.

Режим с управлением мы здесь не разбираем: он требует ключ от твоего n8n, и включать его стоит только на тестовой копии. Описание переменных и безопасных ограничений - в README.

Как урезать риск

Автор даёт два рычага. DISABLED_TOOLS убирает инструменты целиком, например создание и удаление сценариев, управление учётными данными и таблицами. DISABLED_TOOL_OPERATIONS убирает только опасные операции там, где чтение нужно оставить. Для компаний с жёсткими требованиями README рекомендует использовать обе.

Что ещё

Статистика использования включена по умолчанию, в файле о конфиденциальности автор описывает, что собирается, и приводит команду отключения. Облачный вариант на сайте автора не требует установки, но это его сервис, и условия там свои.

Мы сверили всё с README и руководствами на 22 октября 2026 года. Сам сервер не запускали. Если пока не решил, нужен ли тебе n8n, посмотри сначала как агенты работают с сервисами через MCP.