MCP-сервер для Hostkey (портал .ru, InvAPI invapi.hostkey.ru). Клиент запускает сервер локально по stdio — из Cursor, VS Code и других MCP-клиентов.


Endpoint	`https://invapi.hostkey.ru` (зашит в код)
Авторизация	`HOSTKEY_API_KEY`
Инструменты	132 типизированных + `call_api_raw`

Сервер даёт модели доступ к аккаунту Hostkey: серверы, каталог и заказ, питание, переустановка ОС, сеть, DNS, снапшоты, IPMI/консоль, ISO, S3, Remote Hands, биллинг и API-ключи.

Для портала .com — отдельный пакет hostkey-mcp-server.

1. Получите API-ключ

InvAPI → управление API-ключами → выпустите ключ.

Лучше отдельный ключ для MCP. Ключ на один сервер ограничивает доступ этим сервером. Для записи DNS нужны права pdns/edit.

2. Установка

Cursor

.cursor/mcp.json:

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

VS Code

.vscode/mcp.json:

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

Опционально: HOSTKEY_TOKEN_TTL, HOSTKEY_HTTP_TIMEOUT, HOSTKEY_ALLOW_DESTRUCTIVE (см. .env.example).

Из исходников (Node.js ≥ 20): npm install && npm run build.

3. Подтверждение опасных операций

Все write-вызовы требуют confirm=true. Без него сервер ничего не меняет.

Дополнительно:

заказ сервера по умолчанию в dry_run — реальный заказ только после явного согласия;
переустановка ОС, PXE и отмена услуг — только при HOSTKEY_ALLOW_DESTRUCTIVE=1;
пароли и токены в ответах маскируются.

Долгие операции (деплой, переустановка) возвращают callback-ключ — статус через 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	ВМ-снапшоты, образы, бакеты
Remote Hands	тикеты дежурной смене (`request_rh_`, `rhr_`)
Биллинг	счета, платежи, контакты
Прочее	`check_task`, `call_api_raw`

Промпты

Промпт	Зачем
`order_server_prompt`	заказ сервера по шагам
`reinstall_server_prompt`	переустановка ОС
`troubleshoot_server_prompt`	диагностика

Или просто напишите: «покажи мои серверы» / «закажи VPS в NL» — модель выберет нужные инструменты.