Yapay Zeka Ajanı için VPN — Kurulum Rehberi

Ne elde edeceksiniz

X-VPN MCP, X-VPN'i kendi başına çalıştırabileceğiniz bir ağ katmanı haline getirir. Bu kılavuzun ardından, ajanınız şu yeteneklere sahip olacak:

• Mevcut bölgeleri ve protokolleri keşfedin.
• Bir istemde bahsettiğiniz ülkeye, eyalete veya şehre bağlanın.
• Bağlantı durumunu ve etkin işlemleri kontrol edin.
• İş bitince bağlantıyı kes.

X-VPN GUI uygulamasını kullanmanıza gerek yok. Her şey, http://127.0.0.1:3841/mcp adresinde yalnızca yerel bir MCP uç noktasını sunan küçük bir yerel daemon olarak çalışır.

Başlamadan önce

Desteklenen platformlar

Desteklenen Yapay Zeka Ajanları

Kurulum sihirbazı X-VPN MCP'yi bu istemcilerin herhangi birine otomatik olarak kaydedebilir. Her biri, istemcinin MCP yapılandırma dosyasına yazılarak kaydedilir:

• Claude Kodu (~/.claude.json)
• Codex (~/.codex/config.toml)
• Gemini Komut Satırı Arayüzü (~/.gemini/settings.json)
• İmleç (~/.cursor/mcp.json)
• Continue.dev (~/.continue/config.yaml)
• Rüzgar sörfü (~/.codeium/mcp_config.json)
• Antigravitasyon (~/.gemini/antigravity/mcp_config.json)

İstemciniz listede yoksa, manuel olarak şu adrese yönlendirebilirsiniz http://127.0.0.1:3841/mcp — aşağıda Manuel MCP yapılandırmasına bakınız.

İhtiyacın olacak.

• Terminale erişim.
• sudo önerilir; mevcut değilse, kurulum aracı kullanıcı kurulumuna geri döner ve bir PATH ipucu yazdırır.
• Bir X-VPN hesabı isteğe bağlıdır. Giriş yapmadan ücretsiz katmanda çalışabilirsiniz.

Adım 1 — Yükle (tek satır)

Terminalinizde aşağıdakilerden birini çalıştırın:

