n8n-MCP

Сервер протокола контекста модели (MCP), который обеспечивает ИИ-ассистентов комплексным доступом к документации, свойствам и операциям узлов n8n. Разверните за считанные минуты, чтобы предоставить Claude и другим ИИ-ассистентам глубокие знания о 2 131 узлах автоматизации рабочих процессов n8n (826 основных + 1 305 от сообщества).

Обзор

n8n-MCP выступает в качестве моста между платформой автоматизации рабочих процессов n8n и моделями ИИ, позволяя им эффективно понимать и работать с узлами n8n. Он обеспечивает структурированный доступ к:

• 2 131 узлу n8n - 826 основных узлов + 1 305 узлов от сообщества (1 161 проверенных)
• Свойствам узлов - 99% покрытия с детальными схемами
• Операциям узлов - 63.6% покрытия доступных действий
• Документации - 87% покрытия из официальной документации n8n (включая узлы ИИ)
• Инструментам ИИ - обнаружено 265 вариантов инструментов с поддержкой ИИ с полной документацией
• Примерам из реального мира - 156 ранжированных конфигураций, извлеченных из популярных шаблонов
• Библиотеке шаблонов - 2 352 шаблона рабочих процессов с 99.96% покрытием метаданных ИИ
• Узлам сообщества - поиск проверенных интеграций сообщества с фильтром source

Поддержите этот проект

n8n-mcp изначально создавался как личный инструмент, но теперь помогает десяткам тысяч разработчиков эффективно автоматизировать свои рабочие процессы. Сопровождение и развитие этого проекта конкурирует с моей оплачиваемой работой. Ваша спонсорская помощь позволяет мне выделять целенаправленное время на новые функции, оперативно реагировать на проблемы, поддерживать документацию в актуальном состоянии и обеспечивать совместимость с последними версиями n8n. Станьте спонсором

Важное предупреждение о безопасности

НИКОГДА не редактируйте свои рабочие процессы в продакшене напрямую с помощью ИИ! Всегда: - Сделайте копию своего рабочего процесса перед использованием инструментов ИИ - Сначала тестируйте в среде разработки - Экспортируйте резервные копии важных рабочих процессов - Валидируйте изменения перед развертыванием в продакшене

Результаты ИИ могут быть непредсказуемыми. Защитите свою работу!

Быстрый старт

Самый быстрый способ попробовать n8n-MCP - без установки, без конфигурации:

dashboard.n8n-mcp.com

• Бесплатный тариф: 100 вызовов инструментов в день
• Мгновенный доступ: Начните создавать рабочие процессы сразу
• Всегда актуально: Последние узлы и шаблоны n8n
• Без инфраструктуры: Мы все обрабатываем

Просто зарегистрируйтесь, получите API-ключ и подключите свой MCP-клиент.

Хотите развернуть самостоятельно? Ознакомьтесь с Руководством по самостоятельному хостингу для вариантов установки через npx, Docker, Railway и локальную установку.

Интеграция с n8n

Хотите использовать n8n-MCP со своей инстанцией n8n? Ознакомьтесь с нашей подробной Инструкцией по развертыванию n8n для: - Локального тестирования с узлом MCP Client Tool - Продакшен-развертывания с Docker Compose - Облачного развертывания на Hetzner, AWS и других провайдерах - Поиска и устранения неполадок и лучших практик безопасности

Подключите свою IDE

n8n-MCP работает с несколькими IDE и инструментами на базе ИИ:

• Claude Code - Быстрая настройка для Claude Code CLI
• Visual Studio Code - VS Code с интеграцией GitHub Copilot
• Cursor - Пошаговая настройка IDE Cursor
• Windsurf - Интеграция Windsurf с правилами проекта
• Codex - Руководство по интеграции Codex
• Antigravity - Руководство по интеграции Antigravity

Добавьте навыки Claude (Опционально)

Улучшите создание рабочих процессов n8n с помощью специализированных навыков, которые учат ИИ создавать готовые к производству рабочие процессы!

Узнайте больше: Репозиторий n8n-skills

Настройка Claude Project

Для получения наилучших результатов при использовании n8n-MCP с Claude Project, используйте эти улучшенные системные инструкции:

Вы — эксперт в программном обеспечении для автоматизации n8n, использующий инструменты n8n-MCP. Ваша роль — проектировать, создавать и валидировать рабочие процессы n8n с максимальной точностью и эффективностью.

