vm:n8n_mcp:01-install_http_multi-user

Это старая версия документа!

n8n MCP Multi-Instance - Руководство пользователя

Источники

https://github.com/czlonkowski/n8n-mcp
https://www.n8n-mcp.com/

Установка в один клик

Важно!
Если хотите что бы все папки и файлы создались от текущего пользователя что бы был доступ для редактирования запускать не от SUDO
Тогда скрипт выяснит текущего пользователя и установит все от системного пользователя. 

cd ~
wget "https://dokuwiki.nanokey.tech/_media/vm:n8n_mcp:n8n_mcp_multi_installer.tar" -O n8n_mcp_multi_installer.tar
tar -xvf n8n_mcp_multi_installer.tar
chmod +x n8n_mcp_multi_installer.sh
./n8n_mcp_multi_installer.sh

Важно!
После установки первичной нужно выйти из текущей сессии и зайти что бы применились все новые права для работы с меню.

Обзор системы

n8n MCP Multi-Instance - это система управления множественными изолированными инстансами n8n MCP с централизованным управлением клиентскими подключениями.

Ключевые возможности

  • 🏗️ Множественные инстансы - создание изолированных серверов на разных портах
  • 🔄 Автоматическое распределение портов - система сама выбирает свободные порты
  • 👥 Управление клиентами - создание конфигураций для подключения MCP клиентов
  • 🎛️ Централизованное управление - единая консоль для всех операций
  • 🚀 Массовые операции - запуск/остановка всех инстансов одной командой

Структура системы

/opt/n8nmcp/
├── instances/              # Инстансы n8n MCP
│   ├── main/              # Базовый инстанс (создается автоматически)
│   ├── instance2/         # Дополнительные инстансы
│   └── ...
├── clients/               # Клиентские конфигурации
│   ├── client1/
│   └── ...
├── multi-manage.sh        # Главная консоль управления
├── start-main.sh          # Быстрый запуск базового инстанса
└── logs/                  # Общие логи системы

Запуск консоли управления

Основная команда

/opt/n8nmcp/multi-manage.sh

Быстрый запуск базового инстанса

/opt/n8nmcp/start-main.sh

Главное меню

При запуске консоли управления вы увидите следующее меню: 

================================
n8n MCP Multi-Instance Management Console
================================

📦 ИНСТАНСЫ:
1) 🆕 Создать новый инстанс
2) 📋 Список инстансов
3) ⚙️  Управление инстансом
4) 🔄 Запустить все инстансы
5) ⏹️  Остановить все инстансы

👥 КЛИЕНТЫ:
6) 🆕 Создать клиентский конфиг
7) 📋 Список клиентов
8) 🔌 Тестировать подключение клиента
9) 🗑️  Удалить клиента

🔧 СИСТЕМА:
10) 📊 Общий статус системы
11) 📡 Показать все подключения
12) 🧹 Очистка неиспользуемых ресурсов
13) 🔄 Обновить все образы
14) 🔧 Исправить права доступа

0) ❌ Выход

Управление инстансами

Создание нового инстанса

Шаг 1: Выберите пункт меню

Выберите 1) 🆕 Создать новый инстанс в главном меню

Шаг 2: Введите имя инстанса

Введите имя инстанса: production

<WRAP center round info 60%> Рекомендации по именованию:

  • Используйте понятные имена: production, development, test
  • Избегайте пробелов и специальных символов
  • Используйте только латинские буквы, цифры и дефисы

</WRAP>

Шаг 3: Выбор порта

Автоматически выбран порт: 3001
Использовать этот порт или ввести другой? (Enter для 3001):
  • Enter - использовать автоматически выбранный порт
  • Ввести число - использовать свой порт (например: 3005)

Результат создания

✅ Инстанс production создан успешно!
Порт: 3001
AUTH_TOKEN: AbCdEf123456...

<WRAP center round important 60%> ВАЖНО: Обязательно сохраните AUTH_TOKEN - он понадобится для подключения клиентов! </WRAP>

Просмотр списка инстансов

