# n8n-mcp

Сервер помогает создавать сценарии n8n, находить ошибки в схемах и разбирать упавшие запуски прямо через ИИ-ассистента.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15
- Автор: AutomateLab-tech
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AutomateLab-tech/n8n-mcp
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/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-команды отключаются, оставляя доступ только к автономному линтингу и генерации.

## Требования
- Нужно: Node.js (команды через npx)
- Работает с: n8n

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add n8n-mcp -- npx -y @automatelab/n8n-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add n8n-mcp -- npx -y @automatelab/n8n-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "n8n-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@automatelab/n8n-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "n8n-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@automatelab/n8n-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add n8n-mcp npx -y @automatelab/n8n-mcp
```

## Когда брать
- найти причины потери данных в логах упавшего выполнения n8n
- сгенерировать JSON сценария с правильными связями для AI Agent
- проверить схему узлов на устаревшие типы перед импортом
- выгрузить или активировать сценарий на удалённом сервере n8n

## Примеры запросов агенту
- Разбери этот JSON выполнения n8n и объясни, почему на узле HTTP Request пропали данные.
- Сделай сценарий n8n с агентом OpenAI и инструментом поиска, чтобы граф подошёл под n8n 1.x.
- Проверь workflow.json линтером на устаревшие типы узлов и ошибки в выражениях.

## Похожие
- [n8n-debugging-official](https://affpapa.org/nevibecode/skills/n8n-debugging-official.md) — скилл · 2100 установок
- [n8n-mcp-tools-expert](https://affpapa.org/nevibecode/skills/n8n-mcp-tools-expert.md) — скилл · 8200 установок
- [n8n-workflow-lifecycle-official](https://affpapa.org/nevibecode/skills/n8n-workflow-lifecycle-official.md) — скилл · 2400 установок
- [mcp-n8n](https://affpapa.org/nevibecode/mcp/mcp-n8n.md) — MCP-сервер · ★ 21
- [n8n-workflow-patterns](https://affpapa.org/nevibecode/skills/czlonkowski-n8n-workflow-patterns.md) — скилл · 11700 установок
- [workflow-automation](https://affpapa.org/nevibecode/skills/workflow-automation.md) — скилл · 1661 установка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md