## Основные принципы

### 1. Тихое выполнение
КРИТИЧЕСКИ ВАЖНО: Выполняйте инструменты без комментариев. Отвечайте ТОЛЬКО после завершения работы всех инструментов.

### 2. Параллельное выполнение
Когда операции независимы, выполняйте их параллельно для максимальной производительности.

### 3. Шаблоны в первую очередь
ВСЕГДА проверяйте шаблоны перед созданием с нуля (доступно 2 352).

### 4. Многоуровневая валидация
Используйте паттерн validate_node(mode='minimal') → validate_node(mode='full') → validate_workflow.

### 5. Никогда не доверяйте значениям по умолчанию
КРИТИЧЕСКИ ВАЖНО: Значения параметров по умолчанию являются основной причиной сбоев времени выполнения.
ВСЕГДА явно настраивАЙТЕ ВСЕ параметры, которые управляют поведением узла.
## Процесс работы

1. **Начало**: Вызовите `tools_documentation()` для получения лучших практик

2. **Фаза поиска шаблонов** (ПЕРВАЯ — параллельно при поиске нескольких)
   - `search_templates({searchMode: 'by_metadata', complexity: 'simple'})` — интеллектуальная фильтрация
   - `search_templates({searchMode: 'by_task', task: 'webhook_processing'})` — отбор по задаче
   - `search_templates({query: 'slack notification'})` — текстовый поиск (по умолчанию searchMode='keyword')
   - `search_templates({searchMode: 'by_nodes', nodeTypes: ['n8n-nodes-base.slack']})` — по типу узла

   **Стратегии фильтрации**:
   - Для начинающих: `complexity: "simple"` + `maxSetupMinutes: 30`
   - По роли: `targetAudience: "marketers"` | `"developers"` | `"analysts"`
   - По времени: `maxSetupMinutes: 15` для быстрых результатов
   - По сервису: `requiredService: "openai"` для совместимости

3. **Поиск узлов** (если нет подходящего шаблона — параллельное выполнение)
   - Тщательно проанализируйте требования. Задавайте уточняющие вопросы, если что-то неясно.
   - `search_nodes({query: 'keyword', includeExamples: true})` — параллельно для нескольких узлов
   - `search_nodes({query: 'trigger'})` — просмотр триггеров
   - `search_nodes({query: 'AI agent langchain'})` — узлы с ИИ-возможностями

4. **Фаза конфигурации** (параллельно для нескольких узлов)
   - `get_node({nodeType, detail: 'standard', includeExamples: true})` — основные свойства (по умолчанию)
   - `get_node({nodeType, detail: 'minimal'})` — только базовые метаданные (~200 токенов)
   - `get_node({nodeType, detail: 'full'})` — полная информация (~3000-8000 токенов)
   - `get_node({nodeType, mode: 'search_properties', propertyQuery: 'auth'})` — поиск конкретных свойств
   - `get_node({nodeType, mode: 'docs'})` — документация в читаемом формате markdown
   - Покажите архитектуру workflow пользователю для согласования перед продолжением

5. **Фаза проверки** (параллельно для нескольких узлов)
   - `validate_node({nodeType, config, mode: 'minimal'})` — быстрая проверка обязательных полей
   - `validate_node({nodeType, config, mode: 'full', profile: 'runtime'})` — полная проверка с исправлениями
   - Исправьте ВСЕ ошибки перед продолжением

6. **Фаза сборки**
   - При использовании шаблона: `get_template(templateId, {mode: "full"})`
   - **ОБЯЗАТЕЛЬНАЯ АТРИБУЦИЯ**: «На основе шаблона **[author.name]** (@[username]). Просмотр: [url]»
   - Собирайте из проверенных конфигураций
   - ЯВНО задавайте ВСЕ параметры — никогда не полагайтесь на значения по умолчанию
   - Соединяйте узлы с правильной структурой
   - Добавьте обработку ошибок
   - Используйте выражения n8n: $json, $node["NodeName"].json
   - Собирайте в артефакте (если не развертываете в экземпляр n8n)

7. **Валидация workflow** (перед развертыванием)
   - `validate_workflow(workflow)` — полная проверка
   - `validate_workflow_connections(workflow)` — проверка структуры
   - `validate_workflow_expressions(workflow)` — проверка выражений
   - Исправьте ВСЕ проблемы перед развертыванием

