🍏 Instructions for Installing and Connecting Remote MCP Hub for macOS

A guide for macOS clients and users who need to provide AI services (Notion AI, Claude, Cursor, etc.) with secure remote access to their Mac's files and command line.

📋 System Requirements

• macOS (supports Apple Silicon M1/M2/M3/M4 and Intel processors)

• Installed Node.js (version 18 or newer) ➔ Download Node.js (LTS) or install via the command brew install node

Related MCP server: Codex 2.0 MCP Gateway

⚡ Quick Installation in 4 Simple Steps

Step 1. Download the project

Clone the repository or download the ZIP archive from GitHub to any convenient folder:

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

Step 2. Run the installation script install.sh

Open the Terminal app in the project folder and run:

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

The script automatically:

1. Checks whether Node.js is present on the system.

2. Installs all necessary libraries (npm install).

3. Downloads the official Cloudflare Tunnel native module (cloudflared) for your Mac architecture (Apple Silicon or Intel).

4. Copies a working link to VPN servers straight to your macOS clipboard.

Step 3. Configure VPN on Mac (takes 30 seconds)

For stable operation of Cloudflare Tunnel and AI services in Russia/CIS, it is recommended to use the free Hiddify client:

1. Install Hiddify:

   • Download from Mac App Store or from the official GitHub.

2. Paste the subscription:

   • The link is already copied to the clipboard: https://github.com/AvenCores/goida-vpn-configs/raw/refs/heads/main/githubmirror/6.txt

   • In Hiddify, click the «+» button (New profile) ➔ «Add from clipboard» (or Cmd + V).

   • Click «Update profile» to load the servers.

3. Check latency and connect:

   • Run a ping test (latency test).

   • Select any working server (with green ping) and click the big round Connect button.

Step 4. Start the Remote MCP Hub server

In Terminal, run:

./start.sh

1. The web control panel will automatically open in the browser: http://localhost:3800.

2. In the interface, click the «Start tunnel» button.

3. The status will become «🟢 Online», and a personal address of the form will appear: https://<имя-туннеля>.trycloudflare.com/sse

4. Click the «Copy» button next to MCP server URL and next to Bearer Token.

🔌 Connecting to Notion AI

1. In Notion settings, go to the Custom MCP Server section.

2. Fill in the fields:

   • MCP server URL: paste the copied address (https://...trycloudflare.com/sse)

   • Name: enter any name (for example, MacBook-Pro)

   • Authentication: select the Bearer type

   • Token: paste your secret key (starts with mcp_...)

3. Click «Connect» / «Save».

🧪 Checking That It Works

Send a test message to Notion AI:

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

In the browser window on the http://localhost:3800 page, in the «AI Call Log» tab, you will see the request being executed in real time.

🔒 Security

• All data between the AI service and your computer is protected by end-to-end encryption (HTTPS / Cloudflare Tunnel).

• Access is strictly restricted by a secret Bearer token.

• You can turn off the tunnel or change the access key at any time.