Чек-лист

n8n-MCP: чек-лист подключения

Чек-лист «N8n MCP чеклист» из ролика канала «Нейропросвещение». Скачай файл и забери ссылки ниже.

Содержание5 глав
  1. 011. Что это даёт в цифрах
  2. 022. Быстрый старт без установки
  3. 033. Свой сервер через npx
  4. 044. Свой сервер через Docker
  5. 055. Как Claude использует базу на практике

Собирать n8n-workflow вручную нода за нодой — не самая эффективная работа, когда можно описать нужный результат словами и дать Claude собрать схему самому. n8n-MCP подключает Claude (и другие AI-инструменты) к полной базе знаний по нодам и готовым шаблонам n8n, так что сборка идёт с опорой на реальную документацию, а не на догадки модели.

Важно
При локальном запуске через npx или Docker для Claude Desktop обязательна переменная окружения MCP_MODE: "stdio" — без неё в интерфейсе появляются ошибки парсинга JSON вида «Unexpected token…», потому что отладочные логи мешаются с протоколом.

1. Что это даёт в цифрах

База нодов
2 063
816 базовых плюс 1 247 community-нодов, из которых 1 113 проверены вручную
Библиотека шаблонов
2 352
готовых workflow-шаблона с покрытием AI-метаданных 99,96%
GitHub
22,1 тыс. звёзд
активно развивающийся open-source проект

2. Быстрый старт без установки

  • Хостинг на dashboard.n8n-mcp.com не требует ни установки, ни настройки инфраструктуры.
  • Бесплатный тариф — 100 вызовов инструментов в день, доступ к сборке workflow сразу после регистрации.
  • Достаточно зарегистрироваться, получить API-ключ и подключить его в настройках своего MCP-клиента.

3. Свой сервер через npx

  • Требование: установленный Node.js.
  • Запуск: npx n8n-mcp — скачивает и запускает последнюю версию без отдельной установки, база нодов уже встроена в пакет.
  • В конфиг Claude Desktop добавляется сервер с командой npx, аргументом n8n-mcp и обязательной переменной MCP_MODE: "stdio" — иначе в UI посыплются ошибки парсинга.
  • Файл конфигурации: ~/Library/Application Support/Claude/claude_desktop_config.json на macOS, %APPDATA%\Claude\claude_desktop_config.json на Windows.

4. Свой сервер через Docker

  • Установка образа: docker pull ghcr.io/czlonkowski/n8n-mcp:latest — образ около 280 МБ, на 82% легче обычных n8n-образов, потому что не тянет за собой сам n8n.
  • Запуск для Claude Desktop идёт через docker run -i --rm --init -e MCP_MODE=stdio ghcr.io/czlonkowski/n8n-mcp:latest — флаг -i обязателен для stdio-обмена данными.
  • Для связки с собственным n8n на той же машине в качестве N8N_API_URL используется http://host.docker.internal:5678.
  • Есть и облачный вариант без своего сервера — деплой одной кнопкой на Railway, с готовым HTTPS и авто-масштабированием.

5. Как Claude использует базу на практике

  • Правило: сначала проверяются готовые шаблоны из библиотеки в 2 352 штуки, и только если подходящего нет — схема собирается с нуля.
  • Валидация идёт в несколько уровней: сначала быстрая проверка ноды в минимальном режиме, затем полная проверка, и только потом — валидация всего workflow целиком.
  • Дефолтные значения параметров считаются главным источником ошибок на рантайме — рабочий процесс настраивается на то, чтобы явно задавать значения, а не полагаться на то, что стоит по умолчанию.