Выберите 2) 📋 Список инстансов для просмотра всех созданных инстансов: 

Активные инстансы:
------------------------------------------------
ИМЯ             ПОРТ       СТАТУС       СОЗДАН
------------------------------------------------
main            3000       ЗАПУЩЕН      2025-01-15
production      3001       ОСТАНОВЛЕН   2025-01-15
development     3002       ЗАПУЩЕН      2025-01-15
------------------------------------------------

Управление отдельным инстансом

Выбор инстанса

Выберите 3) ⚙️ Управление инстансом, затем введите имя инстанса: 

Введите имя инстанса: production

Меню управления

Управление инстансом: production
1) Запустить
2) Остановить
3) Перезапустить
4) Логи
5) Статус
6) Удалить

Описание действий

Действие Описание
Запустить Запуск остановленного инстанса
Остановить Остановка работающего инстанса
Перезапустить Перезапуск инстанса (применение изменений)
Логи Просмотр логов в реальном времени (Ctrl+C для выхода)
Статус Информация о состоянии контейнера
Удалить Полное удаление инстанса (требует подтверждения)

Массовые операции

Запуск всех инстансов

Выберите 4) 🔄 Запустить все инстансы для одновременного запуска всех созданных инстансов.

Остановка всех инстансов

Выберите 5) ⏹️ Остановить все инстансы для остановки всех работающих инстансов.

Управление клиентами

Создание клиентского конфига

Клиентские конфиги содержат всю информацию, необходимую для подключения MCP клиентов к конкретному инстансу.

Шаг 1: Выберите пункт меню

Выберите 6) 🆕 Создать клиентский конфиг

Шаг 2: Введите имя клиента

Имя клиента: claude-desktop

Шаг 3: Выберите инстанс

Система покажет список доступных инстансов: 

Активные инстансы:
------------------------------------------------
ИМЯ             ПОРТ       СТАТУС       СОЗДАН
------------------------------------------------
main            3000       ЗАПУЩЕН      2025-01-15
production      3001       ЗАПУЩЕН      2025-01-15
------------------------------------------------

Имя инстанса: production

Результат создания

✅ Клиент создан!
URL: http://localhost:3001
Token: AbCdEf123456...

Список клиентов

Выберите 7) 📋 Список клиентов для просмотра всех созданных клиентских конфигов: 

claude-desktop -> production (http://localhost:3001)
vscode-extension -> main (http://localhost:3000)
test-client -> development (http://localhost:3002)

Тестирование подключения

Проверка клиента

Выберите 8) 🔌 Тестировать подключение клиента, затем введите имя клиента: 

Имя клиента: claude-desktop

Результаты теста

Тестирование: http://localhost:3001
✅ Подключение успешно

или 

Тестирование: http://localhost:3001
❌ Ошибка подключения

<WRAP center round tip 60%> Совет: Если подключение не работает, убедитесь что инстанс запущен через 3) Управление инстансом </WRAP>

Удаление клиента

Выберите 9) 🗑️ Удалить клиента для удаления клиентского конфига: 

Имя клиента: old-client
Клиент удален

Системные функции

Общий статус системы

Выберите 10) 📊 Общий статус системы для просмотра общей информации: 

================================
Статус системы
================================
Docker: Docker version 24.0.7
Инстансов: 3
Клиентов: 2
Запущено контейнеров: 2

Показ всех подключений

Выберите 11) 📡 Показать все подключения для просмотра информации о подключениях: 

================================
Все подключения
================================
main
  URL: http://localhost:3000
  Token: xyz123...

production
  URL: http://localhost:3001
  Token: abc456...

Очистка ресурсов

Выберите 12) 🧹 Очистка неиспользуемых ресурсов для удаления неиспользуемых Docker образов и контейнеров.

Обновление образов

Выберите 13) 🔄 Обновить все образы для загрузки последних версий Docker образов.

Исправление прав доступа

Выберите 14) 🔧 Исправить права доступа если возникли проблемы с правами на файлы.

Использование с MCP клиентами

Claude Desktop

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

