# YIVPN Local MCP & Unified AI Agent Guide (Consolidated into /vpn-api/llms.txt v2.2) > **Unified Endpoint & Freshness Notice**: YIVPN Local Desktop MCP and the Zero-Account Cloud Agent VPN API are unified under **`yivpn-agent-cli v2.2.1`** and [`https://yivpn.net/vpn-api/llms.txt`](https://yivpn.net/vpn-api/llms.txt) (Human Hub: [`https://yivpn.net/en/vpn-api/#desktop-mcp`](https://yivpn.net/en/vpn-api/#desktop-mcp)). > - **GFW / Mainland China First-Party Mirror (Zero GitHub Dependency)**: `https://yivpn.net/vpn-api/yivpn-agent.mjs` (SHA-256: `6dc9cab1175e626726c56eb63e4af15473aee8eefb6c396f53a8b7930badef63`) ## Quick Connect (`yivpn-agent-cli v2.2.1` Conflict-Safe Auto-Discovery) 1. **Zero-Account Personal PC or Cloud Sandbox (`$0` 90m / 1 GiB Free Trial, No Desktop Login Needed)**: - **Save CLI to Persistent `~/.yivpn-agent/` & Inspect Host First (GFW & PowerShell Safe)**: ```powershell New-Item -ItemType Directory -Force -Path "$HOME\.yivpn-agent" | Out-Null curl.exe -fsSL https://yivpn.net/vpn-api/yivpn-agent.mjs -o "$HOME\.yivpn-agent\yivpn-agent.mjs" node "$HOME\.yivpn-agent\yivpn-agent.mjs" status # If YIVPN Desktop GUI is installed (desktop_app.installed=true), prefer launching it (90m/day free Global TUN): # node "$HOME\.yivpn-agent\yivpn-agent.mjs" launch-desktop # Personal Windows/macOS PC without conflicting active proxy (auto-restores on disconnect or trial expiry): node "$HOME\.yivpn-agent\yivpn-agent.mjs" connect --auto-trial --system-proxy # Cloud VM / Linux / Docker / SSH (local 127.0.0.1:10808 port only, never touches SSH): node "$HOME\.yivpn-agent\yivpn-agent.mjs" connect --auto-trial ``` - **Register as Zero-App MCP Server**: ```bash claude mcp add yivpn -- node ~/.yivpn-agent/yivpn-agent.mjs mcp ``` 2. **Windows / macOS Desktop App (`YIVPN v1.0.6+` Kernel Split-Tunnel Control)**: - Note: YIVPN Desktop (`v1.0.6+`) already includes **90 min/day of `$0` free OS-wide TUN** in the GUI with zero account required. Enable **Settings → Connection Strategy → Local MCP Service (AI Agent)** (YiPro) only when you want an AI Agent to programmatically edit live split-tunneling rules (`preview_routing_rules` → `apply_routing_rules` → `rollback_routing_rules`): ```bash claude mcp add yivpn -e YIVPN_MCP_TOKEN=yivpn_mcp_ -- node ~/.yivpn-agent/yivpn-agent.mjs mcp ``` Read the complete unified runbook, proxy conflict guardrails, and security audit disclosure at `https://yivpn.net/vpn-api/llms.txt`.