n8n MCP серверы

Интеграция n8n с Model Context Protocol — два подхода для управления workflows через AI

Обзор

Для интеграции n8n с MCP доступны два community-решения с разными подходами:

mcp-n8n-server

Минималистичный, webhook-ориентированный

4 инструмента | npm пакет | n8n Cloud

n8n-mcp

Полнофункциональный, CRUD-операции

14 инструментов | Docker | Health checks

Сравнение

Характеристика	mcp-n8n-server	n8n-mcp
Автор	Ahmad Soliman	sonnd08
Язык	TypeScript	JavaScript
Инструменты	4	14
npm пакет	`@ahmad.soliman/mcp-n8n-server`	—
Docker	—	Да
n8n Cloud	Да (PROJECT_ID)	—
Node.js	>= 18	>= 22
Архитектура	Монолитная	Модульная
Transport	stdio	Streamable HTTP

mcp-n8n-server

GitHub: ahmadsoliman/mcp-n8n-server npm: @ahmad.soliman/mcp-n8n-server

Легковесный MCP сервер для запуска n8n workflows через webhooks.

Инструменты

Инструмент	Описание	Параметры
`list_workflows`	Получить все workflows	—
`list_workflow_webhooks`	Получить webhooks из workflow	`id` (workflow ID)
`call_webhook_get`	Вызвать webhook GET-запросом	`url`
`call_webhook_post`	Вызвать webhook POST-запросом	`url`, `data`

Установка

# Глобальная установка
npm install -g @ahmad.soliman/mcp-n8n-server

# Или через npx (без установки)
npx -y @ahmad.soliman/mcp-n8n-server

Переменные окружения

# URL n8n сервера (обязательно)
N8N_HOST_URL=https://your-n8n-instance.com

# API ключ (обязательно)
N8N_API_KEY=your_api_key_here

# Project ID для n8n Cloud (опционально)
PROJECT_ID=your_project_id_here

Конфигурация Claude Desktop

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@ahmad.soliman/mcp-n8n-server"],
      "env": {
        "N8N_HOST_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your_api_key",
        "PROJECT_ID": ""
      }
    }
  }
}

Примеры использования

Получить список workflows:

Пользователь: "Покажи все мои n8n workflows"
Claude: [вызывает list_workflows]

Найти webhooks в workflow:

Пользователь: "Какие webhooks есть в workflow 'Order Processing'?"
Claude: [вызывает list_workflow_webhooks с id workflow]

Вызвать webhook с данными:

Пользователь: "Отправь заказ customer123 на обработку"
Claude: [вызывает call_webhook_post с данными заказа]

Идеально для

Быстрого старта с n8n + AI
Запуска существующих workflows
Пользователей n8n Cloud
Webhook-центричных сценариев

n8n-mcp

GitHub: sonnd08/n8n-mcp

Полнофункциональный MCP сервер с полным CRUD для n8n.

Инструменты

Управление Workflows (8 инструментов)

Инструмент	Описание	Параметры
`list_workflows`	Список всех workflows	`limit` (default: 50)
`get_workflow`	Получить workflow по ID	`workflowId` (required)
`create_workflow`	Создать новый workflow	`name`, `nodes` (required)
`update_workflow`	Обновить workflow	`workflowId`, `name`, `nodes`
`delete_workflow`	Удалить workflow	`workflowId` (required)
`activate_workflow`	Активировать workflow	`workflowId` (required)
`deactivate_workflow`	Деактивировать workflow	`workflowId` (required)
`execute_workflow`	Запустить workflow	`workflowId`, `inputData`

Управление Executions (2 инструмента)

Инструмент	Описание	Параметры
`list_executions`	Список выполнений	`limit` (default: 10, max: 100)
`get_execution`	Детали выполнения	`executionId` (required)

Управление Credentials (2 инструмента)

Инструмент	Описание	Параметры
`list_credentials`	Список credentials	`limit` (default: 50)
`create_credential`	Создать credential	`name`, `type`, `data` (required)

Системные (2 инструмента)

Инструмент	Описание	Параметры
`self_test`	Проверить подключение	—
`list_nodes`	Список типов узлов	—

Установка

# Клонирование
git clone https://github.com/sonnd08/n8n-mcp
cd n8n-mcp

# Установка зависимостей
npm install

# Конфигурация
cp .env.example .env

Переменные окружения

# API ключ (обязательно)
N8N_API_KEY=your_api_key_here

# URL n8n сервера
N8N_BASE_URL=http://localhost:5678

# Порт MCP сервера
MCP_PORT=3001

Запуск

# Стандартный запуск
npm start

# С debug выводом
DEBUG=1 node index.js

# Development режим
npm run dev

Конфигурация Claude Desktop

{
  "mcpServers": {
    "n8n-full": {
      "command": "node",
      "args": ["index.js"],
      "cwd": "/path/to/n8n-mcp",
      "env": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-n8n-api-key"
      }
    }
  }
}

Docker

Dockerfile:

FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 3001
CMD ["node", "index.js"]

Docker Compose:

version: '3.8'

