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

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

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

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

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

карточка 1 — метка «База нодов» / значение «2 063» / капшен «816 базовых плюс 1 247 community-нодов, из которых 1 113 проверены вручную»; карточка 2 — метка «Библиотека шаблонов» / значение «2 352» / капшен «готовых workflow-шаблона с покрытием AI-метаданных 99,96%»; карточка 3 — метка «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 целиком.
- Дефолтные значения параметров считаются главным источником ошибок на рантайме — рабочий процесс настраивается на то, чтобы явно задавать значения, а не полагаться на то, что стоит по умолчанию.

---

Источник: https://localhost:3000/m/n8n-mcp-cheklist