n8n-mcp — MCP-сервер для Claude Code: что делает и как установить
Сервер помогает создавать сценарии n8n, находить ошибки в схемах и разбирать упавшие запуски прямо через ИИ-ассистента.
claude mcp add n8n-mcp -- npx -y @automatelab/n8n-mcpЧто делает n8n-mcp
Сервер связывает редактор кода или агентную консоль со сценариями n8n. Он умеет собирать JSON сценариев по текстовому описанию, проверять узлы линтером и сравнивать версии схем. Узлы AI Agent компонуются с учётом связей вроде ai_languageModel или ai_tool, поэтому полученный граф корректно импортируется в n8n 1.x.
Инструмент execution_explain принимает лог выполнения и указывает, на каком конкретно шаге пропали данные или остались невычисленные выражения вида ={{ ... }}. Для тестирования проблемного узла в изоляции сервер собирает отдельный сценарий через execution_replay.
Для запуска требуется Node 20 или новее. Управление удалённым экземпляром n8n зависит от переменных N8N_API_URL и N8N_API_KEY: без них REST-команды отключаются, оставляя доступ только к автономному линтингу и генерации.
Какие задачи решает
- найти причины потери данных в логах упавшего выполнения n8n
- сгенерировать JSON сценария с правильными связями для AI Agent
- проверить схему узлов на устаревшие типы перед импортом
- выгрузить или активировать сценарий на удалённом сервере n8n
Примеры запросов агенту
- Разбери этот JSON выполнения n8n и объясни, почему на узле HTTP Request пропали данные.
- Сделай сценарий n8n с агентом OpenAI и инструментом поиска, чтобы граф подошёл под n8n 1.x.
- Проверь workflow.json линтером на устаревшие типы узлов и ошибки в выражениях.
Как установить n8n-mcp
Командой платформы
claude mcp add n8n-mcp -- npx -y @automatelab/n8n-mcpКомандой платформы
codex mcp add n8n-mcp -- npx -y @automatelab/n8n-mcpФайл настроек
{
"mcpServers": {
"n8n-mcp": {
"command": "npx",
"args": [
"-y",
"@automatelab/n8n-mcp"
]
}
}
}Файл настроек
{
"servers": {
"n8n-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automatelab/n8n-mcp"
]
}
}
}Командой платформы
gemini mcp add n8n-mcp npx -y @automatelab/n8n-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о n8n-mcp
Как установить n8n-mcp в Claude Code?
Выполните команду claude mcp add n8n-mcp -- npx -y @automatelab/n8n-mcp. В системе должен быть установлен Node 20 или выше.
Что делает n8n-mcp?
Сервер даёт модели инструменты для генерации сценариев n8n, проверки структуры через линтер и анализа логов сбоев. С ключами API он также позволяет загружать и активировать рабочие процессы на сервере.
Обязательно ли указывать N8N_API_URL и ключ API?
Нет. Без переменных окружения N8N_API_URL и N8N_API_KEY работают автономные функции: сборка JSON, линтинг, расчёт различий между схемами и разбор переданных логов.
