hostkey-cloud

Hostkey MCP サーバー

Hostkey の MCP サーバー（.com ポータル、InvAPI invapi.hostkey.com）。 stdio 経由でローカル実行します — Cursor、VS Code、その他の MCP クライアントに対応します。 ホスト型リモートサーバー：https://mcp.hostkey.com/mcp（クラウドエージェント向け）。

エンドポイント	https://invapi.hostkey.com（ハードコード）
認証	HOSTKEY_API_KEY
ツール	型付きツール 132 個 + call_api_raw

モデルが Hostkey アカウントにアクセスできるようになります。サーバー、カタログと注文、電源、OS の再インストール、ネットワーク、DNS、スナップショット、IPMI／コンソール、ISO、S3、Remote Hands、請求、API キーに対応しています。

1. API キーを取得する

InvAPI → API keys → キーを作成します。

MCP 専用のキーを使用することをおすすめします。サーバー単位のキーでは、アクセスが 1 台のサーバーに制限されます。 DNS の書き込みには pdns/edit 権限が必要です。

2. インストール

Cursor

ボタンをクリックし、YOUR_API_KEY を InvAPI キーに置き換えてから、確定します。

または、手動で .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "hostkey-mcp-server": {
      "command": "npx",
      "args": ["-y", "hostkey-mcp-server"],
      "env": {
        "HOSTKEY_API_KEY": "your-api-key"
      }
    }
  }
}

リモート（クラウドエージェント）

ローカルの Node／npx は不要です。クライアントをホスト型エンドポイントに接続し、InvAPI キーを送信します。

{
  "mcpServers": {
    "hostkey": {
      "url": "https://mcp.hostkey.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "hostkey-mcp-server": {
      "command": "npx",
      "args": ["-y", "hostkey-mcp-server"],
      "env": {
        "HOSTKEY_API_KEY": "your-api-key"
      }
    }
  }
}

任意：HOSTKEY_TOKEN_TTL、HOSTKEY_HTTP_TIMEOUT、HOSTKEY_ALLOW_DESTRUCTIVE （.env.example を参照）。

ソースからの場合（Node.js ≥ 22.18）：npm install && npm run build。

3. 危険な操作の確認

すべての書き込み呼び出しには confirm=true が必要です。指定しない場合、何も変更されません。

また、次の点にご注意ください。

• order_server はデフォルトで dry_run です — 明示的に同意した場合にのみ、実際に注文されます。
• OS の再インストール、PXE、サービスのキャンセルには HOSTKEY_ALLOW_DESTRUCTIVE=1 が必要です。
• パスワードとトークンはレスポンス内でマスクされます。

長時間かかるジョブ（デプロイ、再インストール）はコールバックキーを返します。check_task でポーリングしてください。

4. ツール

グループ（全リストは tools/list で確認できます）：

グループ	例
サーバー	get_servers、get_server、get_power_status
カタログ	list_presets、list_os、list_traffic_plans
電源と注文	power_on、power_off、order_server、reinstall_server
PXE	create_reinstall_task → … → clear_pxe_config
ネットワーク／DNS	ポート、PTR、ゾーン、レコード
スナップショット、ISO、S3	VM スナップショット、イメージ、バケット
Remote Hands	当直シフトのチケット（request_rh_*、rhr_*）
請求	請求書、支払い、連絡先
その他	check_task、call_api_raw

プロンプト

プロンプト	目的
order_server_prompt	サーバー注文のガイド
reinstall_server_prompt	OS の再インストール
troubleshoot_server_prompt	診断

または、「自分のサーバーを一覧表示して」／「NL で VPS を注文して」と尋ねるだけです。

ドキュメント

• プロジェクトのステータス
• アクションログ
• QA：ホスト型 URL