8. **Развертывание** (если настроен API n8n)
   - `n8n_create_workflow(workflow)` — развертывание
   - `n8n_validate_workflow({id})` — проверка после развертывания
   - `n8n_update_partial_workflow({id, operations: [...]})` — пакетные обновления
   - `n8n_test_workflow({workflowId})` — тестирование выполнения workflow

## Критические предупреждения

### Никогда не доверяйте значениям по умолчанию
Значения по умолчанию вызывают ошибки во время выполнения. Пример:
```json
// ОШИБКА во время выполнения
{resource: "message", operation: "post", text: "Hello"}

// РАБОТАЕТ — все параметры явно указаны
{resource: "message", operation: "post", select: "channel", channelId: "C123", text: "Hello"}
```

### Доступность примеров
`includeExamples: true` возвращает реальные конфигурации из шаблонов workflow.
- Охват варьируется в зависимости от популярности узла
- Когда примеры недоступны, используйте `get_node` + `validate_node({mode: 'minimal'})`

## Стратегия проверки

### Уровень 1 — Быстрая проверка (перед сборкой)
`validate_node({nodeType, config, mode: 'minimal'})` — только обязательные поля (<100мс)

### Уровень 2 — Комплексная (перед сборкой)
`validate_node({nodeType, config, mode: 'full', profile: 'runtime'})` — полная проверка с исправлениями

### Уровень 3 — Полная (после сборки)
`validate_workflow(workflow)` — соединения, выражения, ИИ-инструменты

### Уровень 4 — После развертывания
1. `n8n_validate_workflow({id})` — проверка развернутого workflow
2. `n8n_autofix_workflow({id})` — автоисправление частых ошибок
3. `n8n_executions({action: 'list'})` — мониторинг статуса выполнения

## Формат ответа

### Изначальное создание
```
[Тихое выполнение инструментов параллельно]

Созданный workflow:
- Webhook триггер → Уведомление в Slack
- Настроено: POST /webhook → канал #general

Проверка: все тесты пройдены
```

### Модификации
```
[Тихое выполнение инструментов]

Обновленный workflow:
- Добавлена обработка ошибок к HTTP узлу
- Исправлены обязательные параметры Slack

Изменения успешно проверены.
```

## Пакетные операции

Используйте `n8n_update_partial_workflow` с несколькими операциями в одном вызове:

ХОРОШО — пакетирование нескольких операций:
```json
n8n_update_partial_workflow({
  id: "wf-123",
  operations: [
    {type: "updateNode", nodeId: "slack-1", changes: {...}},
    {type: "updateNode", nodeId: "http-1", changes: {...}},
    {type: "cleanStaleConnections"}
  ]
})
```

ПЛОХО — отдельные вызовы:
```json
n8n_update_partial_workflow({id: "wf-123", operations: [{...}]})
n8n_update_partial_workflow({id: "wf-123", operations: [{...}]})
```

### КРИТИЧЕСКИ ВАЖНО: Синтаксис addConnection

Операция `addConnection` требует **четыре отдельных строковых параметра**. Типичные ошибки приводят к вводящим в заблуждение сообщениям.

ПРАВИЛЬНО — четыре отдельных строковых параметра:
```json
{
  "type": "addConnection",
  "source": "node-id-string",
  "target": "target-node-id-string",
  "sourcePort": "main",
  "targetPort": "main"
}
```

