n8n MCP

czlonkowski/n8n-mcp· Проверено 12.11.2026· 23,2 тыс.на GitHub

Даёт агенту управление n8n: разбирать упавшие запуски, править сценарии точечно, проверять и тестировать их, вести ключи доступа (credentials) и собирать новые сценарии. Внутри база по 3 501 узлу и 2 352 шаблонам.

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

Что сделать до подключения

Node.js

Инстанс n8n с включённым Public API — для инструментов управления

N8N_API_URL, N8N_API_KEY

адрес вашего n8n и API-ключ из Settings → API; без них работают только справочные инструменты по узлам и шаблонам

N8N_MCP_ACCESS_TOKEN

необязателен: n8n Settings → Instance-level MCP, статус Enabled; нужен для агентов n8n, тестов с закреплёнными данными и родной истории версий

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env MCP_MODE=stdio --env LOG_LEVEL=error --env DISABLE_CONSOLE_OUTPUT=true --env 'N8N_API_URL=https://<ваш-n8n>' --env 'N8N_API_KEY=<API-ключ n8n>' --transport stdio n8n \
  -- npx n8n-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.n8n]
command = "npx"
args = ["n8n-mcp"]

[mcp_servers.n8n.env]
MCP_MODE = "stdio"
LOG_LEVEL = "error"
DISABLE_CONSOLE_OUTPUT = "true"
N8N_API_URL = "https://<ваш-n8n>"
N8N_API_KEY = "<API-ключ n8n>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://<ваш-n8n>",
        "N8N_API_KEY": "<API-ключ n8n>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "n8n": {
      "type": "stdio",
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://<ваш-n8n>",
        "N8N_API_KEY": "<API-ключ n8n>"
      }
    }
  }
}

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

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://<ваш-n8n>",
        "N8N_API_KEY": "<API-ключ n8n>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://<ваш-n8n>",
        "N8N_API_KEY": "<API-ключ n8n>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "n8n": {
        "type": "local",
        "command": ["npx", "n8n-mcp"],
        "environment": {
          "MCP_MODE": "stdio",
          "LOG_LEVEL": "error",
          "DISABLE_CONSOLE_OUTPUT": "true",
          "N8N_API_URL": "https://<ваш-n8n>",
          "N8N_API_KEY": "<API-ключ n8n>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://<ваш-n8n>",
        "N8N_API_KEY": "<API-ключ n8n>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://<ваш-n8n>",
        "N8N_API_KEY": "<API-ключ n8n>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

search_nodesищет узлы n8n

get_nodeпоказывает настройки и документацию узла

validate_nodeпроверяет настройку узла

validate_workflowпроверяет сценарий целиком

search_templatesищет шаблоны сценариев

get_templateотдаёт JSON шаблона

n8n_create_workflowсоздаёт сценарий

n8n_get_workflowчитает сценарий

n8n_update_partial_workflowправит узлы и связи точечно

n8n_list_workflowsперечисляет сценарии

n8n_autofix_workflowчинит типовые ошибки

n8n_workflow_versionsоткатывает сценарий к версии

n8n_deploy_templateразворачивает шаблон в n8n

n8n_test_workflowзапускает сценарий на тест

n8n_executionsразбирает запуски и ошибки

n8n_manage_credentialsведёт credentials

n8n_manage_datatableведёт таблицы данных

n8n_audit_instanceпроверяет безопасность инстанса

n8n_health_checkпроверяет связь с n8n

Показано 19 из 28.

Что попросить агента

«Почему упал последний запуск сценария <название>?»Агент найдёт сценарий через n8n_list_workflows и вызовет n8n_executions в режиме error: покажет ошибку, узел и элементы с предыдущего узла

«В узле Code сценария <название> замени <старый фрагмент> на <новый>»Агент вызовет n8n_update_partial_workflow и поправит только это поле, без пересылки всего сценария

«Проверь сценарий <название> перед запуском и почини, что найдёшь»Агент вызовет validate_workflow, затем n8n_autofix_workflow для типовых ошибок

«Собери сценарий: <что должно происходить>, возьми за основу готовый шаблон»Агент вызовет search_templates, get_template и n8n_deploy_template, узлы проверит через get_node и validate_node

«Откати сценарий <название> к версии до последней правки»Агент вызовет n8n_workflow_versions: покажет сохранённые версии, разницу и откатит

Для каких задач

Найти, на каком узле упал запуск, и показать элементы с предыдущего узла

Поправить один узел или кусок кода в большом сценарии без пересылки всего JSON

Проверить сценарий до запуска и починить битые связи и выражения

Собрать новый сценарий из шаблона и развернуть его в своём n8n

Создать и обновить credentials и провести аудит безопасности инстанса

Ограничения

Сервер меняет живые сценарии; правка в интерфейсе n8n во время работы агента будет перезаписана

Телеметрия включена по умолчанию и собирает очищенные структуры сценариев; отключается N8N_MCP_TELEMETRY_DISABLED=true

Часть функций (агенты n8n, тест без триггера, родная история версий) требует N8N_MCP_ACCESS_TOKEN и свежих версий n8n 2.x

Бесплатный тариф облачной версии ограничен 100 вызовами инструментов в день

Если не работает

Claude Desktop показывает ошибки разбора JSON вида Unexpected token

Добавьте в env переменную MCP_MODE=stdio: без неё в stdout попадают отладочные логи.

n8n_health_check возвращает 502, хотя интерфейс n8n открывается

Если n8n-mcp запущен в Docker на той же машине, укажите в N8N_API_URL host.docker.internal или IP машины вместо localhost.

Вызовы API падают с ошибкой авторизации или 404, а сайт n8n работает

Проверьте, что в настройках n8n включён REST API, а ключ действует и не истёк.

Вебхук к локальному n8n падает с SSRF protection: Localhost access is blocked

Для локальной разработки задайте WEBHOOK_SECURITY_MODE=moderate. В рабочей среде оставьте strict.

Частые вопросы

Чем n8n-MCP отличается от встроенного MCP-сервера n8n?

Встроенный сервер живёт внутри одного инстанса, для большинства инструментов требует n8n 2.12+ и флаг «Available in MCP» у сценария, который по умолчанию выключен. n8n-MCP работает отдельно, обслуживает несколько инстансов, создаёт и меняет credentials и умеет автопочинку, разбор ошибок, шаблоны и аудит.

Как не дать агенту ничего сломать?

Перечислите пишущие инструменты в DISABLED_TOOLS, а отдельные операции — в DISABLED_TOOL_OPERATIONS. Вместе с ключом n8n только на чтение это даёт режим без изменений. Перед правкой сервер сохраняет снимок сценария, до 10 на сценарий.

Почему Claude Desktop пишет «Unexpected token»?

В env не задана переменная MCP_MODE=stdio. Без неё в поток протокола попадают служебные сообщения.

Можно попробовать без установки?

Да, автор держит облачную версию на dashboard.n8n-mcp.com: бесплатно 100 вызовов в день, вход через OAuth для claude.ai и ChatGPT. Ключ n8n там хранится в зашифрованном виде.

Два клиента одновременно ломают запуск через npx — что делать?

Задайте каждому клиенту свою папку npm_config_cache в env, иначе npx упирается в блокировку кэша.

Работает ли сервер из России?

Самостоятельная установка запускается на вашем компьютере и ходит только в ваш n8n; зарубежные аккаунты для неё не нужны.