После создания клиентского конфига используйте полученные данные в настройках Claude Desktop: 

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"],
      "env": {
        "FETCH_ENDPOINT": "http://localhost:3001",
        "FETCH_HEADERS": "{\"Authorization\": \"Bearer AbCdEf123456...\"}"
      }
    }
  }
}

VS Code или другие клиенты

Используйте следующие параметры подключения:

  • URL: http://localhost:ПОРТ
  • Authorization Header: Bearer ТОКЕН
  • Content-Type: application/json

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

Сценарий 1: Создание среды разработки

1. Запустите консоль: /opt/n8nmcp/multi-manage.sh
2. Выберите: 1) Создать новый инстанс
3. Введите имя: development
4. Нажмите Enter для автопорта (например, 3001)
5. Выберите: 6) Создать клиентский конфиг
6. Введите имя клиента: dev-claude
7. Выберите инстанс: development
8. Используйте полученные URL и Token в вашем MCP клиенте

Сценарий 2: Тестирование нового функционала

1. Создайте тестовый инстанс: test-v2
2. Создайте клиентский конфиг: test-client
3. Протестируйте функционал через клиента
4. При необходимости удалите инстанс через: 3) Управление инстансом → 6) Удалить

Сценарий 3: Продакшн развертывание

1. Создайте продакшн инстанс: production
2. Настройте клиентские конфиги для всех пользователей
3. Используйте 4) Запустить все инстансы для массового запуска
4. Мониторьте через 10) Общий статус системы

Устранение неисправностей

Проблемы с правами Docker

<WRAP center round important 60%> Решение: Выполните команду newgrp docker или перелогиньтесь в систему </WRAP> 

# Применить права Docker в текущей сессии
newgrp docker
 
# Или перелогиниться
exit
ssh user@your-server

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

Проверка логов

1. Выберите: 3) Управление инстансом
2. Введите имя проблемного инстанса
3. Выберите: 4) Логи
4. Проанализируйте ошибки

Проверка портов

# Проверить занятые порты
netstat -tuln | grep :3000

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

Чек-лист проверки

  1. ✅ Инстанс запущен (проверить через список инстансов)
  2. ✅ Правильный порт в URL
  3. ✅ Корректный AUTH_TOKEN
  4. ✅ Нет файрволла, блокирующего порт

Тестирование вручную

# Проверить health check
curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:3001/health

Резервное копирование

Полная система

# Создать резервную копию всей системы
sudo tar -czf n8nmcp-backup-$(date +%Y%m%d).tar.gz /opt/n8nmcp/

Отдельный инстанс

# Резервная копия конкретного инстанса
sudo tar -czf instance-production-$(date +%Y%m%d).tar.gz /opt/n8nmcp/instances/production/

Полезные команды

Быстрый доступ

# Консоль управления
/opt/n8nmcp/multi-manage.sh
 
# Быстрый запуск базового инстанса
/opt/n8nmcp/start-main.sh
 
# Проверка статуса всех контейнеров
docker ps --filter "name=n8n-mcp"
 
# Просмотр логов конкретного инстанса
docker logs n8n-mcp-production -f

Прямое управление

# Перейти к инстансу и управлять напрямую
cd /opt/n8nmcp/instances/production
docker-compose up -d      # Запуск
docker-compose down       # Остановка
docker-compose logs -f    # Логи
docker-compose ps         # Статус

Заключение

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

Ключевые преимущества:

  • 🚀 Быстрое развертывание - новый инстанс за минуту
  • 🔒 Изолированность - каждый инстанс работает независимо
  • 👥 Удобство управления клиентами - автоматическая генерация конфигов
  • 📊 Мониторинг - централизованный контроль всех инстансов
  • 🛡️ Безопасность - уникальные токены для каждого инстанса

Для получения дополнительной помощи или сообщения об ошибках обращайтесь к документации проекта или создавайте issue в репозитории.

  • vm/n8n_mcp/01-install_http_multi-user.1755154077.txt.gz
  • Последнее изменение: 2025/08/14 06:47
  • — admin