🍏 Anleitung zur Installation und Verbindung von Remote MCP Hub für macOS

Anleitung für Kunden und macOS-Benutzer, die einer KI (Notion AI, Claude, Cursor usw.) sicheren Fernzugriff auf Dateien und die Befehlszeile ihres Macs gewähren müssen.

📋 Systemanforderungen

• macOS (Prozessoren Apple Silicon M1/M2/M3/M4 und Intel werden unterstützt)

• Installiertes Node.js (Version 18 oder neuer) ➔ Node.js (LTS) herunterladen oder per Befehl brew install node installieren

Related MCP server: MCP Cloud Gateway

⚡ Schnellinstallation in 4 einfachen Schritten

Schritt 1: Projekt herunterladen

Klonen Sie das Repository oder laden Sie das ZIP-Archiv von GitHub in einen beliebigen Ordner herunter:

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

Schritt 2: Installationsskript install.sh ausführen

Öffnen Sie die App Terminal im Projektordner und führen Sie aus:

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

Das Skript führt automatisch Folgendes aus:

1. Prüft, ob Node.js auf dem System vorhanden ist.

2. Installiert alle erforderlichen Bibliotheken (npm install).

3. Lädt das offizielle native Modul Cloudflare Tunnel (cloudflared) für Ihre Mac-Architektur (Apple Silicon oder Intel) herunter.

4. Kopiert einen funktionierenden Link zu den VPN-Servern direkt in Ihre macOS-Zwischenablage.

Schritt 3: VPN auf dem Mac einrichten (dauert 30 Sekunden)

Für einen stabilen Betrieb von Cloudflare Tunnel und der KI-Dienste in Russland/GUS wird empfohlen, den kostenlosen Client Hiddify zu verwenden:

1. Hiddify installieren:

   • Laden Sie es aus dem Mac App Store oder vom offiziellen GitHub herunter.

2. Abonnement einfügen:

   • Der Link wurde bereits in die Zwischenablage kopiert: https://github.com/AvenCores/goida-vpn-configs/raw/refs/heads/main/githubmirror/6.txt

   • Klicken Sie in Hiddify auf die Schaltfläche „+" (Neues Profil) ➔ „Aus Zwischenablage hinzufügen" (oder Cmd + V).

   • Klicken Sie auf „Profil aktualisieren", um die Server zu laden.

3. Latenz prüfen und verbinden:

   • Führen Sie einen Ping-Test (Latenztest) durch.

   • Wählen Sie einen beliebigen funktionierenden Server (mit grünem Ping) und klicken Sie auf die große runde Schaltfläche Verbinden.

Schritt 4: Remote-MCP-Hub-Server starten

Führen Sie im Terminal aus:

./start.sh

1. Das Web-Dashboard wird automatisch im Browser geöffnet: http://localhost:3800.

2. Klicken Sie in der Oberfläche auf die Schaltfläche „Tunnel starten".

3. Der Status wechselt zu „🟢 Online" und eine persönliche Adresse erscheint: https://<имя-туннеля>.trycloudflare.com/sse

4. Klicken Sie auf „Kopieren" neben MCP server URL und neben Bearer Token.

🔌 Verbindung zu Notion AI herstellen

1. Gehen Sie in den Notion-Einstellungen zum Abschnitt Custom MCP Server.

2. Füllen Sie die Felder aus:

   • MCP server URL: fügen Sie die kopierte Adresse ein (https://...trycloudflare.com/sse)

   • Name: geben Sie einen beliebigen Namen an (z. B. MacBook-Pro)

   • Authentication: wählen Sie den Typ Bearer

   • Token: fügen Sie Ihren geheimen Schlüssel ein (beginnt mit mcp_...)

3. Klicken Sie auf „Connect" / „Save".

🧪 Funktionsprüfung

Senden Sie eine Testnachricht an Notion AI:

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

Im Browserfenster auf der Seite http://localhost:3800 sehen Sie auf der Registerkarte „KI-Aufrufprotokoll" die Ausführung der Anfrage in Echtzeit.

🔒 Sicherheit

• Alle Daten zwischen der KI und Ihrem Computer sind durch Ende-zu-Ende-Verschlüsselung geschützt (HTTPS / Cloudflare Tunnel).

• Der Zugriff ist strikt durch den geheimen Bearer-Token beschränkt.

• Sie können den Tunnel jederzeit deaktivieren oder den Zugriffsschlüssel ändern.