VPN لوكيل الذكاء الاصطناعي — دليل الإعداد

ما ستحصل عليه

يحوّل X-VPN MCP X-VPN إلى طبقة الشبكة التي يمكن لوكيلك القائم على الذكاء الاصطناعي قيادتها بمفردها. بعد هذا الدليل، سيكون وكيلك قادرًا على:

• اكتشف المناطق المتاحة والبروتوكولات
• اتصل بدولة أو ولاية أو مدينة تذكرها في الطلب
• تحقق من حالة الاتصال والعمليات النشطة
• افصل عند انتهاء المهمة

لا تحتاج إلى استخدام تطبيق واجهة المستخدم الرسومية لـ X-VPN. يعمل كل شيء كخادم دايمون محلي صغير يعرّض نقطة نهاية MCP محلية فقط عند http://127.0.0.1:3841/mcp.

قبل أن تبدأ

المنصات المدعومة

وكلاء الذكاء الاصطناعي المدعومون

يمكن لمعالج الإعداد تسجيل X-VPN MCP تلقائياً في أي من هؤلاء العملاء. يتم تسجيل كل منها عن طريق الكتابة في ملف إعداد MCP الخاص بالعميل:

• كلود كود (~/.claude.json)
• كودكس (~/.codex/config.toml)
• Gemini واجهة سطر الأوامر (~/.gemini/settings.json)
• المؤشر (~/.cursor/mcp.json)
• Continue.dev (~/.continue/config.yaml)
• ويندسرف (~/.codeium/mcp_config.json)
• الجاذبية المضادة (~/.gemini/antigravity/mcp_config.json)

إذا لم يكن عميلك مدرجًا، فلا يزال بإمكانك توجيهه يدوياً إلى http://127.0.0.1:3841/mcp — راجع إعداد MCP اليدوي أدناه.

ستحتاج

• الوصول إلى الطرفية.
• يوصى باستخدام sudo؛ إذا لم يتوفر، يعود المُثبت إلى التثبيت على مستوى المستخدم ويعرض تلميح PATH.
• حساب X-VPN اختياري. يمكنك العمل ضمن الخطة المجانية دون تسجيل الدخول.

الخطوة 1 — التثبيت (سطر واحد)

Run one of the following in your terminal:

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

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

المثبت غير تفاعلي وسيقوم بـ:

1. اكتشف نظام التشغيل وبنيته.
2. قم بتنزيل الملف الثنائي المطابق إلى /tmp/.
3. تحقق من التوقيع / التجزئة.
4. ثبت في /usr/local/bin/xvpn (أو ~/.local/bin/xvpn إذا لم يستطع الكتابة إلى مسارات النظام).
5. تشغيل تلقائي لـ xvpn install وسيتم إحالتك إلى معالج الإعداد في الخطوة 2.

إذا خرج المُثبت بخطأ، انتقل إلى استكشاف الأخطاء › أخطاء التثبيت.

الخطوة 2 — تشغيل معالج الإعداد

لدى الساحر 7 مراحل قصيرة. كل مرحلة تعرض عنوان تقدم واضحاً [n/m].

2.1 مرحبا

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

المعالج لا يقبل تلقائيًا سياسة الخصوصية. بالضغط على ENTER، تؤكّد أنك قد قرأت السياسات المرتبطة.

2.2 قم بتثبيت الدايمون

يسجّل الساحر xvpn كخادم النظام (على سبيل المثال عبر systemd على لينكس أو launchd على macOS) ويشغّله. يجب أن ترى:

