Pick Regions & Fastest Exit Nodes
Ask your agent to benchmark latency and switch exits across Japan, Singapore, Hong Kong, or the US in one sentence.
Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen 지원 — 전송하면 AI가 자동으로 설정을 마치고 90분 무료 체험 및 암호화 연결을 완료합니다.
Read https://yivpn.net/vpn-api/llms.txt and auto-connect this environment to YIVPN (claim the free 90-min trial if needed).
Ask your agent to benchmark latency and switch exits across Japan, Singapore, Hong Kong, or the US in one sentence.
Rootless proxy never touches cloud VM default routes — internal DBs and SSH stay direct while external requests use YIVPN.
Toggle tunnel-level Cloudflare Security DoH and ad-tracker blocking to protect headless browsers and speed up page loads.
Compare direct vs. tunneled latency and exit IP anytime, check remaining free trial minutes, or generate a zero-account checkout link.
Click Copy on any card below and paste into Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen.
“Benchmark latency and switch my YIVPN proxy exit to the fastest Japan node, then confirm the new exit IP.”
“Enable smart split so internal databases and local networks stay direct while external APIs go through YIVPN.”
“Configure curl, git, and Python in this session to route through my local YIVPN proxy and test connectivity.”
“Turn on malware/phishing protection and ad-blocking on my YIVPN tunnel for cleaner headless browsing.”
“Check my YIVPN tunnel health and compare direct vs. proxied latency right now.”
“Check how much time is left on my free YIVPN trial, or get a link to unlock all US/JP/SG/HK nodes.”
Turn on Settings → Connection → Local MCP in YIVPN Desktop, then send to Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen to inspect status and manage split-tunnel routes.
Read https://yivpn.net/vpn-api/llms.txt, connect to my local YIVPN Desktop MCP service, check VPN status, and manage split-tunnel routes.
Your agent inspects all entitled nodes in your YIVPN Desktop app, tests latency, and switches to the fastest region on command.
Route blocked dev sites or specific apps through the VPN while keeping local messengers, banking, and game downloads at full ISP speed.
Every rule change is previewed first, applied to sing-box, and probed live — if anything fails, YIVPN auto-restores the last working snapshot.
Bound strictly to 127.0.0.1 with revocable per-agent tokens; disconnecting VPN or widening direct bypass requires your click in the app.
Click Copy on any card below and paste into Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen.
“Check which YIVPN node I am on right now, test latency, and switch me to the fastest Japan server.”
“huggingface.co and docker.io are failing to load — route both domains through YIVPN for me.”
“Keep my company intranet and local banking domains on direct connection so they do not detour through VPN.”
“Route Cursor and git through YIVPN, while keeping my games and large downloads on direct connection.”
“Why is api.openai.com loading slowly? Diagnose DNS, IPv6, and my current YIVPN route.”
“Something feels off after that last routing tweak — roll back YIVPN to my previous configuration.”
Most users only need the plain-language prompt above. Developers inspecting the 8 JSON-RPC 2.0 kernel tools or configuring MCP config files manually can expand the reference below:
| MCP Tool Name | Scope | Real Kernel Action & Verification | Safety Boundary & User Confirmation |
|---|---|---|---|
| get_capabilities | read | Returns OS platform, sing-box 1.14.3 kernel mode (TUN / Proxy), pre-authorized scopes, and 12 verified service presets | Read-only; explicitly reports unsupported rule types per mode |
| get_vpn_status | read | Reads live tunnel state, active node, verified exit IP, smart-split state, and optimistic policyVersion | Never exposes private keys, UUIDs, or subscription tokens |
| list_servers | read | Lists nodes the active paid account or local subscription is entitled to use (id, name, region, protocols) | Enforces live paid entitlement check; strips raw credentials |
| connect_vpn / disconnect_vpn | modify | Connects or disconnects the real desktop VPN tunnel and verifies exit connectivity (aligned with Cloud MCP tool names) | disconnect_vpn requires in-app user confirmation unless pre-authorized |
| diagnose_connection | diagnose | Runs DNS (A/AAAA), IPv6 reachability, TCP/HTTPS probe, and parses sing-box kernel outbound logs as evidence | Rate-limited (15 req/min) and body-capped (32 KB) |
| preview_routing_rules | modify | Validates proposed rules (domain, domain_suffix, ip_cidr, process_name, service_preset), outputs planId, diff & conflicts | Zero network mutation; blocks 0.0.0.0/0 & hallucinated presets |
| apply_routing_rules | modify | Checks basePolicyVersion & idempotencyKey, saves a safety snapshot, reloads sing-box, and verifies real route path | Automatically rolls back to the previous snapshot if verification fails |
| rollback_routing_rules | modify | Restores the previous or specified snapshotId configuration and re-verifies tunnel health locally | Works offline without AI intervention; never fails open to global direct |
# 1. Mainland China & Global Unified Bridge (v2.2 — GFW & ExecutionPolicy Safe)
mkdir -p ~/.yivpn-agent && curl -fsSL https://yivpn.net/vpn-api/yivpn-agent.mjs -o ~/.yivpn-agent/yivpn-agent.mjs
claude mcp add yivpn -e YIVPN_MCP_TOKEN=yivpn_mcp_<YOUR_AGENT_TOKEN> \
-- node ~/.yivpn-agent/yivpn-agent.mjs mcp
# 2. Claude Code — Direct Loopback Streamable HTTP (no Node.js wrapper needed)
claude mcp add --transport http yivpn http://127.0.0.1:38410/mcp \
--header "Authorization: Bearer yivpn_mcp_<YOUR_AGENT_TOKEN>"
# 3. OpenAI Codex (~/.codex/config.toml)
[mcp_servers.yivpn]
url = "http://127.0.0.1:38410/mcp"
http_headers = { "Authorization" = "Bearer yivpn_mcp_<YOUR_AGENT_TOKEN>" }
# 4. Universal Stdio (.mcp.json — Cursor / Windsurf / Claude Desktop)
{
"mcpServers": {
"yivpn": {
"command": "node",
"args": ["/Users/<you>/.yivpn-agent/yivpn-agent.mjs", "mcp"],
"env": {
"YIVPN_MCP_TOKEN": "yivpn_mcp_<YOUR_AGENT_TOKEN>"
}
}
}
}
127.0.0.1 and validates Host / Origin headers against DNS rebinding. Running node ~/.yivpn-agent/yivpn-agent.mjs mcp (v2.2) auto-discovers your local desktop port when active.기존 VPN은 사람의 회원가입과 GUI 클릭을 전제로 설계되었습니다. YIVPN Agent API(https://yivpn.net/api/v1/vpn)는 모든 과정을 순수 HTTP와 ed25519-v1 암호화 서명으로 처리합니다.
rail: "trial" 서명 호출로 90분/1GB 무료 체험을 즉시 활성화하고(기존 프록시 및 클라우드 호환), 4개 전체 리전은 Hosted Checkout 또는 HTTP 402 Base USDC(x402)로 정산합니다.GET /api/v1/vpn/config?mode=proxy를 호출합니다.127.0.0.1:10808(HTTP + SOCKS5)에서 sing-box를 실행하여 호스트 라우팅 변경이나 SSH 끊김이 없습니다.# 1. Save Zero-Dependency First-Party CLI (v2.2 — GFW & ExecutionPolicy Safe)
mkdir -p ~/.yivpn-agent
curl -fsSL https://yivpn.net/vpn-api/yivpn-agent.mjs -o ~/.yivpn-agent/yivpn-agent.mjs
node ~/.yivpn-agent/yivpn-agent.mjs status
# 2. Connect (Cloud VM / SSH: 127.0.0.1:10808 only | Personal PC: add --system-proxy with auto-restore watchdog)
node ~/.yivpn-agent/yivpn-agent.mjs connect --auto-trial --system-proxy
curl -fsSL --noproxy "*" https://cloudflare.com/cdn-cgi/trace
curl -fsSL -x http://127.0.0.1:10808 https://cloudflare.com/cdn-cgi/trace
node ~/.yivpn-agent/yivpn-agent.mjs disconnect
# 3. Unified MCP Server (Auto-detects Zero-App Cloud Mode OR YIVPN Desktop Split-Tunnel Bridge)
claude mcp add yivpn -- node ~/.yivpn-agent/yivpn-agent.mjs mcp
claude mcp add yivpn -e YIVPN_MCP_TOKEN=yivpn_mcp_<YOUR_AGENT_TOKEN> -- node ~/.yivpn-agent/yivpn-agent.mjs mcp
# 4. Multi-Region Upgrade (US/JP/SG/HK, up to 5 concurrent sandboxes, Checkout or x402 USDC)
node ~/.yivpn-agent/yivpn-agent.mjs buy --months 1 --rail checkout
node ~/.yivpn-agent/yivpn-agent.mjs settings --guardrails malware,ads --region auto
일반 WireGuard 스크립트는 CAP_NET_ADMIN 권한을 요구하고 기본 라우트를 덮어써 원격 서버 SSH를 끊어버립니다. YIVPN은 에이전트 인프라에 최적화되어 있습니다:
| 비교 항목 | YIVPN Agent API | 일반 WireGuard API |
|---|---|---|
| 컨테이너 및 SSH 안전성 | 기본 무루트 로컬 프록시 (127.0.0.1:10808, SSH 유지) 및 선택형 TUN 모드 | root 권한 필수, 기본 라우트 변경으로 SSH 연결 끊김 위험 |
| 검열 우회 전송 프로토콜 | Hysteria2 (QUIC/UDP 443) + VLESS+REALITY (TLS 1.3/TCP 443) | 단순 UDP WireGuard 패킷은 방화벽 DPI에 쉽게 차단됨 |
| 글로벌 저지연 리전 | 미국(US), 일본(JP), 싱가포르(SG), 홍콩(HK) 자동 장애 조치 | 설정 파일당 단일 고정 노드 |
| 암호화 키 수명주기 | ed25519-v1 요청 서명, 원자적 키 교체(/rotate) 및 즉시 폐기 | 재전송 공격 방지가 없는 정적 키 |
PUT /api/v1/vpn/settings로 터널 DNS 보안 정책을 실시간 제어하며, 요금은 YiPro와 100% 동일합니다:
| 가드레일 / 이용 기간 | 작동 방식 / 요금 (USD) | 활용 시나리오 |
|---|---|---|
| guardrails: malware (기본값) | Cloudflare Security DoH (1.1.1.2) + 피싱 도메인 차단 | 헤드리스 브라우저의 악성코드 및 피싱 사이트 접속 원천 차단 |
| guardrails: ads / adult | 광고 트래커 차단 룰셋 / Family DoH (1.1.1.3) | 웹 스크래핑 속도 향상 및 불필요한 광고 트래픽 제거 |
| guardrails: smart_split | 사설망 및 지정 대역 직접 연결, 외부 트래픽만 암호화 터널 경유 | 내부 DB 연결은 유지하면서 글로벌 AI/웹 API에 안전하게 접근 |
| 무료 체험 (rail: "trial") | $0 (90분 / 1GB 한도 · 24시간 쿨다운) | 카드 없이 US-Ohio 즉시 개통 (기존 프록시 및 클라우드 샌드박스 호환) |
| API 구독 요금 (최대 5 동시 연결) | 1개월 $2.99 · 3개월 $6.99 · 6개월 $12.99 · 12개월 $21.99 | US/JP/SG/HK 전체 리전 개방, 키당 최대 5개 환경 동시 사용 |
네. 상단 문구를 AI 에이전트에 보내거나 npx --yes github:yivpn-official/yivpn-agent-cli connect --auto-trial 을 실행하면 카드 등록 없이 90분 / 1GB US-Ohio 터널이 즉시 발급됩니다(24시간당 1회, 기존 프록시 경유 및 클라우드 환경 지원).
아니요. 표준 HTTPS API와 오픈소스 sing-box 바이너리만으로 작동하므로 별도 앱 설치나 이메일 가입이 전혀 필요 없습니다.
끊기지 않습니다. 기본 mode=proxy는 127.0.0.1:10808 로컬 포트만 열며 시스템 라우팅 테이블을 건드리지 않습니다.
네. 서명된 POST /api/v1/vpn/rotate 호출 한 번으로 새 Ed25519 공개키에 남은 기간을 즉시 이전하거나 DELETE로 폐기할 수 있습니다.
계정 없는 Hosted Checkout(Visa, Mastercard, Apple Pay, Alipay)과 HTTP 402(x402 Base USDC) 결제 프로토콜을 지원합니다.
npx --yes github:yivpn-official/yivpn-agent-cli mcp(v2.0) 실행 시 환경을 자동 감지합니다. 서버·Docker에서는 무계정으로 127.0.0.1:10808 무루트 프록시를 구동하고, YIVPN 데스크톱 앱의 로컬 MCP(127.0.0.1:38410)가 켜진 PC에서는 sing-box 라우팅 프리뷰·적용·자동 롤백 도구에 즉시 연결됩니다.
Windows, macOS, Android용 공식 YIVPN v1.0.6 클라이언트를 설치하고 원탭 연결을 경험하세요. 필요할 때 언제든 무제한 YiPro로 업그레이드할 수 있습니다.
Up to 5 simultaneous devices · All global HY2/REALITY locations · Desktop AI MCP Server
Scan with the Alipay app. This page automatically detects confirmation and reveals your activation code in seconds.
Open in Alipay App →Enter this code under "Activation Code" in YIVPN for Windows, macOS, or Android for instant passwordless sign-in—or use it anytime to recover your password:
YIVP-XXXX-XXXX-XXXX
Please copy or download your YIVP activation code before closing so you do not lose access to your membership!
Sign in passwordlessly with your YIVP activation code, or use your username/email and password.
Every account also receives a dedicated YIVP activation code. Add an email to enable 6-digit password recovery.
Receive a 6-digit verification code via email, or reset immediately using your YIVP activation code.
YIVP-••••-••••-••••