n8n MCP

n8n MCP

AutomateLab-techMIT
7 звёзд
n8n-mcp — сервер для ИИ-агентов (Claude, Cursor), созданный для отладки и генерации рабочих процессов n8n. Разработчики AutomateLab сфокусировались на конкретной проблеме: сгенерированный JSON импортируется, но падает в рантайме. Сервер исправляет это. Это не очередная база знаний по n8n. Конкуренты делают упор на количество инструментов и обширный каталог узлов. n8n-mcp занимает другую нишу — корректность с первого запуска и глубокая отладка. Инструменты execution.explain, workflow.generate и workflow.lint заточены под самые частые проблемы n8n-сообщества: тихие падения, потеря данных между узлами, неверные типы соединений в AI Agent кластерах. Проект под MIT-лицензией, исходный код на GitHub. Если вы работаете с n8n и ИИ-агентами — это обязательный инструмент в вашем наборе.
РазработкаФайлыn8n
Подключить MCPОткрыть на GitHub
Подключение

Подключить n8n MCP

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

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить n8n MCP

n8n MCP относится к Разработка, Файлы, n8n. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
TypeScript
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

Характеристики

Общее

  • СтатусСообщество
  • РазработчикAutomateLab-tech
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Диагностика исполнения (execution.explain): загрузите JSON упавшего workflow — сервер укажет узлы с нулевым результатом, неразрешённые выражения и точные причины ошибки.
  • Генерация workflow (workflow.generate): создаёт готовые процессы с корректной топологией AI Agent. Узлы подключаются через правильные типы соединений (ai_languageModel, ai_memory, ai_tool), а не через main.
  • Линтинг (workflow.lint): проверяет процессы на скрытые дефекты. Находит устаревшие узлы (Function вместо Code), отсутствие языковой модели у агента, сломанные связи и неправильные версии схем.
  • Управление через REST: если настроены N8N_API_URL и N8N_API_KEY, сервер получает доступ к вашему экземпляру: просмотр, создание, активация процессов и загрузка исполнений.
  • Работа с живыми данными: инструменты lint и explain могут анализировать не просто JSON из чата, а реальные процессы из вашего n8n.
  • Глубокий анализ соединений: проверяет все типы связей, а не только main. Выявляет разрывы цепочек, которые обычно остаются незамеченными.
  • Agent Skill: к серверу прилагается инструкция, которая подсказывает модели, какой инструмент вызывать в каждой ситуации (хранится отдельно, чтобы не перегружать промпт).

Как подключить

Установка выполняется одним пакетом через npx. Никаких глобальных зависимостей, только Node.js.

1. Запустите сервер через npx:

npx -y @automatelab/n8n-mcp

2. Добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop:

{ "mcpServers": { "n8n": { "command": "npx", "args": ["-y", "@automatelab/n8n-mcp"], "env": { "N8N_API_URL": "https://ваш-n8n.домен", "N8N_API_KEY": "ваш-секретный-ключ" } } } }

3. Перезагрузите клиент. Если вам нужны только генерация и линтинг, переменные окружения указывать не обязательно. Основной функционал будет работать только с JSON, который вы передадите в диалоге.

Для работы с живым экземпляром n8n укажите адрес сервера и API-ключ в переменных окружения.

Примеры запросов

  • «Вот JSON неработающего workflow. Объясни, почему на четвёртом узле пустой вывод и где потерялись данные.»
  • «Сгенерируй workflow для обработки заявок: вебхук → AI Agent с памятью → база данных. Сделай все соединения корректными.»
  • «Загрузи все активные процессы из моего n8n и проверь их на ошибки с помощью линтера.»
  • «Проверь этот workflow на устаревшие узлы и исправь их автоматически.»
  • «Вот execution JSON неудачного запуска. Найди, где произошла потеря данных. Проверь, все ли узлы вернули ожидаемое количество элементов.»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Cursor и любые клиенты, поддерживающие MCP-протокол.
  • REST-инструменты требуют указания N8N_API_URL и N8N_API_KEY. Без них доступны только генерация, линтинг и диагностика по JSON.

Поделиться