Для чего этот сервер?

Этот MCP-сервер решает проблему, когда AI-агенты генерируют n8n-воркфлоу, которые импортируются, но ломаются в рантайме. Он ловит тихие ошибки — неправильные соединения, устаревшие узлы, потерянные данные между шагами. Проверяет топологию AI Agent, чтобы кластеры LangChain импортировались чисто. А если выполнение упало, объясняет на пальцах, что пошло не так и где копать. Полезен всем, кто автоматизирует через n8n с помощью ИИ.

Что он умеет?

Сервер работает с n8n: генерирует валидный JSON воркфлоу из текстового описания, прогоняет его через линтер на устаревшие ноды, битые соединения и пропавшие креды. Разбирает упавшие выполнения: объясняет, какие ноды вернули ноль элементов, подсвечивает нераскрытые выражения и строит таймлайн по узлам. Сравнивает два воркфлоу, собирает replay-воркфлоу для отладки отдельной ноды, создаёт скелет TypeScript-ноды. На живой инстанс ходит через REST: листает, читает, создаёт, включает и выключает воркфлоу, вытаскивает список выполнений.

Каталог MCP
AutomateLab-tech/n8n-mcp

AutomateLab-tech/n8n-mcp

от automatelab-tech

MCP-сервер для n8n, который даёт AI-агентам инструменты генерации, линтинга и диагностики workflow. Помогает быстро создавать корректные workflow, отлавливать ошибки выполнения и управлять live-экз...

Github NPM Сайт сервера

README

12 инструментов

Версии

Установить сервер

n8n-mcp

An MCP server for n8n that gives Claude, Cursor, and other AI agents tools for generating workflows, linting, diagnosing failed executions, and driving live n8n instances.

Why we built this

We use n8n daily inside AutomateLab and kept hitting the same LLM failures: workflow JSON that imports but fails at runtime, AI Agent clusters wired with the wrong connection types, executions that silently drop items with no clue where to look. Dumping the whole n8n catalog into context doesn't fix it - the failure modes are too subtle (typeVersion mismatches, IF v1 schema, credentials that don't survive import).

So we built a small, focused server: encode the failure modes the lint can catch, the cluster topology the generator must respect, and the diagnosis the agent can't do alone. For a walkthrough of the nine tools with example output, see the launch post on automatelab.tech.

Why it's different

Other n8n MCP servers (notably czlonkowski/n8n-mcp) compete on breadth - 20+ tools and an indexed corpus of every n8n node. They own that niche.

Часто задаваемые вопросы

Инструменты были проиндексированы: 18.10.2026

execution_explainтолько чтениеидемпотентный

Диагностирует неудачное или неожиданное выполнение n8n. Вставьте JSON выполнения (из интерфейса n8n «Show details» или GET /executions/:id?includeData=true); возвращает сводку по каждому узлу с подсветкой узлов, вернувших 0 элементов, неразрешённых выражений ={{ ... }}, ошибок с подсказками и использования токенов LLM. Затрагивает самую частую боль при отладке: элементы «бесшумно исчезают» между узлами. Детерминированный, основанный на правилах.

Объяснить неудачное выполнение n8n

Параметры

executionobject | stringобязательный
Payload выполнения n8n (форма REST ?includeData=true или сырой экспорт из UI). Объект или JSON-строка.

execution_listтолько чтениеидемпотентныйвнешний мир

Выводит список последних выполнений из активного экземпляра n8n (требуются N8N_API_URL и N8N_API_KEY). Фильтруйте по workflowId, статусу (success|error|waiting), лимиту. Передайте includeData: true, чтобы получить полное тело выполнения (большое) — используйте вместе с execution_explain для диагностики конкретной ошибки.

Выведи список недавних выполнений n8n

Параметры

includeDataboolean
Включает полные данные выполнения (большой объем). По умолчанию false. Используется вместе с execution_explain.
limitinteger
Размер страницы (по умолчанию в n8n: 100, максимум: 250).
statusenum
Отфильтруйте по статусу: успех | ошибка | ожидание.
workflowIdstring
Фильтр по ID рабочего процесса.

execution_replayтолько чтениеидемпотентный

Создай самодостаточный воркфлоу для повтора, который отрабатывает одну ноду из большого воркфлоу. Воркфлоу для повтора выглядит так: Manual Trigger -> Replay Seed (нода Code с закреплёнными элементами) -> целевая нода. Опциональные inputItems или полезная нагрузка execution фиксируют то, что видит целевая нода. Это полезно для итерации по одной упрямой ноде без повторного запуска всего пайплайна. Возвращает JSON воркфлоу, готовый для импорта или отправки через workflow_create.

Создаёт рабочий процесс повторного воспроизведения для одного узла.

Параметры

executionobject | string
Необязательный payload для выполнения: получает реальные входные данные, которые цель видела в прошлый раз.
inputItemsobject[]
Необязательные явные входные элементы (каждый становится { json: ... }).
nodestringобязательный
Имя узла для повторного воспроизведения.
workflowobject | stringобязательный
Исходный рабочий процесс JSON.

