MCP-сервер n8n

В этой главе мы подключим MCP-сервер, чтобы Claude Code (или Qwen Code) мог управлять n8n напрямую. Ты будешь писать «создай workflow» — и ИИ сделает это сам, без захода в интерфейс n8n.

Что мы получим

После настройки ты сможешь прямо из Claude Code:

Ты: Покажи список моих workflow

Claude: У вас 3 workflow:
1. "Ежедневные новости" — активен
2. "Мониторинг сайта" — активен  
3. "Тестовый" — неактивен

Ты: Создай workflow: каждый день в 20:00 
    присылай мне в Telegram "Запиши итоги дня"

Claude: Создал workflow "Вечернее напоминание":
- Триггер: ежедневно в 20:00
- Действие: сообщение в Telegram
- Статус: активен

Что нужно перед настройкой

• ✅ Claude Code установлен и авторизован
• ✅ n8n установлен на сервере и доступен по URL
• ✅ Node.js установлен (нужен для MCP-сервера)

Шаг 1: Получи API-ключ n8n

MCP-сервер будет обращаться к n8n по API. Для этого нужен ключ.

1. Открой n8n в браузере (https://n8n.mysite.com)
2. Нажми на свой аватар (левый нижний угол) → Settings
3. Перейди в API → API Keys
4. Нажми Create API Key
5. Назови ключ (например, «MCP Claude Code»)
6. Скопируй ключ — он покажется только один раз!

Сохрани ключ!

API-ключ показывается только при создании. Если потеряешь — придётся создавать новый. Сохрани его в надёжном месте (менеджер паролей, заметки).

Шаг 2: Установи MCP-сервер n8n

Открой терминал на своём компьютере (не на сервере) и установи пакет:

npm install -g @anthropic-ai/claude-code

MCP-сервер n8n поставляется как npm-пакет. Установи его:

npm install -g n8n-mcp-server

Шаг 3: Настрой конфиг Claude Code

Нужно сказать Claude Code, что у него есть новый инструмент — MCP-сервер для n8n.

Открой (или создай) файл настроек:

Windows:

%USERPROFILE%\.claude\settings.json

Mac / Linux:

~/.claude/settings.json

Добавь секцию mcpServers:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "n8n-mcp-server"],
      "env": {
        "N8N_BASE_URL": "https://n8n.mysite.com",
        "N8N_API_KEY": "твой-api-ключ-из-шага-1"
      }
    }
  }
}

Замени:

• https://n8n.mysite.com — на URL твоего n8n
• твой-api-ключ-из-шага-1 — на реальный API-ключ

Сохрани файл.

Шаг 4: Проверь подключение

Перезапусти Claude Code (закрой и открой заново):

claude

Напиши:

Проверь подключение к n8n. Покажи список workflow.

Если видишь список workflow (или сообщение «0 workflow найдено» для чистого n8n) — MCP работает!

Если ошибка — проверь:

• Правильный ли URL n8n в настройках
• Правильный ли API-ключ
• Доступен ли n8n по этому URL из браузера

Шаг 5: Добавь правила безопасности в CLAUDE.md

Открой свой глобальный ~/.claude/CLAUDE.md и добавь:

## Правила для n8n (MCP)

### Разрешения
- READ (поиск, просмотр, список workflow, валидация) — разрешено автоматически
- CREATE (создание новых workflow) — только с моего подтверждения
- UPDATE (значительные правки workflow) — только с моего подтверждения
- DELETE workflow — ЗАПРЕЩЕНО КАТЕГОРИЧЕСКИ

### Почему
Удалённый workflow восстановить нельзя. 
Значительные правки могут сломать работающую автоматизацию.
Всегда спрашивай перед изменениями.

Это важно

Без этих правил ИИ может случайно удалить работающий workflow. Одна ошибка — и автоматизация, которую ты настраивал час, пропала навсегда. Правила в CLAUDE.md — это твоя страховка.

Практические примеры

Узнать, что есть

Покажи все мои workflow в n8n. 
Для каждого укажи: активен или нет, когда запускается.

Создать workflow

Создай workflow в n8n:
- Триггер: каждый день в 9:00
- Шаг 1: HTTP-запрос на https://api.example.com/news
- Шаг 2: Отправить результат в Telegram-бот

Покажи мне план перед созданием.

Проверить на ошибки

Провалидируй workflow "Ежедневные новости". 
Есть ли ошибки в конфигурации?

Починить

В workflow "Мониторинг сайта" ошибка в ноде HTTP Request — 
URL неправильный. Исправь на https://mysite.com/health

Найти нужный нод

Какой нод в n8n используется для отправки сообщений в Telegram?
Покажи его параметры.

Чеклист

• [ ] API-ключ n8n создан
• [ ] MCP-сервер установлен
• [ ] settings.json настроен (URL + ключ)
• [ ] Claude Code видит n8n (команда «покажи workflow» работает)
• [ ] Правила безопасности добавлены в CLAUDE.md

---

Что дальше?

MCP настроен — теперь ИИ управляет автоматизациями! В следующей главе разберём low-code деплой — как выложить проект в интернет без сервера, через Vercel или Netlify.