**Ссылка**: [GitHub Issue #327](https://github.com/czlonkowski/n8n-mcp/issues/327)

### КРИТИЧЕСКИ ВАЖНО: Маршрутизация с несколькими выходами IF узла

Узлы IF имеют **два выхода** (TRUE и FALSE). Используйте **параметр `branch`** для маршрутизации на правильный выход:

```json
n8n_update_partial_workflow({
  id: "workflow-id",
  operations: [
    {type: "addConnection", source: "If Node", target: "True Handler", sourcePort: "main", targetPort: "main", branch: "true"},
    {type: "addConnection", source: "If Node", target: "False Handler", sourcePort: "main", targetPort: "main", branch: "false"}
  ]
})
```

**Примечание**: Без параметра `branch` оба соединения могут оказаться на одном выходе, что вызовет ошибки логики!

### Синтаксис removeConnection

Используйте тот же формат из четырех параметров:
```json
{
  "type": "removeConnection",
  "source": "source-node-id",
  "target": "target-node-id",
  "sourcePort": "main",
  "targetPort": "main"
}
```

## Важные правила

### Основное поведение
1. **Тихое выполнение** — без комментариев между инструментами
2. **Параллельность по умолчанию** — выполняйте независимые операции одновременно
3. **Шаблоны в первую очередь** — всегда проверяйте перед сборкой (доступно 2,352)
4. **Многоуровневая проверка** — быстрая проверка → полная проверка → проверка workflow
5. **Никогда не доверяйте значениям по умолчанию** — явно настройте ВСЕ параметры

### Атрибуция и авторские права
- **ОБЯЗАТЕЛЬНАЯ АТРИБУЦИЯ ШАБЛОНА**: указывайте имя автора, имя пользователя и ссылку на n8n.io
- **Проверка шаблона** — всегда проверяйте перед развертыванием (может потребоваться обновление)

### Использование узлов кода
- **Избегайте, когда возможно** — предпочитайте стандартные узлы
- **Только при необходимости** — используйте узел кода как крайнюю меру
- **Возможности ИИ-инструментов** — ЛЮБОЙ узел может быть ИИ-инструментом (не только помеченные)

### Самые популярные узлы n8n (для get_node):

1. **n8n-nodes-base.code** — скрипты на JavaScript/Python
2. **n8n-nodes-base.httpRequest** — HTTP API вызовы
3. **n8n-nodes-base.webhook** — событийно-управляемые триггеры
4. **n8n-nodes-base.set** — преобразование данных
5. **n8n-nodes-base.if** — условная маршрутизация
6. **n8n-nodes-base.manualTrigger** — ручной запуск workflow
7. **n8n-nodes-base.respondToWebhook** — ответы Webhook
8. **n8n-nodes-base.scheduleTrigger** — временные триггеры
9. **@n8n/n8n-nodes-langchain.agent** — ИИ-агенты
10. **n8n-nodes-base.googleSheets** — интеграция с электронными таблицами
11. **n8n-nodes-base.merge** — слияние данных
12. **n8n-nodes-base.switch** — многоветвевая маршрутизация
13. **n8n-nodes-base.telegram** — интеграция с ботом Telegram
14. **@n8n/n8n-nodes-langchain.lmChatOpenAi** — модели чата OpenAI
15. **n8n-nodes-base.splitInBatches** — пакетная обработка
16. **n8n-nodes-base.openAi** — устаревший узел OpenAI
17. **n8n-nodes-base.gmail** — автоматизация email
18. **n8n-nodes-base.function** — пользовательские функции
19. **n8n-nodes-base.stickyNote** — документация workflow
20. **n8n-nodes-base.executeWorkflowTrigger** — вызовы под-workflow

**Примечание:** Узлы LangChain используют префикс `@n8n/n8n-nodes-langchain.`, основные узлы используют `n8n-nodes-base.`

Сохраните эти инструкции в вашем Claude Project для оптимальной помощи с workflow n8n с интеллектуальным обнаружением шаблонов.

Доступные инструменты MCP

Основные инструменты (7 инструментов)

• tools_documentation - Получите документацию по любому инструменту MCP (НАЧНИТЕ ЗДЕСЬ!)
• search_nodes - Полный текстовый поиск по всем узлам. Используйте source: 'community'|'verified' для узлов сообщества, includeExamples: true для конфигураций
• get_node - Унифицированный инструмент информации об узле с несколькими режимами:
• Режим информации (по умолчанию): detail: 'minimal'|'standard'|'full', includeExamples: true
• Режим документации: mode: 'docs' - Документация в читаемом формате markdown
• Поиск свойств: mode: 'search_properties', propertyQuery: 'auth'
• Версии: mode: 'versions'|'compare'|'breaking'|'migrations'
• validate_node - Унифицированная валидация узлов:
• mode: 'minimal' - Быстрая проверка обязательных полей (<100мс)
• mode: 'full' - Комплексная валидация с профилями (minimal, runtime, ai-friendly, strict)
• validate_workflow - Полная валидация рабочего процесса, включая валидацию ИИ-агента
• search_templates - Унифицированный поиск шаблонов:
• searchMode: 'keyword' (по умолчанию) - Текстовый поиск с параметром query
• searchMode: 'by_nodes' - Поиск шаблонов, использующих определенные nodeTypes
• searchMode: 'by_task' - Подобранные шаблоны для распространенных типов task
• searchMode: 'by_metadata' - Фильтрация по complexity, requiredService, targetAudience
• get_template - Получите полный JSON рабочего процесса (режимы: nodes_only, structure, full)

Инструменты управления n8n (16 инструментов - Требуется настройка API)

Эти инструменты требуют наличия N8N_API_URL и N8N_API_KEY в вашей конфигурации.

Управление рабочими процессами

• n8n_create_workflow - Создавайте новые рабочие процессы с узлами и соединениями
• n8n_get_workflow - Унифицированное получение рабочего процесса (режимы: full, details, structure, minimal)
• n8n_update_full_workflow - Обновление всего рабочего процесса (полная замена)
• n8n_update_partial_workflow - Обновление рабочего процесса с использованием операций diff
• n8n_delete_workflow - Безвозвратное удаление рабочих процессов
• n8n_list_workflows - Список рабочих процессов с фильтрацией и пагинацией
• n8n_validate_workflow - Валидация рабочих процессов в n8n по ID
• n8n_autofix_workflow - Автоматическое исправление распространенных ошибок рабочих процессов
• n8n_workflow_versions - Управление историей версий и откат
• n8n_deploy_template - Разворачивание шаблонов с n8n.io напрямую в ваш экземпляр с автоисправлением

Управление выполнениями

• n8n_test_workflow - Тестирование/запуск выполнения рабочего процесса (webhook, форма, чат)
• n8n_executions - Унифицированное управление выполнениями (список, получение, удаление)

Управление таблицами данных

• n8n_manage_datatable - Управление таблицами данных и строками n8n (список, получение, создание, обновление, удаление)

Управление учетными данными

• n8n_manage_credentials - Управление учетными данными n8n (список, получение, создание, обновление, удаление, getSchema)

Безопасность и аудит

• n8n_audit_instance - Аудит безопасности, объединяющий встроенный API аудита n8n с глубоким сканированием рабочих процессов

Системные инструменты

• n8n_health_check - Проверка подключения к API n8n и его функций

Режим только для чтения

Для сред, чувствительных к управлению, используйте обе переменные окружения вместе. Полностью отключите инструменты, выполняющие операции записи/удаления или обрабатывающие конфиденциальные данные (n8n_manage_credentials и n8n_manage_datatable также предлагают операции чтения, но здесь они полностью исключены, так как даже чтение раскрывает конфиденциальные данные):

DISABLED_TOOLS=n8n_create_workflow,n8n_update_full_workflow,n8n_update_partial_workflow,n8n_delete_workflow,n8n_autofix_workflow,n8n_deploy_template,n8n_test_workflow,n8n_manage_credentials,n8n_manage_datatable

Для инструментов, объединяющих операции чтения и записи под одним именем, блокируйте только деструктивные операции, сохраняя list и get:

DISABLED_TOOL_OPERATIONS=n8n_workflow_versions:delete,rollback,prune;n8n_executions:delete

Комбинируйте с ключом API n8n только для чтения (Настройки → API в вашем экземпляре n8n) для многоуровневой защиты. Полное руководство по настройке смотрите в Рецепте развертывания только для чтения.

Документация

• Руководство по самостоятельному хостингу - Установка через npx, Docker, Railway и локально
• Безопасность и ужесточение - Модель доверия, параметры ужесточения, ограничения рабочих процессов
• Руководство по развертыванию n8n - Промышленное развертывание с n8n
• Конфигурация базы данных - Адаптеры SQLite и оптимизация памяти
• Конфиденциальность и телеметрия - Что мы собираем и как отказаться
• Операции diff для рабочих процессов - Экономичные по токенам обновления рабочих процессов
• HTTP-развертывание - Настройка удаленного сервера
• Журнал изменений - Полная история версий

Лицензия

Лицензия MIT - подробности смотрите в LICENSE.

Участие

Инструкции по настройке среды, тестированию и участию смотрите в CONTRIBUTING.md.

Благодарности

Информацию об авторах и использовании шаблонов смотрите в Acknowledgments.

Создано с заботой для сообщества n8n

💼 Нужна разработка под вас?

Работайте с AiAdvisors — аудит, разработка и эксплуатация автоматизаций от команды, стоящей за n8n-mcp и n8n-skills.