ربط خادم MCP من EQVPS بـ Claude Code وCodex CLI

وكلاء البرمجة الذين يعيشون في الطرفية بارعون في تشغيل الأوامر. ما ينقصهم عادةً هو خادم خاص بهم لتشغيلها عليه. ربطهم بخادم MCP من EQVPS يحل ذلك: يحصل الوكيل على أدوات لاستعراض الخطط، وطلب VPS، وقراءة بيانات SSH الخاصة به، وإعادة تشغيله، وتشغيل sandbox، ونحو أربعين أداة أخرى.

يغطي هذا الدليل Claude Code وCodex CLI. أما Claude Desktop وCursor وCline فراجع ربط EQVPS بعميل MCP لديك. شغّلنا كل أمر أدناه على Claude Code 2.1 وCodex CLI 0.164 قبل النشر.

عنوان الخادم واحد في كل مكان:

https://mcp.eqvps.com/mcp

يعمل بـ Streamable HTTP ويقبل bearer token في ترويسة Authorization. لا يوجد تسجيل دخول عبر OAuth بعد، لذا تضيف الرمز يدويًا.

1. احصل على رمز

إن كان لديك حساب EQVPS، أنشئ رمزًا في لوحة التحكم: Settings → API tokens. وإلا فطلب واحد ينشئ حسابًا ويعيد رمزه:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Lovelace","email":"you@example.com"}'

حقل token طويل، نحو ألف حرف. لا تُعد كتابته. ضعه في ملف لن يفتحه الوكيل مصادفةً وحمّله من هناك:

umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)

يمكنك أيضًا ترك الوكيل يسجّل بنفسه: اربطه دون رمز، واطلب منه استدعاء register_account، ثم أضف الخادم مجددًا بالرمز الذي حصل عليه.

2. Claude Code

claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
  --header "Authorization: Bearer $EQVPS_TOKEN"

افتراضيًا يُضاف الخادم للمشروع الحالي فقط. لتجده في كل المشاريع أضف -s user. تحقق من أن Claude Code يصل إليه:

claude mcp list

eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected

لا تعوّل كثيرًا على تلك العلامة الخضراء. الخطط والأسعار والتسجيل تعمل دون حساب، لذا يقبل الخادم الاتصال حتى برمز مكتوب خطأً. لا يُفحص الرمز إلا عندما يصل الوكيل إلى حسابك. الاختبار السريع أن تطلب من Claude Code «call the eqvps whoami tool»: الرمز الصالح يعيد بريدك الإلكتروني، وغير الصالح يعيد خطأ 401.

يعرض claude mcp get eqvps التفاصيل. يُطبع الرمز هناك أيضًا، فلا تلصق هذا الناتج في دردشة أو تذكرة.

أمر يجب تجنّبه: -s project يكتب الخادم في .mcp.json داخل مستودعك. ومع رمز بنص صريح في الترويسة، سينتهي هذا الملف في git. استخدم الـ scope local أو user لأي شيء يحمل بيانات اعتماد.

3. Codex CLI

يستطيع Codex قراءة الرمز من متغير بيئة، فيبقى خارج ملف الإعدادات تمامًا:

codex mcp add eqvps --url https://mcp.eqvps.com/mcp --bearer-token-env-var EQVPS_TOKEN
codex mcp list

Name   Url                        Bearer Token Env Var  Status   Auth
eqvps  https://mcp.eqvps.com/mcp  EQVPS_TOKEN           enabled  Bearer token

يكتب ذلك ثلاثة أسطر في ~/.codex/config.toml:

[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"

الفخ: codex mcp list يعرض الإعدادات المحفوظة فقط ولا يتصل. يحدث الاتصال عند بدء الجلسة، وفقط إذا كان EQVPS_TOKEN مضبوطًا في ذلك الـ shell. وإلا يتخطى Codex الخادم بصمت، ولا يملك الوكيل ببساطة أدوات EQVPS. أضف سطر export إلى ملف تعريف الـ shell، أو شغّل Codex هكذا: EQVPS_TOKEN=$(cat ~/.eqvps_token) codex.

4. ما تطلبه أولًا

ابدأ بشيء يقرأ فقط لترى أن الأدوات تعمل:

Call the eqvps whoami tool and tell me which account I'm signed in as.

List the EQVPS plans with a dedicated IPv4 and their monthly prices.

Show my EQVPS balance and my servers.

ثم شيء حقيقي:

Order the cheapest EQVPS plan with Ubuntu 24.04, use my key from ~/.ssh/id_ed25519.pub, wait until it's active and give me the SSH command.

إذا كان الرصيد يغطي الخطة، يُدفع الطلب فورًا ويكون الخادم جاهزًا عادةً خلال دقيقة تقريبًا. وإلا يحصل الوكيل على فاتورة غير مدفوعة ورابط topup_balance تدفعه بـ USDT أو USDC أو ETH على شبكة Base أو Ethereum أو Polygon. بعد الشحن، اطلب منه تكرار الطلب نفسه (سيلتقط الطلب غير المدفوع ويدفعه من الرصيد بدل إنشاء طلب ثانٍ)، أو استدعاء pay_invoice الذي يدفع تلك الفاتورة من الرصيد.

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

عندما لا يتصل

التالي: ما الذي يستطيع الوكيل فعله بالخادم بعد وجوده — كيف يدير وكيل ذكاء اصطناعي الـ VPS الخاص به عبر MCP. أو إن كان يحتاج فقط إلى تشغيل كود لدقيقة، فـ sandbox أرخص من VPS. القائمة الكاملة للأدوات في توثيق MCP.