[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.

إذا فشلت أي من تلك الخطوات، سيظهر المعالج السطر الفاشل. السبب الأكثر شيوعاً هو نقص الامتيازات — أعد المحاولة باستخدام sudo.

2.3 اختر أي من وكلاء الذكاء الاصطناعي لتسجيلهم

[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]

• يبدل صفاً.
• يؤكد.
• إذا أكدت بأن لا شيء مُختار، سيطلب المعالج منك مرة ثانية حتى لا تفوّت التسجيل عن طريق الخطأ.

2.4 تطبيق التسجيل

يكتب المعالج في ملف الإعدادات الخاص بكل عميل محدد. شيئان يجب معرفتهما حول سلوك الدمج:

• يتم تحليل التكوين الحالي وتعديله تدريجيًا. وتظل باقي خوادم MCP لديك، وإعدادات النموذج، والأوامر المخصصة كما هي — يضيف المرشد فقط إدخال X-VPN بدلاً من إعادة كتابة الملف بالكامل.
• النسخ الاحتياطية لا تستبدل بعضها البعض. قبل الكتابة، يقوم المرشد بنسخ الإعدادات الحالية إلى الملف .bkp الشقيق. إذا كان .bkp موجوداً بالفعل من تشغيل سابق، يتم حفظ النسخة الجديدة كـ .bkp.1، .bkp.2، وهكذا، حتى تتمكن من الرجوع إلى الحالة عند وقت أي تثبيت سابق.

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

إذا لم يوجد ملف إعداد في المسار المتوقع، يقوم المعالج بإنشاء واحد جديد يحتوي فقط على تسجيل X-VPN.

2.5 تحقق من التثبيت

المعالج يقوم بثلاث فحوصات من الطرف إلى الطرف:

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

  ✓ All checks passed.

ما الذي يفعله كل فحص:

1. الدايمون يستجيب — يرسل نبضة إلى قناة IPC المحلية.
2. مصافحة MCP — curl http://127.0.0.1:3841/mcp يقوم curl بإجراء المصافحة الأولية لـ MCP.
3. استدعاء الأداة — يصدر استدعاءاً واحداً للقراءة فقط إلى xvpn_get_overview ويحلل الاستجابة.

إذا فشل فحص استدعاء الأداة، يعرض المعالج خيار [r]retry / [q]quit.

2.6 تسجيل الدخول (اختياري)

[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

تسجيل الدخول يتيح لك تجربة مميزة كاملة: 250+ المواقع ومرور غير محدود لكل اتصال. يمكنك تسجيل الدخول عبر:

1. عنوان البريد الإلكتروني وكلمة المرور
2. رمز الاعتماد — أنشئ واحداً في https://xvpn.io/account/settings
3. رمز الدخول من أجهزة أخرى — إذا كنت قد سجلت الدخول بالفعل في مكان آخر

2.7 تم

─────────────────────────────────────
  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

المعالج يغلق تلقائيًا.

أعد تشغيل عميل الوكيل الخاص بك قبل المتابعة. نظرًا لأن التسجيل يتم عن طريق كتابة ملف إعدادات العميل، فإن وكيلًا قيد التشغيل (Claude Code، Cursor، Codex، إلخ) لن يعيد تحميل هذا الملف بمفرده. أغلق العميل ثم أعد فتحه الآن — وإلا ستظهر المطالبات في الخطوة 3 بأن أدوات X-VPN غير متاحة.

الخطوة 3 — جرّب أول موجه يعتمد على VPN

افتح الوكيل الذي قمت بتسجيله وجرب واحداً من:

استخدم X-VPN للاتصال بالولايات المتحدة، ثم احصل على الصفحة الرئيسية لـ reddit.com.

اتصل عبر طوكيو وقم بإجراء فحص سرعة سريع على موقعنا.

اعرض المواضيع الرائجة على twitter.com من وجهة نظر ألمانيا.

في الكواليس، سيستدعي الوكيل تسلسلاً مثل:

1. xvpn_get_overview — يؤكد حالة الاتصال والحساب
2. xvpn_list_locations(search="united-states") — يعثر على العقدة
3. xvpn_connect(location="united-states") — ينشئ النفق
4. xvpn_get_status — ينتظر connected
5. (مهمتك)
6. xvpn_disconnect — يفكّ

إذا رغبت في رؤية المكالمات بشكل مدمج، فمعظم الوكلاء لديهم لوحة “تصحيح MCP” أو “الأدوات” — فعّلها.

إدارة تثبيتك

الأوامر اليومية التي قد تحتاجها:

الحالة (تسجيل الدخول، auto-split، mcp-server) هي مستمرة عبر ترقيات الإصدارات.

إعداد MCP يدوي

إذا لم يكن عميلك ضمن قائمة المعالج، وجهه إلى نقطة النهاية المحلية:

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

النقطة النهاية مربوطة بـ 127.0.0.1 وترفض الأصول غير العائدة إلى الحلقة نفسها، لذلك لا حاجة لأي قواعد جدار حماية إضافية.

استكشاف الأخطاء وإصلاحها

أخطاء التثبيت

أخطاء التحقق

لا يرى عميل الوكيل X-VPN MCP بعد التثبيت

يقوم المُرشِد بتسجيل X-VPN عن طريق الكتابة في ملف إعدادات العميل (مثلاً ~/.claude.json, ~/.cursor/mcp.json). لا يعيد العميل الجاري تحميل هذا الملف تلقائياً. اخرج من العميل ثم أعد فتحه. إذا استمرت المشكلة، أعد تشغيل xvpn install وتابع وجود أي أخطاء تسجيل في إخراج المُرشِد قبل إعادة التشغيل مرة أخرى.

عدة عملاء MCP

X-VPN MCP آمن للاستخدام من عدة وكلاء في وقت واحد — تُسلسَل عمليات كتابة IPC حتى لا ترى حالات اتصال متقاطعة. إذا واجهت سلوكاً غريباً، أعد تشغيل الدايمون باستخدام xvpn install.

ما التالي؟

• Skill — drop our prebuilt Skill into your Agent to teach it the recommended call patterns: https://github.com/x-vpn/xvpn-mcp-skill
• المجتمع — أسئلة وملاحظات في Reddit الخاص بنا وعلى GitHub Issues

إذا صادفت شيئاً غير مذكور هنا، أرسل بريدًا إلكترونيًا إلى support@xvpn.io مع إخراج الأمر xvpn version وخطوة المعالج الفاشلة — نحن نقرأ كل التقارير.