API 및 MCP 문서

결제 방법

이미 암호화폐를 보유할 필요는 없습니다 — 카드도 됩니다. EQVPS는 암호화폐를 직접 받으며(이메일만, KYC 없음), 체크아웃에서 바로 카드, Apple Pay, Google Pay로 암호화폐를 구매할 수 있습니다. 각 방법의 작동 방식은 다음과 같습니다.

계정과 청구

첫 주문 이후의 모든 것 — 프로모 코드, 갱신, 업그레이드.

AI 에이전트용 MCP

EQVPS는 Model Context Protocol(MCP) 서버를 제공하여 AI 에이전트가 요금제를 찾고, VPS를 주문하고, 선불 잔액에서 결제하고, 서버를 관리할 수 있습니다 — 자율적으로. 엔드포인트는 Streamable HTTP를 사용합니다(2026 원격 MCP 표준).

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

EQVPS 계정을 등록하고, 요금제를 보여주고, $20 암호화폐 충전 청구서를 만들고, 내가 결제를 확인하면 Ubuntu 24.04 VPS 2대를 주문하고 SSH 액세스를 알려줘.

에이전트 연결

이것을 MCP 클라이언트 설정에 추가하세요(Claude Desktop, 또는 임의의 원격 HTTP MCP 클라이언트):

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

MCP 서버 자체를 통해 register_account 또는 login을 호출하여 토큰을 받으세요. list_plans 도구는 토큰 없이 작동합니다(검색). 계정 설정 → 에이전트용 API 토큰에서도 토큰을 생성할 수 있습니다.

인증

EQVPS는 Bearer 토큰을 사용합니다 — 하지만 두 개의 별도 인증 경로가 있으며, 혼용하지 마세요. AI 에이전트: 이 API/MCP를 통해 register_account(또는 login)를 호출하세요 — 에이전트가 자체 자격 증명을 제공하고 이메일과 OTP 코드 없이 즉시 토큰을 받습니다. Authorization: Bearer <token>으로 전송하세요. eqvps.com의 사람은 비밀번호 없는 이메일 OTP 코드로 로그인합니다 — 그 브라우저 흐름은 사람 전용이며 에이전트는 사용할 수 없습니다(이메일을 읽을 수 없음). 에이전트는 register_account를 사용해야 하며 이메일 OTP 흐름은 절대 사용하지 않습니다. list_plans는 토큰이 필요 없습니다.

MCP 도구

목적별로 분류된 15개 도구. 각각은 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 엔드포인트로 뒷받침됩니다. 베이스 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>이 필요합니다.