sh <(curl -sSf https://app.xvpncdn.com/rpc788pbdq/install.sh)

sh <(wget -qO - https://app.xvpncdn.com/rpc788pbdq/install.sh)

Kurulum programı etkileşimsizdir ve şu işlemleri yapacaktır:

1. İşletim sisteminizi ve mimarinizi tespit edin.
2. Eşleşen ikili dosyayı /tmp/ konumuna indirin.
3. İmzayı / hash'i doğrulayın.
4. Yükleyin /usr/local/bin/xvpn (veya ~/.local/bin/xvpn eğer sistem yollarına yazılamıyorsa).
5. Otomatik olarak xvpn install'ı başlatın ve sizi 2. adımda sihirbazla yönlendirin.

Kurulum aracı hata ile çıkış yaparsa, Sorun giderme › Kurulum hataları bölümüne gidin.

Adım 2 — Kurulum sihirbazını çalıştırın

Sihirbazın 7 kısa aşaması vardır. Her aşama net bir [n/m] ilerleme başlığı yazdırır.

2.1 Hoş geldiniz

Welcome to use X-VPN MCP Wizard
       Version 1.0.0_1014

  PrivacyPolicy: https://xvpn.io/policy
  Terms:        https://xvpn.io/terms-service

This wizard will:

1. Install the X-VPN daemon
2. Register X-VPN with your AI Agents
3. (Optional) Sign in
4. Verify everything works

Estimated time: ~2 minutes
Press ENTER to continue, or Ctrl-C to exit

Sihirbaz gizlilik politikasını asla otomatik olarak kabul etmez. ENTER tuşuna basarak bağlı politikaları okuduğunuzu onaylamış olursunuz.

2.2 Daemon'ı yükleyin

The wizard registers xvpn as a system daemon (e.g. via systemd on Linux or launchd on macOS) and brings it up. You should see:

[1/6] Install X-VPN Daemon
─────────────────────────────────────
  [1/3] Writing service file        OK
  [2/3] Loading service             OK
  [3/3] Verifying daemon            OK

  ✓ daemon is up.

Bu adımlardan herhangi biri başarısız olursa, sihirbaz hatalı satırı gösterecektir. En yaygın neden eksik ayrıcalıklardır — yeniden çalıştırın sudo ile.

2.3 Hangi yapay zeka ajanlarını kaydedeceğinizi seçin.

[2/5] Register X-VPN MCP
─────────────────────────────────────
  [x] Claude Code           write: ~/.claude.json
  [ ] Codex                 write: ~/.codex/config.toml
  [ ] Gemini CLI            write: ~/.gemini/settings.json
  [x] Cursor                write: ~/.cursor/mcp.json
  [ ] Continue.dev          write: ~/.continue/config.yaml
  [ ] Windsurf              write: ~/.codeium/mcp_config.json
  [ ] Antigravity           write: ~/.gemini/antigravity/mcp_config.json

[SPACE select · ENTER continue]

• Bir satırı açıp kapatır.
• onaylar.
• Eğer Hiçbir şey seçilmedi olarak onaylarsanız, sihirbaz kayıt işlemini kazara atlamamanız için size ikinci kez sorar.

2.4 Kaydı Uygula

Sihirbaz, seçili her istemcinin yapılandırma dosyasına yazar. Birleştirme davranışı hakkında bilinmesi gereken iki şey:

• Mevcut yapılandırma kademeli olarak ayrıştırılıp güncellenir. Diğer MCP sunucularınız, model ayarları ve özel komutlarınız bozulmadan kalır — sihirbaz yalnızca X-VPN girdisini ekler, tüm dosyayı yeniden yazmaktan ziyade.
• Backups never overwrite each other. Before writing, the wizard copies the current config to a .bkp sibling. If .bkp already exists from a previous run, the new copy is saved as .bkp.1, .bkp.2, and so on, so you can roll back to the state at the time of any earlier install.

[3/5] Connect X-VPN MCP
─────────────────────────────────────
Registering with Cursor...
  Copy current config file for backup...
  Write to ~/.cursor/mcp.json ...
  ✓ Added.

Beklenen konumda bir yapılandırma dosyası mevcut değilse, sihirbaz yalnızca X-VPN kaydıyla yeni bir tane oluşturur.

2.5 Kurulumu doğrulayın

Sihirbaz uçtan uca üç kontrol yürütür:

[4/5] Verifying Installation
─────────────────────────────────────
  [1/3] Daemon responding        OK
  [2/3] MCP handshake            OK
  [3/3] Tool call                OK

  ✓ All checks passed.

Her bir kontrolün yaptığı şey:

1. Daemon yanıt veriyor — yerel IPC kanalına ping atıyor.
2. MCP el sıkışması — curl http://127.0.0.1:3841/mcp MCP başlatma el sıkışmasını gerçekleştirir.
3. Araç çağrısı — bir salt okunur çağrı yapar xvpn_get_overview ve yanıtı ayrıştırır.

Eğer Araç çağrısı kontrolü başarısız olursa, sihirbaz şu seçenekleri sunar: [r]retry / [q]quit.

2.6 Giriş yap (isteğe bağlı)

[5/5] Sign In (Optional)
─────────────────────────────────────
  Without signing in, you'll use the free tier:
    • 50MB per connection
    • Connect free locations only

  > 1. Continue with free
    2. Sign in/Sign up

Giriş yapmak, tam premium deneyimini açığa çıkarır: 250+ lokasyonlar ve bağlantı başına sınırsız trafik. Giriş yapmak için şu yöntemleri kullanabilirsiniz:

1. E-posta adresi ve şifre
2. Kimlik doğrulama belirteci — bir tane şu adreste oluşturun https://xvpn.io/account/settings
3. Diğer cihazlardan doğrulama kodu — zaten başka bir yerde oturum açmışsanız

2.7 Tamamlandı

─────────────────────────────────────
  X-VPN MCP is ready. Restart your agent clients to activate
  new settings.

  Try in your Agent:
    "Use X-VPN to connect to the United States."

  Manage mcp server:    xvpn mcp-server [on|off]
  Toggle auto-split:    xvpn auto-split [on|off|list]
  Reconfigure:          xvpn install      (any time)
  Uninstall:            xvpn uninstall

  Help:    https://xvpn.io/help-center
  Report:  mailto:support@xvpn.io

Sihirbaz otomatik olarak kapanır.

Restart your agent client before continuing. Because registration happens by writing the client’s config file, a running agent (Claude Code, Cursor, Codex, etc.) won’t reload that file on its own. Quit and reopen the client now — otherwise the prompts in Step 3 will report the X-VPN tools as unavailable.

Adım 3 — İlk VPN farkında olan isteminizi deneyin

Kayıt ettiğiniz ajanı açın ve birini deneyin:

Kullan X-VPN ile Amerika Birleşik Devletleri'ne bağlan, ardından reddit.com'un ana sayfasını getir.

Tokyo üzerinden bağlanın ve web sitemizde hızlı bir hız testi yapın.

Twitter.com'daki trend konularını Almanya'nın bakış açısından çekin.

Kulislerde ajan şu şekilde bir dizi çağıracaktır:

1. xvpn_get_overview — bağlantı durumunu ve hesabı doğrular
2. xvpn_list_locations(search="united-states") — düğümü bulur
3. xvpn_connect(location="united-states") — tüneli kurar
4. xvpn_get_status — bağlı duruma ulaşana kadar bekler connected
5. (senin görevin)
6. xvpn_disconnect — yıkar

Çağrıları satır içi görmek isterseniz, çoğu ajan bir “MCP debug” veya “tools” paneline sahiptir — bunu açın.

Kurulumunuzu yönetin

Günlük kullanabileceğiniz komutlar:

Durum (oturum açma, auto-split, mcp-server) sürüm yükseltmeleri boyunca kalıcıdır.

Manuel MCP yapılandırması

İstemciniz sihirbazın listesinde değilse, onu yerel uç noktaya yönlendirin:

URL:       http://127.0.0.1:3841/mcp
Transport: HTTP (Streamable HTTP)
Auth:      none (loopback only)

Uç nokta 127.0.0.1 adresine bağlıdır ve döngüsel olmayan kaynakları reddeder, bu nedenle ek güvenlik duvarı kurallarına ihtiyaç yoktur.

Sorun giderme

Kurulum hataları

Doğrulama hataları

Ajan istemcisi kurulduktan sonra X-VPN MCP'yi görmüyor.

Sihirbaz, X-VPN'yi istemci yapılandırma dosyasına yazarak kaydeder (örn. ~/.claude.json, ~/.cursor/mcp.json). Çalışan bir istemci bu dosyayı kendi başına yeniden yüklemez. İstemciyi kapatıp yeniden açın. Sorun devam ederse, xvpn install komutunu yeniden çalıştırın ve yeniden başlatmadan önce sihirbazın çıktısında herhangi bir kayıt hatası olup olmadığını izleyin.

Birden çok MCP istemcisi

X-VPN MCP, birden çok ajan tarafından aynı anda güvenli bir şekilde kullanılabilir — IPC yazımları serileştirilir, böylece kesişen bağlantı durumları görmezsiniz. Garip bir davranış görürseniz, daemon'ı xvpn install ile yeniden başlatın.

Şimdi ne olacak?

• Skill — drop our prebuilt Skill into your Agent to teach it the recommended call patterns: https://github.com/x-vpn/xvpn-mcp-skill
• Community — questions and feedback in our Reddit and on GitHub Issues

Burada kapsanmayan herhangi bir şeyle karşılaşırsanız, support@xvpn.io adresine xvpn version çıktısını ve başarısız sihirbaz adımını içeren e-posta gönderin — her raporu okuyoruz.