mcp-server-ru

Hostkey MCP サーバー（RU）

Hostkey（.ru ポータル、InvAPI invapi.hostkey.ru）向けの MCP サーバーです。 クライアントは URL 経由、または stdio 経由でローカルに接続します（Cursor、VS Code など）。 ホスト版：https://mcp.hostkey.ru/mcp（.com 向けは https://mcp.hostkey.com/mcp）。

エンドポイント	https://invapi.hostkey.ru（コードに埋め込み済み）
認証	HOSTKEY_API_KEY
ツール	型付きツール 132 個 + call_api_raw

このサーバーを使うと、モデルは Hostkey アカウントにアクセスできます。サーバー、カタログと注文、電源、OS の再インストール、ネットワーク、DNS、スナップショット、IPMI／コンソール、ISO、S3、Remote Hands、請求、API キーを利用できます。

.com ポータル向けには、別パッケージ hostkey-mcp-server をご利用ください。

1. API キーを取得する

InvAPI → API キー管理 → キーを発行します。

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

2. インストール

Cursor（ホスト URL — 推奨）

.cursor/mcp.json に設定します（どちらか一方、または両方のポータル）：

{
  "mcpServers": {
    "hostkey-com": {
      "url": "https://mcp.hostkey.com/mcp",
      "headers": {
        "Authorization": "Bearer key-from-invapi.hostkey.com"
      }
    },
    "hostkey-ru": {
      "url": "https://mcp.hostkey.ru/mcp",
      "headers": {
        "Authorization": "Bearer key-from-invapi.hostkey.ru"
      }
    }
  }
}

InvAPI キーを設定してください。ローカルの Node／npx は不要です。

Cursor（ローカル npx／stdio）

{
  "mcpServers": {
    "hostkey-com": {
      "command": "npx",
      "args": ["-y", "hostkey-mcp-server"],
      "env": {
        "HOSTKEY_API_KEY": "key-from-invapi.hostkey.com"
      }
    },
    "hostkey-ru": {
      "command": "npx",
      "args": ["-y", "hostkey-mcp-server-ru"],
      "env": {
        "HOSTKEY_API_KEY": "key-from-invapi.hostkey.ru"
      }
    }
  }
}

VS Code

.vscode/mcp.json に設定します。同じオプションを利用できます（url + headers または command／args／env）。

stdio 用のオプション：HOSTKEY_TOKEN_TTL、HOSTKEY_HTTP_TIMEOUT、HOSTKEY_ALLOW_DESTRUCTIVE（.env.example を参照）。

ソースからインストールする場合（Node.js ≥ 22.18）：npm install && npm run build。

3. 危険な操作の確認

すべての書き込み操作には confirm=true が必要です。指定しない場合、サーバーは何も変更しません。

さらに、次の制限があります。

• サーバーの注文はデフォルトで 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 を注文して」と入力するだけで、モデルが適切なツールを選択します。