EQVPS MCP 서버(버전 1.6.0)에는 고객 토큰용 도구가 45개 있습니다. 이 페이지는 그중 VPS를 빌리고 운영하는 21개를 다룹니다. 각 파라미터의 타입과 기본값을 설명하고, 마지막에 복사해 쓸 수 있는 호출 순서를 담았습니다. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). 처음이라면 연결 가이드부터 보세요.
마지막 확인: 2026-10-04, MCP 서버 1.6.0 (tools/list).
어떤 페이지가 필요하신가요? VPS 호출 파라미터는 이 페이지에 있습니다. 위임, 지원, 샌드박스, 리셀러 도구 30개를 포함한 전체 도구 목록은 전체 목록에 있습니다. 유출된 토큰으로 무엇을 할 수 있는지, 에이전트를 어떻게 제한하는지는 MCP guardrails에서 설명합니다.
인증. list_plans, register_account, login은 공개입니다. 나머지는 모두 Authorization: Bearer <token>이 필요합니다. 같은 MCP 세션 안에서는 register_account나 login 뒤에 토큰이 기억됩니다.
**service_id**는 order_vps나 list_vps에서 받은 서비스 코드로, 예를 들면 68J67T5입니다. 숫자 id도 됩니다.
계정과 토큰
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | 요금제별 가격, 사양, 부팅할 수 있는 OS 이미지. plans[]에 월간·연간 plan_id가 있습니다. 가장 먼저 호출하세요. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, 기본값 365) | 비밀번호 없는 계정을 만들고, 다시 쓸 수 있는 Bearer token과 token_expires_at를 돌려줍니다. 한 번만 호출하세요. 두 번째 호출은 빈 계정을 하나 더 만듭니다. |
login | public | email, password, token_ttl_days? | 새 토큰을 돌려줍니다. set_password 이후에만 동작합니다. |
refresh_token | Bearer | expires_in_days? (1–1825) | 새 토큰을 발급하고 현재 토큰을 즉시 폐기합니다. 만료된 토큰은 갱신할 수 없습니다. |
set_password | Bearer | password (8자 이상, 영문과 숫자) | 토큰을 잃어버렸을 때를 대비해 이메일과 비밀번호로 하는 login을 켭니다. 한 번만 됩니다. 두 번째 호출은 409를 돌려줍니다. |
whoami | Bearer | — | 계정 id, 이름, 이메일. 토큰 확인용입니다. |
잔액과 주문
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | 선불 잔액과 통화. order_vps가 여기서 결제합니다. |
topup_balance | Bearer | amount (USD) | 암호화폐 충전을 만들고 checkout_url을 돌려줍니다. 결제가 온체인에서 확인되면 잔액에 반영됩니다. 미결제 충전은 한 번에 하나만 가능합니다. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi) | VPS를 주문하고 잔액이 충분하면 잔액에서 결제하며, 부족하면 청구서를 돌려줍니다. location을 빼면 저희가 고릅니다. 여유 용량이 없는 위치는 409 location_unavailable과 available 목록을 돌려주며 요금은 청구되지 않습니다. Windows 요금제는 ssh_key를 무시합니다. |
pay_invoice | Bearer | invoice_id | 미결제 청구서의 checkout_url을 돌려줍니다. 결제가 끝나면 VPS가 생성됩니다. |
VPS 운영
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | 활성, 생성 중, 정지된 서비스. 삭제된 서비스는 나오지 않습니다. |
get_vps_status | Bearer | service_id, reveal? | 상태, 사양, 실시간 상태와 접속 정보: 호스트, 포트, 바로 쓸 수 있는 command(Linux는 SSH, Windows는 RDP). reveal: true는 부팅 후 일회용 root 비밀번호를 돌려줍니다. password_pending: true면 30–60초 뒤에 다시 호출하세요. |
power_vps | Bearer | service_id, action (start | stop | reboot) | 전원 제어. |
set_hostname | Bearer | service_id, hostname | 실행 중인 서버 안에서 게스트 에이전트를 통해 적용됩니다. Windows는 재부팅 후에 적용됩니다(reboot_required: true). 서버가 꺼져 있으면 409 agent_unavailable을 돌려줍니다. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, 기본값 hour) | CPU, 메모리, 네트워크, 디스크 시계열. |
요금제 변경과 해지
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | 이 VPS가 데이터를 유지한 채 옮겨 갈 수 있는 요금제: 더 큰 요금제, NAT에서 전용 IPv4로, 또는 전용에서 NAT로. 각 옵션에 prorated_topup과 mode가 표시됩니다. 디스크는 줄일 수 없습니다. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | 약 1분짜리 재부팅 한 번으로 요금제를 그 자리에서 바꿉니다. 일할 계산된 차액은 잔액에서 빠지며(부족하면 402), NAT로 바꾸면 차액을 돌려받습니다. |
cancel_service | Bearer | service_id, reason (3–500자, 필수), type? (end_of_period | immediate), confirm? | 기본값은 end_of_period: 결제한 기간이 끝날 때까지 서버가 돌아가고 갱신되지 않습니다. immediate는 서버를 즉시 삭제하며, 정확한 hostname을 넣은 confirm이 필요하고, 쓰지 않은 기간은 잔액으로 환불됩니다(refund_amount). |
undo_cancel | Bearer | service_id | 예약된 end_of_period 해지를 취소합니다. 즉시 해지는 되돌릴 수 없습니다. |
파괴적 작업: confirm 필요
confirm에는 get_vps_status의 정확한 hostname 또는 DELETE를 넣습니다. 호출하기 전에 사람에게 확인하세요.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | 새 root 비밀번호가 10–30초 안에 실행 중인 서버에 적용되고 이전 비밀번호는 더 이상 동작하지 않습니다. 새 비밀번호는 get_vps_status(reveal: true)로 한 번만 읽습니다. 비밀번호를 잃어버렸을 때만 쓰고, 아직 부팅 중인 서버에는 쓰지 마세요. |
reinstall_vps | Bearer | service_id, os_id, confirm | 디스크를 지우고 os_id를 설치합니다. 모든 데이터가 사라집니다. 백그라운드에서 실행되니 get_vps_status를 폴링하세요. |
예시: 처음부터 실행 중인 서버까지
list_plans() // pick a product slug and an os_id
register_account({ first_name: "Ada", last_name: "Agent", email: "you@yourdomain.com" }) // returns a token
topup_balance({ amount: 10 }) // pay the checkout_url in crypto
order_vps({ product: "nano", os_id: <os_id>, ssh_key: "ssh-ed25519 AAAA..." }) // returns a service_id
get_vps_status({ service_id: "<service_id>" }) // poll until active, then read access.command
power_vps({ service_id: "<service_id>", action: "reboot" })
cancel_service({ service_id: "<service_id>", reason: "project finished" }) // end_of_period; undo_cancel keeps it
에이전트를 위한 메모
- 공개 도구 세 개를 뺀 모든 호출에
Authorization: Bearer <token>을 보내세요. 일반 HTTP를 쓸 때는 토큰을 파일에 저장하세요. 셸 변수는 따로 실행한 명령 사이에 유지되지 않습니다. - 포트를 추측하지 말고 접속 정보는
get_vps_status에서 읽으세요. NAT 요금제는 개인 포트를 쓰고, 전용 IPv4 요금제는 Linux가 22, Windows가 3389입니다. - 새 서버는 부팅에 1분쯤 걸립니다.
get_vps_status폴링을 계속하고, SSH가 바로 응답하지 않는다고reset_password를 호출하지 마세요. topup_balance와pay_invoice는 결제 링크를 돌려주며, 결제는 사람이나 지갑이 해야 합니다. Monero는 대시보드에서 따로 하는 수동 충전입니다: Monero로 결제하기를 참고하세요.
MCP 없이 같은 작업을 하려면 REST API 문서를 보세요.
댓글
아직 댓글이 없습니다. 첫 번째가 되세요.