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

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
sudo ./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) 🆕 Создать новый инстанс в главном меню

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

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

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

</WRAP>

Автоматически выбран порт: 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) Удалить

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

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

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

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

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

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

Активные инстансы:
------------------------------------------------
ИМЯ             ПОРТ       СТАТУС       СОЗДАН
------------------------------------------------
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) 🔧 Исправить права доступа если возникли проблемы с правами на файлы.

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

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

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

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

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

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

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

<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 в репозитории.