🍏 macOS용 Remote MCP Hub 설치 및 연결 안내

macOS에서 AI(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단계: 프로젝트 다운로드

GitHub에서 원하는 폴더로 리포지토리를 클론하거나 ZIP 아카이브를 다운로드합니다:

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. Mac 아키텍처(Apple Silicon 또는 Intel)용 공식 Cloudflare Tunnel 네이티브 모듈(cloudflared)을 다운로드합니다.

4. 작동하는 VPN 서버 링크를 macOS 클립보드에 직접 복사합니다.

3단계: Mac에서 VPN 설정(30초 소요)

러시아/CIS 지역에서 Cloudflare Tunnel과 AI 서비스를 안정적으로 사용하려면 무료 클라이언트 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 서버 실행

터미널(Terminal)에서 다음을 실행합니다:

./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 페이지에서 「AI 호출 로그」 탭에 요청이 실시간으로 실행되는 것을 확인할 수 있습니다.

🔒 보안

• AI와 컴퓨터 간의 모든 데이터는 종단 간 암호화(HTTPS / Cloudflare Tunnel)로 보호됩니다.

• 액세스는 비밀 Bearer 토큰으로 엄격하게 제한됩니다.

• 언제든지 터널을 끄거나 액세스 키를 변경할 수 있습니다.