execution_timelineтолько чтениеидемпотентный

Рендерит выполнение n8n как временную шкалу по узлам: смещение старта, длительность, элементы на входе/выходе, флаг ошибки. Дополняет execution_explain — тот показывает почему, этот показывает когда. Результат — таблица в Markdown, отсортированная по времени старта. Детерминированно.

Отобразить выполнение как временную шкалу для каждого узла.

Параметры

executionobject | stringобязательный
n8n payload выполнения (обязательно должен включать data.resultData.runData).

node_scaffoldтолько чтение

Создай каркас TypeScript для пользовательского узла n8n из описания на простом английском. Возвращает один файл TypeScript, реализующий INodeType с описанием, ссылкой на учётные данные и заглушкой метода execute. Чистая генерация кода — без сети, без записи в файловую систему.

Создаёт заготовку кастомного узла n8n

Параметры

descriptionstringобязательный
Описание на простом английском языке того, что должен делать узел (1+ символов).
nodeNamestring
Необязательное имя класса в PascalCase, например 'DiscordRateLimited'. Если не указано, выводится из описания.

workflow_activateидемпотентныйвнешний мир

Активирует или деактивирует рабочий процесс (workflow) на активном экземпляре n8n (требуется N8N_API_URL + N8N_API_KEY). Передайте active: false для деактивации. Идемпотентно - повторная активация уже активного рабочего процесса не вызывает никаких изменений на стороне n8n.

Активировать или деактивировать рабочий процесс

Параметры

activeboolean
По умолчанию true (активировать). Установите false, чтобы деактивировать.
idstringобязательный
Идентификатор рабочего процесса.

workflow_createвнешний мир

Создаёт workflow на работающем экземпляре n8n (требуется N8N_API_URL + N8N_API_KEY). Удаляет поля только для чтения (id, active, createdAt, ...) перед отправкой. Workflows создаются неактивными — после этого вызывайте workflow_activate. Сочетается с workflow_generate для сквозного процесса 'describe -> deploy'.

Создайте рабочий процесс на работающем экземпляре n8n.

Параметры

workflowobject | stringобязательный
JSON рабочего процесса для создания (обычно результат работы workflow_generate). Либо разобранный объект, либо JSON-строка.

workflow_diffтолько чтениеидемпотентный

Семантический diff между двумя workflow. Сообщает о добавленных, удаленных и измененных узлах (с поузловыми изменениями: type, typeVersion, parameters, credentials, disabled, position), об изменениях топологии соединений и расхождении настроек. Игнорирует шум (небольшие смещения позиции, createdAt/updatedAt). Используйте вместе с workflow_get, чтобы сравнить развернутую версию с локальной. Детерминирован.

Семантическая разница между двумя рабочими процессами n8n

Параметры

afterobject | stringобязательный
JSON рабочего процесса 'after'.
beforeobject | stringобязательный
JSON рабочего процесса «before».

workflow_generateтолько чтение

Генерирует корректный JSON-код рабочего процесса n8n по описанию на простом английском. Обрабатывает триггеры вебхуков, планировщика и RSS, общие узлы действий (Slack, Google Sheets, Discord, Gmail, Notion, HTTP) и настройки AI-агентов (корневой агент LangChain + модель чата + память + опциональный HTTP-инструмент, связанные через ai_languageModel / ai_memory / ai_tool соединения). Возвращает JSON рабочего процесса с уникальными ID узлов, связями, позициями и typeVersion на каждом узле. Вывод недетерминирован (случайные ID узлов и пути вебхуков).

Сгенерируйте рабочий процесс n8n из описания.

Параметры

descriptionstringобязательный
Описание рабочего процесса простым английским языком, например: 'Stripe webhook -> Slack message + Google Sheets row'.
namestring
Необязательное имя рабочего процесса. Если не указано, берётся из первого предложения описания.

workflow_getтолько чтениеидемпотентныйвнешний мир

Получает один workflow JSON по id из работающего экземпляра n8n (требуются N8N_API_URL + N8N_API_KEY). Возвращает полный набор узлов/соединений. Используйте вместе с workflow_lint для аудита развернутого workflow.

Получить один рабочий процесс по ID

Параметры

idstringобязательный
Идентификатор рабочего процесса.

workflow_lintтолько чтениеидемпотентный

Линтует JSON-схему n8n workflow. Возвращает конкретные ошибки и предупреждения: отсутствующие учётные данные, устаревшие типы узлов (Function -> Code, spreadsheetFile -> convertToFile/extractFromFile), разорванные соединения, отсутствующий или нечисловой typeVersion, повторяющиеся имена или ID узлов, AI Agent без подузла ai_languageModel, Webhook без webhookId, узел IF всё ещё на схеме условий v1, чувствительные к ограничениям узлы без повторных попыток, нарушения песочницы узла Code, устаревшие выражения ($('NodeName') ссылается на отсутствующие узлы), manualTrigger в активных workflow, отключённые, но подключённые узлы, пустые узлы Set, несоответствия HTTP метода и тела, риск перехода на летнее время триггера Schedule, расхождение учётных данных, тестовые пути webhook в активных workflow. Детерминировано, на основе правил.