services:
  n8n-mcp:
    build: .
    container_name: n8n-mcp-server
    restart: unless-stopped
    ports:
      - "3001:3001"
    environment:
      - N8N_BASE_URL=http://n8n:5678
      - N8N_API_KEY=${N8N_API_KEY}
    healthcheck:
      test: ["CMD", "wget", "--spider", "http://localhost:3001/health"]
      interval: 30s
      timeout: 10s
      retries: 3

Примеры использования

Создание workflow через AI:

Пользователь: "Создай workflow для отправки email при получении webhook"

Claude: [вызывает create_workflow]
{
  "name": "Email on Webhook",
  "nodes": [
    {
      "name": "Webhook Trigger",
      "type": "n8n-nodes-base.webhook",
      "position": [100, 200],
      "parameters": {
        "path": "email-trigger",
        "httpMethod": "POST"
      }
    },
    {
      "name": "Send Email",
      "type": "n8n-nodes-base.emailSend",
      "position": [300, 200],
      "parameters": {
        "toEmail": "{{$json.email}}",
        "subject": "New webhook received"
      }
    }
  ]
}

Мониторинг выполнений:

Пользователь: "Покажи последние 5 выполнений workflows"
Claude: [вызывает list_executions с limit: 5]

Диагностика подключения:

Пользователь: "Проверь подключение к n8n"
Claude: [вызывает self_test]

Результат:
{
  "success": true,
  "tests": {
    "list_workflows": "PASS",
    "get_workflow": "PASS",
    "list_executions": "PASS",
    "create_workflow": "PASS"
  },
  "successRate": "100%"
}

Идеально для

Полного управления n8n через AI
DevOps и автоматизации
Production deployments
Создания workflows из chat

Выбирайте если:

Нужен быстрый старт
Используете n8n Cloud
Основная задача — запуск workflows через webhooks
Предпочитаете npm пакеты

npx -y @ahmad.soliman/mcp-n8n-server

Выбирайте если:

Нужно полное управление workflows (CRUD)
Планируете production deployment
Хотите создавать workflows через AI
Нужны health checks и мониторинг

git clone https://github.com/sonnd08/n8n-mcp
cd n8n-mcp && npm install && npm start

Таблица выбора

Сценарий	Рекомендация
Быстрый старт	mcp-n8n-server
Полное управление	n8n-mcp
n8n Cloud	mcp-n8n-server
Docker deployment	n8n-mcp
Webhook-центричные workflows	mcp-n8n-server
Создание workflows через AI	n8n-mcp
Production с мониторингом	n8n-mcp

Полная среда с Docker

Развёртывание n8n + MCP сервера вместе:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=password
      - N8N_API_ENABLED=true
    volumes:
      - n8n_data:/home/node/.n8n

  n8n-mcp:
    build: ./n8n-mcp
    container_name: n8n-mcp-server
    restart: unless-stopped
    ports:
      - "3001:3001"
    environment:
      - N8N_BASE_URL=http://n8n:5678
      - N8N_API_KEY=${N8N_API_KEY}
    depends_on:
      - n8n
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3001/health"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  n8n_data:

Получение API ключа n8n

Откройте n8n Settings → API
Создайте новый API ключ
Скопируйте ключ и добавьте в переменные окружения

Безопасность

Sensitive workflows

{
  "mcpServers": {
    "n8n": {
      "env": {
        "N8N_API_KEY": "${N8N_API_KEY}"
      }
    }
  }
}

Используйте переменные окружения вместо hardcoded значений.

Troubleshooting

Ошибка подключения

# Проверьте доступность n8n
curl http://localhost:5678/healthz

# Проверьте API ключ
curl -H "X-N8N-API-KEY: your_key" http://localhost:5678/api/v1/workflows

Workflow не запускается

Убедитесь что workflow активирован
Проверьте что webhook настроен правильно
Проверьте логи n8n

MCP сервер не отвечает

# Для n8n-mcp — проверить health
curl http://localhost:3001/health

# Для mcp-n8n-server — проверить процесс
ps aux | grep mcp-n8n-server

Следующие шаги

Протокол MCP — основы протокола
MCP SDK — создание своих серверов
MCP Inspector — отладка серверов

n8n MCP серверы

Обзор

Сравнение

mcp-n8n-server

Инструменты

Установка

Переменные окружения

Конфигурация Claude Desktop

Примеры использования

Идеально для

n8n-mcp

Инструменты

Управление Workflows (8 инструментов)

Управление Executions (2 инструмента)

Управление Credentials (2 инструмента)

Системные (2 инструмента)

Установка

Переменные окружения

Запуск

Конфигурация Claude Desktop

Docker

Примеры использования

Идеально для

Выбор решения

Таблица выбора

Полная среда с Docker

Получение API ключа n8n

Безопасность

Рекомендации

Sensitive workflows

Troubleshooting

Ошибка подключения

Workflow не запускается

MCP сервер не отвечает

Следующие шаги

Начало работы

Workflows

Ключевые концепции

AI и MCP

Интеграции

Хостинг

Код в n8n

Справочник