−25%

Windows 年払い、10月31日まで。 プランを見る

EQVPS
始める

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

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

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 も使えます。

アカウントとトークン

ToolAuthParametersWhat it does
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、名前、メール。トークンの確認に使います。

残高と注文

ToolAuthParametersWhat it does
get_balanceBearer—前払い残高と通貨。order_vps はここから支払います。
topup_balanceBeareramount (USD)暗号資産によるチャージを作成し、checkout_url を返します。支払いがオンチェーンで確認されると残高に反映されます。未払いのチャージは同時に一つまで。
order_vpsBearerproduct, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi)VPS を注文し、残高で足りれば残高から支払い、足りなければ請求書を返します。location を省略するとこちらで選びます。空きのないロケーションは 409 location_unavailable と available の一覧を返し、課金されません。Windows プランは ssh_key を無視します。
pay_invoiceBearerinvoice_id未払いの請求書の checkout_url を返します。支払いが済むと VPS が作成されます。

VPS の運用

ToolAuthParametersWhat it does
list_vpsBearer—稼働中、作成中、停止中のサービス。削除済みのものは表示されません。
get_vps_statusBearerservice_id, reveal?状態、スペック、現在の稼働状況とアクセス情報：ホスト、ポート、すぐ使える command（Linux は SSH、Windows は RDP）。reveal: true で起動後に一回限りの 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、メモリ、ネットワーク、ディスクの時系列。

プラン変更と解約

ToolAuthParametersWhat it does
get_upgrade_optionsBearerservice_idデータを保ったまま移行できるプラン：より大きなプラン、NAT から専用 IPv4、専用から NAT。各選択肢に prorated_topup と mode が表示されます。ディスクは縮小できません。
change_planBearerservice_id, target_plan (product_id), confirm: true約 1 分の再起動 1 回でプランをその場で切り替えます。日割りの差額は残高から引き落とされ（不足時は 402）、NAT への変更では差額が返金されます。
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 を指定します。呼び出す前に人間に確認してください。

ToolAuthParametersWhat it does
reset_passwordBearerservice_id, confirm新しい root パスワードは 10〜30 秒で稼働中のサーバーに反映され、古いパスワードは使えなくなります。新しいパスワードは get_vps_status（reveal: true）で一度だけ読み取ります。パスワードを失くしたとき用で、起動中のサーバーには使いません。
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 パスワードをどう取得しますか？

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

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

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

← ブログに戻るプランと価格を見る →

コメント

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

コメントを残す

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