Линтует JSON рабочего процесса n8n

Параметры

workflowobject | stringобязательный
Рабочий процесс n8n либо в виде разобранного объекта, либо в виде JSON-строки (будет разобрана).

workflow_listтолько чтениеидемпотентныйвнешний мир

Перечисляет рабочие процессы из живого экземпляра n8n (требуются переменные окружения N8N_API_URL + N8N_API_KEY). Возвращает id, name, active, nodeCount, updatedAt, tags. Фильтровать по active, tags, name. Используйте это, когда пользователь спрашивает «какие у меня workflows?» или перед workflow_get.

Вывести список рабочих процессов на работающем экземпляре n8n

Параметры

activeboolean
Фильтрует по активному статусу. Если не указано, возвращает и активные, и неактивные элементы.
limitinteger
Размер страницы (по умолчанию в n8n: 100, максимум: 250).
namestring
Фильтровать по точному имени workflow.
tagsstring
Имена тегов через запятую для фильтрации.

`1.1.1`основная	19.10.2026
`1.1.0`	08.06.2026
`0.5.5`	23.05.2026
`0.5.0`	21.05.2026
`0.3.0`	10.05.2026
`0.2.1`	10.05.2026
`0.2.0`	10.05.2026
`0.1.1`	09.05.2026
`0.1.0`	09.05.2026

Выберите клиент, чтобы установить AutomateLab-tech/n8n-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "automatelab-tech-n8n-mcp-1na3e2ln00": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "env": {
        "N8N_API_URL": "https://your-n8n.example.com",
        "N8N_API_KEY": "n8n_..."
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "automatelab-tech-n8n-mcp-1na3e2ln00": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "env": {
        "N8N_API_URL": "https://your-n8n.example.com",
        "N8N_API_KEY": "n8n_..."
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "automatelab-tech-n8n-mcp-1na3e2ln00": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "env": {
        "N8N_API_URL": "https://your-n8n.example.com",
        "N8N_API_KEY": "n8n_..."
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"automatelab-tech-n8n-mcp-1na3e2ln00\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@automatelab/n8n-mcp\"],\"env\":{\"N8N_API_URL\":\"https://your-n8n.example.com\",\"N8N_API_KEY\":\"n8n_...\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "automatelab-tech-n8n-mcp-1na3e2ln00": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "env": {
        "N8N_API_URL": "https://your-n8n.example.com",
        "N8N_API_KEY": "n8n_..."
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add automatelab-tech-n8n-mcp-1na3e2ln00 --env N8N_API_URL=https://your-n8n.example.com --env N8N_API_KEY=n8n_... -- npx -y @automatelab/n8n-mcp

Либо через JSON-конфиг:

claude mcp add-json automatelab-tech-n8n-mcp-1na3e2ln00 "{\"command\":\"npx\",\"args\":[\"-y\",\"@automatelab/n8n-mcp\"],\"env\":{\"N8N_API_URL\":\"https://your-n8n.example.com\",\"N8N_API_KEY\":\"n8n_...\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add automatelab-tech-n8n-mcp-1na3e2ln00 --env N8N_API_URL=https://your-n8n.example.com --env N8N_API_KEY=n8n_... -- npx -y @automatelab/n8n-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.automatelab-tech-n8n-mcp-1na3e2ln00]
command = "npx"
args = ["-y", "@automatelab/n8n-mcp"]

[mcp_servers.automatelab-tech-n8n-mcp-1na3e2ln00.env]
N8N_API_URL = "https://your-n8n.example.com"
N8N_API_KEY = "n8n_..."

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите AutomateLab-tech/n8n-mcp, а в поле команды запуска — строку ниже:

npx -y @automatelab/n8n-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "automatelab-tech-n8n-mcp-1na3e2ln00": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "env": {
        "N8N_API_URL": "https://your-n8n.example.com",
        "N8N_API_KEY": "n8n_..."
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "automatelab-tech-n8n-mcp-1na3e2ln00": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "env": {
        "N8N_API_URL": "https://your-n8n.example.com",
        "N8N_API_KEY": "n8n_..."
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например automatelab-tech-n8n-mcp-1na3e2ln00.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: automatelab-tech-n8n-mcp-1na3e2ln00
    command: npx
    args:
      - "-y"
      - "@automatelab/n8n-mcp"
    env:
      N8N_API_URL: https://your-n8n.example.com
      N8N_API_KEY: n8n_...

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "automatelab-tech-n8n-mcp-1na3e2ln00": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/n8n-mcp"
      ],
      "env": {
        "N8N_API_URL": "https://your-n8n.example.com",
        "N8N_API_KEY": "n8n_..."
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@automatelab/n8n-mcp"
  ],
  "env": {
    "N8N_API_URL": "https://your-n8n.example.com",
    "N8N_API_KEY": "n8n_..."
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx