# 🐧 Инструкция по установке и запуску Remote MCP Hub на Linux VDS / VPS

> Руководство по быстрому развертыванию Remote MCP Hub на удаленном Linux-сервере (Ubuntu, Debian, CentOS, AlmaLinux, Rocky, Alpine и др.) для подключения нейросетей (Notion AI, Claude, Cursor) в режиме 24/7.
> **VPN не требуется** — Cloudflare Tunnel работает на VDS напрямую без блокировок.

---

## 📋 Системные требования
- Любой **Linux VDS / VPS** сервер
- Архитектура процессора: **x86_64 (amd64)** или **ARM64**
- Доступ по SSH (права root или sudo)

---

## ⚡ Быстрый запуск за 2 минуты (3 простых шага)

### Шаг 1. Подключитесь к VDS по SSH
```bash
ssh root@<IP_ВАШЕГО_СЕРВЕРА>
```

---

### Шаг 2. Скачайте проект и запустите установку
Выполните одну команду в терминале сервера:
```bash
git clone https://github.com/etern1ty-crypto/remote-mcp-hub-linux.git && cd remote-mcp-hub-linux && chmod +x *.sh && ./install.sh
```

**Скрипт автоматически:**
1. Проверит и установит Node.js (версию 20 LTS, если не установлена).
2. Установит все необходимые зависимости (`npm install`).
3. Скачает официальный модуль Cloudflare Tunnel (`cloudflared`).
4. Сгенерирует персональный ключ доступа (Bearer Token).

---

### Шаг 3. Запуск сервера

Выберите подходящий вариант:

#### Вариант А: Запуск в режиме 24/7 в фоне (Рекомендуется)
Сервер будет работать непрерывно в фоне, даже если вы закроете SSH-терминал:
```bash
sudo ./service.sh install
```

---

#### Вариант Б: Запуск в текущей консоли
Для быстрого запуска прямо в текущем окне:
```bash
./start.sh
```

---

### 🔑 Получение данных для подключения

При запуске (в консоли или в логах службы) сразу отобразится готовый блок с ссылкой и токеном:

```text
=============================================================================
🟢 Cloudflare Tunnel успешно активен!
📡 MCP Server URL для подключения нейросети (Notion AI / Claude / Cursor):
   👉 https://xxxxxxxx.trycloudflare.com/sse
🔑 Bearer Token:
   👉 mcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
=============================================================================
```

---

## 🔄 Перезапуск сервера в 1 команду

Если вам нужно перезапустить сервер и получить новый туннель:
```bash
./restart.sh
```
*(Скрипт сам определит способ запуска, корректно перезагрузит сервер и сразу покажет обновленный URL).*

---

## 🔌 Подключение в Notion AI

1. В настройках Notion перейдите в раздел **Custom MCP Server**.
2. Заполните поля:
   - **MCP server URL:** вставьте скопированный адрес (`https://...trycloudflare.com/sse`)
   - **Name:** укажите любое имя (например, `My-Linux-VDS`)
   - **Authentication:** выберите тип **`Bearer`**
   - **Token:** вставьте ваш секретный ключ (начинается с `mcp_...`)
3. Нажмите кнопку **«Connect»** / **«Save»**.

---

## 🧪 Проверочный запрос

Отправьте в Notion AI тестовое сообщение:
```markdown
Привет! Проверь подключение к моему VDS: выполни команду "uname -a && uptime && free -h && df -h" и выведи результат.
```

Нейросеть выполнит команды на сервере и предоставит статус системы.

---

## 🛠️ Полезные команды управления

```bash
./restart.sh                 # 🔄 Перезапуск сервера в одну команду
sudo ./service.sh logs       # 📜 Просмотр логов и URL туннеля в реальном времени (Ctrl+C для выхода)
sudo ./service.sh status     # 📊 Проверить состояние фоновой службы
sudo ./service.sh stop       # ⏹️ Остановить службу
sudo ./service.sh uninstall  # ❌ Полностью удалить службу из системы
```

---

## 🔒 Безопасность
- **Белый IP и открытые порты не нужны:** благодаря Cloudflare Tunnel сервер доступен нейросети без открытия портов наружу (фаервол полностью закрыт).
- **Сквозное HTTPS-шифрование.**
- **Криптографическая Bearer-авторизация.**