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

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

📋 Системные требования

• macOS (поддерживаются процессоры Apple Silicon M1/M2/M3/M4 и Intel)

• Установленный Node.js (версия 18 или новее) ➔ Скачать Node.js (LTS) или установить через команду brew install node

Related MCP server: Codex 2.0 MCP Gateway

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

Шаг 1. Скачайте проект

Склонируйте репозиторий или скачайте ZIP-архив с GitHub в любую удобную папку:

git clone https://github.com/etern1ty-crypto/remote-mcp-hub.git
cd remote-mcp-hub

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

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

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 или с официального GitHub.

2. Вставьте подписку:

   • Ссылка уже скопирована в буфер обмена: https://github.com/AvenCores/goida-vpn-configs/raw/refs/heads/main/githubmirror/6.txt

   • В Hiddify нажмите кнопку «+» (Новый профиль) ➔ «Добавить из буфера обмена» (или Cmd + V).

   • Нажмите «Обновить профиль» для загрузки серверов.

3. Проверьте задержку и подключитесь:

   • Запустите проверку пинга (тест задержки).

   • Выберите любой рабочий сервер (с зеленым пингом) и нажмите большую круглую кнопку Подключиться.

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

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

./start.sh

1. Автоматически откроется веб-панель управления в браузере: 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 тестовое сообщение:

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

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

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

• Все данные между нейросетью и вашим компьютером защищены сквозным шифрованием (HTTPS / Cloudflare Tunnel).

• Доступ строго ограничен секретным Bearer-токеном.

• Вы можете в любой момент выключить туннель или сменить ключ доступа.