وثائق API و MCP

استأجر وأدر VPS برمجيًا — عبر REST API أو MCP لوكلاء الذكاء الاصطناعي.

كيفية الدفع

لا تحتاج إلى امتلاك عملات مشفّرة مسبقًا — البطاقة تعمل أيضًا. يقبل EQVPS العملات المشفّرة مباشرة (بريد إلكتروني فقط، بدون KYC)، وعند الدفع يمكنك شراء العملات بالبطاقة أو Apple Pay أو Google Pay. إليك كيف تعمل كل طريقة.

ادفع بالعملات المشفّرة مباشرة

أنشئ طلبك للوصول إلى صفحة الدفع. سترى المبلغ المستحق وعنوان إيداع مع رمز QR. من محفظتك أو منصتك، أرسل ذلك المبلغ من USDC أو USDT على Base أو Ethereum أو Polygon إلى العنوان. بمجرد تأكيد الشبكة للتحويل، يُجهَّز خادمك تلقائيًا — عادةً خلال دقيقتين. دون تسجيل لدى أي طرف ثالث.

اربط محفظة

عند الدفع اختر «اربط المحفظة» واختر محفظتك — MetaMask أو Phantom أو Rainbow أو Base Account أو أي محفظة متوافقة مع WalletConnect. وافق على الدفع في نافذة المحفظة ويكتمل الطلب.

اشترِ العملات أولًا (قد يلزم تسجيل لدى مزوّد)

طريقتان. ادفع مباشرة بـ USDC أو USDT على Base أو Ethereum — سريع، دون بطاقة. أو ادفع بالبطاقة أو Apple Pay أو Google Pay أو التحويل البنكي عند الدفع — ونحوّله إلى عملات مشفّرة نيابة عنك. للبطاقة حد أدنى للمزوّد (~30$)؛ أي فائض عن طلبك يُضاف إلى رصيدك.

الشبكات والرسوم

ندعم USDC وUSDT على Base وEthereum. عادةً ما تكون Base الأرخص والأسرع. تفرض البلوكتشين رسوم شبكة صغيرة (gas) فوق دفعتك. إذا اشتريت عبر منصة، أرسل أكثر قليلًا من المبلغ الدقيق ليصل الإيداع كاملًا بعد رسوم سحب المنصة.

الحساب والفوترة

كل شيء بعد الطلب الأول — الرموز الترويجية، التجديد، الترقية.

الرموز الترويجية

لديك رمز (مثل TG50 أو X50 من قنواتنا)؟ في صفحة الطلب، اكتبه في حقل الرمز الترويجي قبل إنشاء الطلب. الرموز الصالحة تخصم 50% من شهرك الأول؛ التجديدات تُحسب بالسعر العادي، ورمز واحد لكل حساب.

جدّد خادمك

افتح خادمك في لوحة التحكم واستخدم «تجديد». اختر 1 أو 3 أو 6 أشهر، أو سنة بخصم — لا تتغير خطتك وبياناتك، فقط يتحرك تاريخ الانتهاء. ادفع من رصيد حسابك إن كان يغطّيه، أو بالعملات المشفّرة؛ يُطبَّق التجديد بمجرد تأكيد الدفع.

الترقية والإضافات

من صفحة الخادم يمكنك الانتقال إلى خطة أكبر أو إضافة IP مخصّص، وتبديل إضافات مثل النسخ الاحتياطي المُدار. تُحسب الترقيات تناسبيًا من رصيدك؛ أي شيء يتطلب إعادة تشغيل يطلب تأكيدك أولًا.

MCP لوكلاء الذكاء الاصطناعي

يوفّر EQVPS خادم Model Context Protocol (MCP) حتى يكتشف وكلاء الذكاء الاصطناعي الخطط ويطلبوا VPS ويدفعوا من رصيد مدفوع مسبقًا ويديروا الخوادم — ذاتيًا. تتحدث النقطة الطرفية Streamable HTTP (معيار MCP البعيد لعام 2026).

بداية سريعة — اتصل بأمر واحد

الخطوة 1 — أضف الخادم (Claude Code، أمر واحد):

claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp

الخطوة 2 — أخبر وكيلك بلغة بسيطة (انسخ والصق):

سجّل حساب EQVPS، اعرض لي الخطط، أنشئ فاتورة شحن مشفّرة بقيمة 20$، ثم بمجرد تأكيدي للدفع، اطلب خادمي VPS بنظام Ubuntu 24.04 وأعطني وصول SSH إليهما.

⚠️ يفعل الوكيل كل شيء عبر الأدوات باستثناء التمويل: يرسل شخص العملات المشفّرة إلى فاتورة الشحن مرة واحدة. بعد تمويل الرصيد، يطلب الوكيل VPS ذاتيًا بالكامل (يدفع من الرصيد).

♻️ عمليات الشراء المتكررة برصيد ممول لا تتطلب تدخلًا — فقط اطلب من الوكيل.

