مستندات API و MCP

چطور بپردازیم

لازم نیست از قبل رمزارز داشته باشید — کارت هم کار می‌کند. EQVPS مستقیم رمزارز می‌گیرد (فقط یک ایمیل، بدون KYC)، و همان‌جا هنگام پرداخت می‌توانید رمزارز را با کارت، Apple Pay یا Google Pay بخرید. اینجا نحوه کار هر روش آمده.

حساب و صورتحساب

همه‌چیز پس از اولین سفارش — کدهای تخفیف، تمدید، ارتقا.

MCP برای ایجنت‌های هوش مصنوعی

EQVPS یک سرور Model Context Protocol (MCP) ارائه می‌دهد تا ایجنت‌های هوش مصنوعی بتوانند پلن‌ها را کشف کنند، یک VPS سفارش دهند، از یک موجودی پیش‌پرداخت بپردازند و سرورها را مدیریت کنند — مستقل. نقطه پایانی با Streamable HTTP صحبت می‌کند (استاندارد MCP از راه دور در ۲۰۲۶).

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

یک حساب EQVPS ثبت کن، پلن‌ها را نشانم بده، یک فاکتور شارژ رمزارزی ۲۰ دلاری بساز، سپس به‌محض تأیید پرداخت من، ۲ عدد VPS با Ubuntu 24.04 سفارش بده و دسترسی SSH آن‌ها را به من بده.

ایجنت‌تان را وصل کنید

این را به پیکربندی کلاینت 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 به توکن نیاز ندارد.

ابزارهای MCP

۱۵ ابزار، گروه‌بندی‌شده بر اساس هدف. هرکدام به یک نقطه پایانی REST نگاشت می‌شود.

جریان نمونه

یک نشست معمول ایجنت: کشف، ثبت‌نام، تأمین مالی، سفارش، مدیریت.

// 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 پشتیبانی می‌شود که می‌توانید مستقیم صدایش بزنید. آدرس پایه: 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> نیاز دارند.