# 🍏 Инструкция по установке и подключению Remote MCP Hub для macOS

> Руководство для клиентов и пользователей macOS, которым необходимо предоставить нейросети (Notion AI, Claude, Cursor и др.) защищенный удаленный доступ к файлам и командной строке своего Mac.

---

## 📋 Системные требования
- **macOS** (поддерживаются процессоры **Apple Silicon M1/M2/M3/M4** и **Intel**)
- Установленный **Node.js** (версия 18 или новее) ➔ [Скачать Node.js (LTS)](https://nodejs.org/) или установить через команду `brew install node`

---

## ⚡ Быстрая установка за 4 простых шага

### Шаг 1. Скачайте проект
Склонируйте репозиторий или скачайте ZIP-архив с GitHub в любую удобную папку:
```bash
git clone https://github.com/etern1ty-crypto/remote-mcp-hub.git
cd remote-mcp-hub
```

---

### Шаг 2. Запустите скрипт установки `install.sh`

Откройте приложение **Терминал (Terminal)** в папке с проектом и выполните:

```bash
chmod +x install.sh start.sh && ./install.sh
```

**Скрипт автоматически:**
1. Проверит наличие Node.js в системе.
2. Установит все необходимые библиотеки (`npm install`).
3. Загрузит официальный нативный модуль Cloudflare Tunnel (`cloudflared`) для вашей архитектуры Mac (Apple Silicon или Intel).
4. Скопирует рабочую ссылку на VPN-серверы прямо в ваш **буфер обмена macOS**.

---

### Шаг 3. Настройка VPN на Mac (занимает 30 секунд)

Для стабильной работы Cloudflare Tunnel и сервисов нейросетей в РФ/СНГ рекомендуется использовать бесплатный клиент **Hiddify**:

1. **Установите Hiddify:**
   - Скачайте из [Mac App Store](https://apps.apple.com/app/hiddify-proxy-vpn/id6596777532) или с [официального GitHub](https://github.com/hiddify/hiddify-next/releases/latest).
2. **Вставьте подписку:**
   - Ссылка уже скопирована в буфер обмена:
     `https://github.com/AvenCores/goida-vpn-configs/raw/refs/heads/main/githubmirror/6.txt`
   - В Hiddify нажмите кнопку **«+»** (Новый профиль) ➔ **«Добавить из буфера обмена»** (или `Cmd + V`).
   - Нажмите **«Обновить профиль»** для загрузки серверов.
3. **Проверьте задержку и подключитесь:**
   - Запустите проверку пинга (тест задержки).
   - Выберите любой рабочий сервер (с зеленым пингом) и нажмите большую круглую кнопку **Подключиться**.

---

### Шаг 4. Запустите сервер Remote MCP Hub

В Терминале выполните:

```bash
./start.sh
```

1. Автоматически откроется веб-панель управления в браузере: **[http://localhost:3800](http://localhost:3800)**.
2. В интерфейсе нажмите кнопку **«Запустить туннель»**.
3. Статус станет **«🟢 Онлайн»**, и появится персональный адрес вида:
   `https://<имя-туннеля>.trycloudflare.com/sse`
4. Нажмите кнопку **«Копировать»** рядом с **MCP server URL** и рядом с **Bearer Token**.

---

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

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

---

## 🧪 Проверка работы

Отправьте в Notion AI тестовое сообщение:

```markdown
Привет! Проверь подключение к моему Mac: выполни в терминале команду "echo MCP на Mac подключен успешно! && uname -a && ls -la" и выведи результат.
```

В окне браузера на странице **http://localhost:3800** во вкладке **«Журнал вызовов ИИ»** вы увидите выполнение запроса в реальном времени.

---

## 🔒 Безопасность
- Все данные между нейросетью и вашим компьютером защищены сквозным шифрованием (HTTPS / Cloudflare Tunnel).
- Доступ строго ограничен секретным Bearer-токеном.
- Вы можете в любой момент выключить туннель или сменить ключ доступа.