Edge Tunnel

Edge Tunnel is a tunneling technology that allows the cloud AIP server to access your internal systems via your local network. This enables AIP to utilize systems that are protected by firewalls or VPNs and are otherwise inaccessible from the outside.

Problems Solved

• No direct access to local systems → MySQL or local development servers on your PC cannot be accessed directly from the AIP server.

• VPN environment restrictions → Internal company systems accessible only via VPN (e.g., GlobalProtect) are isolated from external connections.

• Firewall policies → Most environments do not allow direct connections from the external internet to internal networks for security reasons.

How It Works

Edge Tunnel provides a connection path between the AIP server and your local system through a tunnel program running on your PC.

Connection Process

1. Request Tunnel Setup When a local system connection is needed in AIP, enable the “Use Edge Tunnel” option.

2. Run Tunnel Program Click the Edge Tunnel button at the bottom left of the screen, copy the command from the popover that appears, and run it in your PC’s terminal.

3. Connection Mediation and Status Check When the tunnel program runs, it relays connections with the AIP server, and you can check the real-time connection status (Listening…) in the popover.

4. Access Target System The tunnel program connects to the target system (MySQL, VPN server, etc.) in your local network.

Usage Examples

🏠 Local Development Environment

You can run queries directly from AIP to local databases (MySQL, PostgreSQL, etc.) running on your developer PC.

🏢 Internal Company Systems

You can use AIP to access internal databases or APIs that are only accessible via VPN.

🔒 Secure Environments

Even in environments protected by firewalls, you can use AIP features without exposing your internal network to the outside.

🧪 Sandbox Tasks

When a Skill or tool running in Sandbox needs to access a local development server, internal API, or internal network resource, it can use Edge Tunnel.

Installation & Usage

1. Enable Tunnel Option

Check the “Use Edge Tunnel” option in the database connection settings.

2. Open Tunnel Popover

Click the Edge Tunnel button at the bottom left of the screen to open the tunnel settings popover.

3. Start Tunnel Connection

Copy the command displayed in the popover and run it in your terminal.

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

4. Confirm Connection

Once the tunnel is successfully connected, the Listening… status along with the number of currently connected users will be displayed in the popover. You can now access local systems from AIP.

Using Edge Tunnel in Sandbox

When Sandbox needs to access localhost on your local PC or an internal network, enable Edge Tunnel and request access using the localhost.tunnel address.

How to Use

1. In general chat or personal agents, enable Edge Tunnel. In organization agents, configure Edge Tunnel Scope under the Skill and enable Edge Tunnel according to the scope.

2. In the chat screen, request access using the http://localhost.tunnel:<port>/... format.

For example, if you need to connect to localhost:3000 on your local PC, tell the chat:

Please connect to localhost.tunnel:3000 and proceed.

Limitations

If Web Search is enabled, or if the Web Search MCP Tavily is connected in an organization agent, AIP may connect to a web address even when you say Please connect to localhost.tunnel:3000 and proceed.

In this case, disable Web Search or add the following instruction:

Please connect using the internal skill.

Technical Features

• TCP Forwarding: Supports various protocols by mediating connections at the network level
• Automatic Routing: Automatically selects the optimal connection path based on the target address
• Connection Status Monitoring: Monitors tunnel connection status in real time

Summary

Edge Tunnel is a tunneling solution that allows the cloud server to access your local network.

• Use AIP even in secure, firewall-protected environments
• Seamlessly connect local development and internal systems
• Instantly usable with simple network setup

Enjoy the convenience of cloud AI services while keeping your local security intact!