EQVPS
ダッシュボード始める

VPS 向け EQVPS MCP ツール:パラメータと呼び出し例

2026年6月10日 · 3 分で読める · EQVPS

EQVPS の MCP サーバー(バージョン 1.9.1)には、顧客トークン向けに 47 のツールがあります。このページでは VPS を借りて運用する 23 ツールについて、各パラメータとその型・デフォルト値を説明し、最後にコピーして使える呼び出し手順を載せています。Endpoint:https://mcp.eqvps.com/mcp(Streamable HTTP)。初めての方は接続ガイドから始めてください。

最終確認:2026-10-20、MCP サーバー 1.9.1(tools/list)。

どのページが必要ですか? VPS 呼び出しのパラメータはこのページです。委任、サポート、サンドボックス、30 のリセラーツールを含む全ツールの一覧は完全なリストにあります。漏えいしたトークンで何ができるか、エージェントをどう制限するかは MCP guardrails で説明しています。

認証。 list_plans、get_order_limits、register_account、login は公開です。それ以外はすべて Authorization: Bearer <token> が必要です。同じ MCP セッション内では、register_account または login の後にトークンが記憶されます。

service_id は order_vps や list_vps から得られるサービスコードで、例は 68J67T5 です。数値の id も使えます。

アカウントとトークン

ツール認証パラメーター内容
list_planspublic—各プランの料金、スペック、起動できる OS イメージ。plans[] に月額と年額の plan_id が入っています。最初に呼び出します。
register_accountpublicfirst_name, last_name, email, token_ttl_days? (1–1825, デフォルト 365)パスワードなしのアカウントを作成し、再利用できる Bearer token と token_expires_at を返します。呼び出しは一度だけ。二度目は空のアカウントがもう一つできます。
loginpublicemail, password, token_ttl_days?新しいトークンを返します。set_password の後でのみ使えます。
refresh_tokenBearerexpires_in_days? (1–1825)新しいトークンを発行し、現在のトークンを即座に無効にします。期限切れのトークンは更新できません。
set_passwordBearerpassword (8 文字以上、英字と数字)トークンを失くしたときの予備として、メールとパスワードによる login を有効にします。一度だけ。二度目の呼び出しは 409 を返します。
whoamiBearer—アカウントの id、名前、メール。トークンの確認に使います。

残高と注文

ツール認証パラメーター内容
get_balanceBearer—前払い残高と通貨。order_vps はここから支払います。
topup_balanceBeareramount (USD)暗号資産によるチャージを作成し、checkout_url を返します。支払いがオンチェーンで確認されると残高に反映されます。未払いのチャージは同時に一つまで。
order_vpsBearerproduct, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key?VPS を注文し、残高が足りれば残高から支払います。足りなければ請求書を返します。location を省略するとこちらで選びます。Windows プランは ssh_key を無視します。quantity を 2〜50 にすると請求書1通でその台数の個別サーバーになります。再試行時は同じ idempotency_key を送ってください。
get_order_limitspublicproduct, period?, plan_id?, location?, addons?1注文あたりの上限(max_quantity = 50、入力ミス防止)と利用できる追加サービス、価格。
pay_invoiceBearerinvoice_id未払いの請求書の checkout_url を返します。支払いが済むと VPS が作成されます。

VPS の運用

ツール認証パラメーター内容
list_vpsBearer—稼働中、作成中、停止中のサービス。削除済みのものは表示されません。
get_vps_statusBearerservice_id状態、スペック、現在の稼働状況とアクセス情報:ホスト、ポート、すぐ使える command(Linux は SSH、Windows は RDP)。reveal_password は起動後に一回限りの root パスワードを返します。password_pending: true なら 30〜60 秒後に再度呼び出してください。
reveal_passwordBearerservice_idSSH 鍵なしの VPS の root パスワード。表示は一度だけ。起動中は password_pending: true なので、30〜60 秒後にもう一度呼び出します。
power_vpsBearerservice_id, action (start | stop | reboot)電源操作。
set_hostnameBearerservice_id, hostname稼働中のサーバー内でゲストエージェントを通じて反映されます。Windows では再起動後に有効になります(reboot_required: true)。サーバーが停止していると 409 agent_unavailable を返します。
get_vps_metricsBearerservice_id, timeframe? (hour | day | week | month, デフォルト hour)CPU、メモリ、ネットワーク、ディスクの時系列。

プラン変更と解約

ツール認証パラメーター内容
get_upgrade_optionsBearerservice_idこの VPS がデータを保ったまま移れるプラン:より大きいプラン、NAT から専用 IPv4、専用から NAT。各オプションに prorated_topup、mode、capacity_now があります。ディスクは縮小できません。
change_planBearerservice_id, target_plan (product_id), confirm: trueその場でプランを変更し、約1分の再起動が1回あります。日割りの差額は残高から引かれます(不足時は 402)。
cancel_serviceBearerservice_id, reason (3〜500 文字、必須), type? (end_of_period | immediate), confirm?デフォルトは end_of_period:支払い済み期間の終わりまで稼働し、更新されません。immediate はサーバーを即座に破棄し、正確な hostname を入れた confirm が必要で。レスポンスには refund_amount フィールドが含まれます。
undo_cancelBearerservice_id予定済みの end_of_period 解約を取り消します。即時解約は取り消せません。

破壊的操作:confirm が必要

confirm には get_vps_status の正確な hostname か DELETE を指定します。呼び出す前に人間に確認してください。

ツール認証パラメーター内容
reset_passwordBearerservice_id, confirm新しい root パスワードは 10〜30 秒で稼働中のサーバーに反映され、古いパスワードは使えなくなります。新しいパスワードは reveal_passwordで一度だけ読み取ります。パスワードを失くしたとき用で、起動中のサーバーには使いません。
reinstall_vpsBearerservice_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

エージェント向けのメモ

  • 公開の 3 つを除くすべての呼び出しで 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 ドキュメントを参照してください。

FAQ

これらのツールはどう呼び出しますか?

MCP クライアントを https://mcp.eqvps.com/mcp(Streamable HTTP)に接続し、表のパラメータを付けてツール名で呼び出します。Claude Desktop、Cursor などの設定は接続ガイドにあります。

トークンなしで使えるツールは?

list_plans、register_account、login です。このページのほかのツールはすべて Authorization: Bearer <token> が必要です。register_account が返すトークンはデフォルトで 365 日有効です。

service_id とは何ですか?

order_vps と list_vps が返すサービスコードで、例は 68J67T5 です。数値の id も受け付けます。

エージェントは root パスワードをどう取得しますか?

サーバーの起動後に reveal_password を呼び出します。パスワードは一度だけ表示されます。応答に password_pending: true とあればまだ起動中なので、30〜60 秒後に再度呼び出してください。注文時に ssh_key を渡した場合は鍵でログインします。

取り消せない呼び出しはどれですか?

reinstall_vps と type が immediate の cancel_service はすべてのデータを消去し、reset_password は古いパスワードを置き換えます。どれも confirm に正確な hostname が必要で、reinstall と reset は DELETE も受け付けます。呼び出す前に人間に確認してください。

コメント

まだコメントはありません。最初になりましょう。

コメントを残す

コメントは表示される前にモデレートされます。