⏳ يحتاج VM المطلوب حديثًا أو المُعاد تعيينه ~1-2 دقيقة للإقلاع. يبدأ Ubuntu 24.04 خدمة sshd عند أول اتصال (تفعيل بالمقبس)، لذا قد تُظهر محاولة SSH الفورية «connection refused» مؤقتًا رغم نجاح التجهيز — فقط انتظر دقيقة وأعد المحاولة. لا تُعِد التعيين أو التثبيت لأن SSH ليس فوريًا.

🔧 عملاء MCP العامون / OpenClaw / غيرهم: استخدم كتلة إعدادات JSON أدناه.

اربط وكيلك

أضف هذا إلى إعدادات عميل MCP لديك (Claude Desktop أو أي عميل MCP عبر HTTP بعيد):

{
  "mcpServers": {
    "eqvps": {
      "type": "streamable-http",
      "url": "https://mcp.eqvps.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

احصل على رمز باستدعاء register_account أو login عبر خادم MCP نفسه. أداة list_plans تعمل دون رمز (اكتشاف). يمكنك أيضًا إنشاء رمز في إعدادات حسابك ← رموز API للوكلاء.

المصادقة

يستخدم EQVPS رموز Bearer — لكن هناك مساران منفصلان للمصادقة، لا تخلط بينهما. وكلاء الذكاء الاصطناعي: استدعِ register_account (أو login) عبر هذه الـ API/MCP — يقدّم الوكيل بيانات اعتماده ويحصل على رمز فورًا، دون بريد إلكتروني ودون رمز OTP. أرسله كـ Authorization: Bearer <token>. البشر على eqvps.com يسجّلون الدخول برمز OTP بريدي دون كلمة مرور — ذلك التدفق في المتصفح للبشر فقط ولا يمكن لوكيل استخدامه (لا يستطيع قراءة البريد). على الوكيل استخدام register_account، لا تدفق البريد-OTP أبدًا. list_plans لا يحتاج رمزًا.

لا عملات مشفّرة لوكيلك؟ يمكن لشخص شحن رصيد الحساب بالعملات المشفّرة مرة واحدة — ثم ينفق الوكيل من ذلك الرصيد عبر الـ API دون امتلاك عملات مشفّرة بنفسه.

أدوات MCP

15 أداة، مجمّعة حسب الغرض. كل واحدة ترتبط بنقطة طرفية REST.

الاكتشاف

list_plansList available VPS plans with specs, pricing, and supported OS.

الحساب

register_accountCreate an account, returns an API token.

loginLog in, returns an API token.

whoamiCurrent account info.

الرصيد

get_balanceCurrent prepaid balance.

topup_balanceTop up balance with crypto; returns a checkout URL.

الطلب

order_vpsOrder a VPS. Paid from balance if sufficient, else returns a crypto checkout URL.

pay_invoiceGet a crypto checkout URL for an unpaid invoice.

الإدارة

list_vpsList your VPS with status.

get_vps_statusVPS details: status, specs, SSH access. Poll after ordering.

power_vpsStart, stop, or reboot.

set_hostnameChange hostname.

reset_passwordReset root password (returned once via get_vps_status + email).

reinstall_vpsReinstall OS — erases all data; vm stays.

get_vps_metricsCPU, memory, network, disk over time.

تدفق مثالي

جلسة وكيل نموذجية: اكتشاف، تسجيل، تمويل، طلب، إدارة.

// 1. Discover plans (no auth)
list_plans()
// 2. Create an account → get token
register_account({ name, email, password }) → { token }
// 3. (human or agent) fund the balance with crypto
topup_balance({ amount: 25 }) → { checkout_url }   // pay the URL
// 4. Order a VPS — paid from balance, provisioning starts
order_vps({ product: "micro", os_id: 1, ssh_key })
   → { paid_from_balance: true, service_id }
// 5. Poll until ready, then read SSH access
get_vps_status({ id: service_id }) → { status: "active", access: { command } }

REST API

كل أداة MCP مدعومة بنقطة طرفية REST يمكنك استدعاؤها مباشرة. عنوان URL الأساسي: https://api.eqvps.com

GET  /api/v1/eqvps/products
POST /api/v1/eqvps/auth/register
POST /api/v1/eqvps/auth/login
POST /api/v1/eqvps/auth/otp/request
POST /api/v1/eqvps/auth/otp/verify
POST /api/v1/eqvps/auth/set-password
GET  /api/v1/eqvps/balance
POST /api/v1/eqvps/balance/topup
POST /api/v1/eqvps/orders
POST /api/v1/eqvps/invoices/{id}/pay
GET  /api/v1/eqvps/services
GET  /api/v1/eqvps/services/{id}
POST /api/v1/eqvps/services/{id}/power
POST /api/v1/eqvps/services/{id}/hostname
POST /api/v1/eqvps/services/{id}/reset-password
POST /api/v1/eqvps/services/{id}/reinstall
GET  /api/v1/eqvps/services/{id}/metrics

النقاط الطرفية المُصادَق عليها تتطلب Authorization: Bearer <token>.

عرض الخطط ابدأ الآن