n8n MCP Server
MCP-сервер для n8n: агент управляет воркфлоу и их запусками через API n8n естественным языком, создает, обновляет, включает и запускает сценарии
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Пишет в внешнюю систему автоматизации: создает, меняет, включает, удаляет и запускает воркфлоу
- Получает права ключа API n8n и может затронуть боевые сценарии
Установка
Ручная установка
npm install -g @leonardsellem/n8n-mcp-serverГлобальная установка из npm. После этого сервер доступен командой n8n-mcp-server.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает агента с вашим экземпляром n8n через его API и дает набор инструментов для работы с воркфлоу и запусками. Через них агент выводит список воркфлоу, читает и создает их, обновляет, включает и выключает, удаляет, а также запускает воркфлоу и смотрит запуски: список, детали, повтор, удаление записи запуска. Сервер запускается по транспорту stdio как локальный процесс или в Docker, настраивается переменными окружения: адрес API n8n, ключ API и при работе с вебхуками логин и пароль. Пакет опубликован в npm, ставится глобально или собирается из исходников на TypeScript. Это мост управления: агент отдает команды на естественном языке, а сервер переводит их в вызовы API n8n.
Для кого. Для разработчиков и инженеров автоматизации, у которых есть свой n8n и которые хотят управлять воркфлоу через агента.
Подходит, если
- Нужно управлять воркфлоу n8n из агента: список, создание, обновление, включение
- Нужно запускать воркфлоу и разбирать их запуски вместе с агентом
- Нужно подключить свой n8n к агенту через MCP и API n8n
Не подходит, если
- Нет своего экземпляра n8n с включенным API
- Нельзя давать агенту право менять и запускать боевые воркфлоу
Пример запроса к агенту
Покажи все мои воркфлоу в n8n и включи тот, что называется рассылка отчетовОграничения
Нужен свой экземпляр n8n с включенным API и ключ API. Сервер получает права этого ключа, поэтому агент может менять, включать и запускать воркфлоу, в том числе боевые: давайте ключ с нужным объемом прав и держите его в секрете. Последний релиз это версия 0.1.8, обновлений давно не было, а используемая версия MCP SDK устаревшая, что может влиять на совместимость с новыми клиентами. Для вебхуков нужны отдельные логин и пароль.
Как отключить. Уберите запись сервера из конфигурации MCP клиента. При глобальной установке удалите пакет: npm uninstall -g @leonardsellem/n8n-mcp-server. Для отзыва доступа отключите ключ API в настройках n8n.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| N8N_API_URL обязательная | Полный адрес API n8n, включая /api/v1 |
| N8N_API_KEY обязательная, секрет | Ключ API для доступа к n8n, создается в настройках n8n |
| N8N_WEBHOOK_USERNAME | Логин для аутентификации вебхуков, если они используются |
| N8N_WEBHOOK_PASSWORD секрет | Пароль для аутентификации вебхуков |
| DEBUG | Включение отладочного лога, true или false |
Проверка безопасности
- Пишет в внешнюю систему автоматизации: создает, меняет, включает, удаляет и запускает воркфлоу
- Получает права ключа API n8n и может затронуть боевые сценарии
Коротко о README
README описывает MCP-сервер, который позволяет агенту управлять n8n через его API естественным языком. Ставится из npm, из исходников или в Docker, для работы нужен n8n 20-й версии Node и выше и включенный API. Настройка идет через файл env: адрес API n8n, ключ API и логин с паролем для вебхуков. Есть инструменты для воркфлоу и для запусков, а также раздел про интеграцию с ассистентами вроде Claude Desktop и VS Code через JSON-конфигурацию. Описан порядок обновления для каждого способа установки. Лицензия MIT.
Частые вопросы
Как выдать ключ API n8n?
В интерфейсе n8n откройте Settings, затем API, затем API Keys, создайте ключ с нужными правами и запишите его в переменную N8N_API_KEY.
Можно запускать в Docker?
Да. Есть образ, который запускается с теми же переменными окружения: адрес API, ключ и при необходимости логин и пароль для вебхуков.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub