Edge Tunnel

Edge Tunnel은 원격 AIP 서버가 사용자의 로컬 네트워크를 통해 내부 시스템에 접근할 수 있게 해주는 터널링 기술입니다. 방화벽이나 VPN으로 보호된 환경에서 외부 접근이 불가능한 시스템들을 AIP에서 활용할 수 있게 됩니다.

💻

Node.js 버전 요구사항

Edge Tunnel Client는 Node.js v18.20.8 이상의 환경에서 실행됩니다. 최적의 성능과 안정성을 위해 v20.0.0 (LTS) 이상 버전의 사용을 적극 권장합니다.

해결하는 문제

Edge Tunnel은 사용자 PC에서 실행되는 터널 프로그램을 통해 AIP 서버와 로컬 시스템 간의 연결 경로를 제공합니다.

터널 설정 요청 AIP에서 로컬 시스템 연결이 필요할 때 “Use Edge Tunnel” 옵션을 활성화합니다.
터널 프로그램 실행 화면 좌측 하단의 Edge Tunnel 버튼을 클릭하여 나타나는 팝오버에서 명령어를 복사한 뒤, 사용자 PC의 터미널에서 실행합니다.
연결 중계 및 상태 확인 터널 프로그램이 실행되면 AIP 서버와 연결을 중계하며, 팝오버에서 실시간 연결 상태(Listening…)를 확인할 수 있습니다.
목적지 접근 터널 프로그램이 로컬 네트워크 내의 목적 시스템(MySQL, VPN 서버 등)에 연결합니다.

개발자 PC에서 실행 중인 MySQL, PostgreSQL 등의 로컬 데이터베이스에 AIP에서 직접 쿼리를 실행할 수 있습니다.

VPN으로만 접근 가능한 사내 데이터베이스나 내부 API 서버를 AIP에서 활용할 수 있습니다.

방화벽으로 보호된 환경에서도 외부 연결을 허용하지 않으면서 AIP의 기능을 사용할 수 있습니다.

Sandbox에서 실행되는 Skill이나 도구가 로컬 개발 서버, 사내 API, 내부 네트워크 리소스에 접근해야 할 때 Edge Tunnel을 사용할 수 있습니다.

데이터베이스 연결 설정에서 “Use Edge Tunnel” 옵션을 체크합니다.

화면 좌측 하단의 Edge Tunnel 버튼을 클릭하여 터널 설정 팝오버를 엽니다.

Edge Tunnel UI

팝오버에 표시된 명령어를 복사하여 터미널에서 실행합니다.


npx -y @example/mcp-dev@latest tunnel link 'your-tunnel-key'

터널이 성공적으로 연결되면 팝오버에 Listening… 상태와 함께 현재 연결된 사용자 수가 표시됩니다. 이제 AIP에서 로컬 시스템에 접근할 수 있습니다.

Sandbox에서 로컬 PC의 localhost 또는 내부 네트워크에 접근해야 하는 경우, Edge Tunnel을 활성화한 뒤 localhost.tunnel 주소를 사용해 요청합니다.

일반 채팅 또는 개인 에이전트에서는 Edge Tunnel을 활성화합니다. 조직 에이전트에서는 Skill 하단의 Edge Tunnel Scope를 설정하고, Scope에 따라 Edge Tunnel을 활성화합니다.
채팅 화면에서 http://localhost.tunnel:<port>/... 형식으로 요청합니다.

예를 들어 로컬 PC의 localhost:3000에 연결해야 하는 경우, 채팅 화면에서 다음과 같이 지시합니다.

localhost.tunnel:3000에 연결하여 진행해주세요.

Web 검색을 활성화한 경우 또는 조직 에이전트에서 Web 검색 MCP인 Tavily가 연동되어 있는 경우, localhost.tunnel:3000에 연결하여 진행해주세요.라고 지시하더라도 Web 주소에 연결하는 경우가 있습니다.

이 경우에는 Web 검색을 비활성화하거나, 다음 지시를 추가하면 정상적으로 로컬 PC의 localhost에 연결할 수 있습니다.

내부 스킬을 사용하여 연결해주세요.

ℹ️

여기서 “내부 스킬”은 사용자가 등록한 Skill이 아니라 AIP 제품에 내장되어 있는 Skill을 의미합니다.

Edge Tunnel은 원격 서버가 로컬 네트워크에 접근할 수 있게 해주는 터널링 솔루션입니다.

로컬 보안을 유지하면서도 원격 AI 서비스의 편리함을 동시에 누릴 수 있는 핵심 기술입니다.