Mcp Server Ru

io.github.hostkey-cloud-ru由 GitHub 帳號 hostkey-cloud-ru 發布v1.0.8更新於 Oct 30, 2026

MCP server for Hostkey .ru (InvAPI): servers, power, order, DNS, S3, billing

已驗證Streamable HTTP可網頁執行雲端與基礎設施開發者工具安全與監控

概覽

AI 產生的概覽

Hostkey .ru 主機服務的 MCP 伺服器,讓助理透過 InvAPI 檢視、訂購與管理伺服器、網路、DNS、S3 及帳務。

可以做什麼
  • 列出並檢視伺服器、電源狀態、硬體感測器與標籤
  • 瀏覽目錄:預設方案、現貨伺服器、作業系統、軟體與流量方案
  • 開關機、訂購、重裝系統與 PXE 流程,非同步工作以 check_task 查詢
  • 管理網路埠、IP 封鎖、PTR 記錄與主要 IP
  • 讀取與編輯 DNS 區域、網域及子網域
  • 處理快照、ISO、S3、Remote Hands 工單、帳務與 API 金鑰,並可呼叫原始 API
適用情境
適合想讓助理直接查詢 Hostkey .ru 帳戶資訊或執行主機維運操作的情境,例如訂購 VPS、重新開機、重裝系統、調整 DNS 或查看帳單,不必切換到控制台。
執行需求
可使用 mcp.hostkey.ru 遠端端點並設定 Authorization bearer 標頭,或在本機以 stdio 執行 npm 套件(需 Node.js 22.18 以上)。需要 Hostkey .ru InvAPI 的 API 金鑰(HOSTKEY_API_KEY);寫入 DNS 需 pdns/edit 權限。可選 HOSTKEY_TOKEN_TTL、HOSTKEY_HTTP_TIMEOUT 與 HOSTKEY_ALLOW_DESTRUCTIVE。
安裝前請注意
API 金鑰可存取真實主機帳戶,針對單一伺服器簽發的金鑰可將權限限制在該台伺服器。寫入操作需 confirm=true,重裝系統、PXE 循環與取消服務另需 HOSTKEY_ALLOW_DESTRUCTIVE=1。下單、刪除 API 金鑰、關閉連接埠與封鎖 IP 會變更或中斷線上服務,下單也可能產生費用。新建 API 金鑰的值只顯示一次。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Server Ru,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.hostkey-cloud-ru%2Fmcp-server-ru/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "ru": {
      "type": "http",
      "url": "https://mcp.hostkey.ru/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Hostkey MCP Server (RU)

MCP-сервер для Hostkey (портал .ru, InvAPI invapi.hostkey.ru). Клиент подключается по URL или локально по stdio (Cursor, VS Code и др.). Hosted: https://mcp.hostkey.ru/mcp (для .com — https://mcp.hostkey.com/mcp).

Endpointhttps://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 (hosted URL — рекомендуется)

В .cursor/mcp.json (один или оба портала):

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)

[Install in Cursor]

json
{  "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. Подтверждение опасных операций

Все 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
PXEcreate_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» — модель выберет нужные инструменты.

來源:README.md,提交 09fdbf9

工具

132

get_servers

Список серверов аккаунта Hostkey с фильтрами. Перед первым вызовом автоматически обновляет инвентарь (eq/update_servers). Возвращает ID серверов и краткие данные; для полной карточки используйте get_server.

輸入參數ipmacgroupstatuslocation

get_server

Полная информация о сервере по его ID (eq/show): конфигурация, сеть, статус, расположение.

輸入參數id必填

get_power_status

Текущий статус питания сервера (включён/выключен).

輸入參數id必填

get_server_sensors

Показания аппаратных сенсоров сервера (температуры, напряжения, вентиляторы). Только для bare-metal.

輸入參數id必填

get_server_tags

Все теги сервера (tags/list). Теги хранят произвольные пары ключ-значение.

輸入參數id必填

search_servers_by_tag

Поиск серверов по имени или значению тега (tags/search_user). Возвращает ID серверов.

輸入參數value必填

list_presets

Актуальный список доступных instant-серверов (VM/BM/GPU/vGPU) с ценами в указанной локации. Токен не требуется. Нужен для подбора preset перед заказом.

輸入參數location必填

search_presets

Поиск подходящих свободных серверов под конкретный пресет по имени (например, vm.pico). Требует авторизации.

輸入參數name必填scopelocation必填

get_preset_pricing

Цены на доступные пресеты в указанных валютах (presets/info). Токен не требуется.

輸入參數currencies

list_preset_groups

Список групп пресетов для категоризации каталога (presets/groups). Токен не требуется.

無需輸入參數。

get_preset

Информация о конкретном пресете или обо всех пресетах (presets/show). Может требовать авторизации в зависимости от прав.

輸入參數id

list_stock_servers

Список доступных stock-серверов (физические серверы стандартных конфигураций, деплой в течение рабочего дня). Токен не требуется.

輸入參數group必填location必填

get_stock_server

Детальная информация о конкретном stock-сервере (stocks/show).

輸入參數id必填

list_os

Список операционных систем, доступных для установки на пресет/сервер (os/list). Без instance_id возвращает ОС для всех пресетов. Токен не требуется.

輸入參數instance_id

list_software

Список ПО (marketplace-приложений), доступного для автоустановки на сервер (software/list). Токен не требуется.

輸入參數locationinstance_id

list_traffic_plans

Доступные тарифные планы трафика для пресета в локации (traffic_plans/list). Токен не требуется.

輸入參數location必填instance_id必填

get_account_info

Информация о текущем API-токене и аккаунте (auth/info): доступные вызовы, тип и роль аккаунта, ID привязанных серверов. Полезно для проверки подключения.

無需輸入參數。

logout

Завершить текущую API-сессию (auth/logout): сессионный токен удаляется из InvAPI. При следующем вызове клиент автоматически выполнит повторный вход по API-ключу.

無需輸入參數。

list_api_keys

Список всех API-ключей аккаунта (api_keys/list).

無需輸入參數。

list_server_api_keys

Список API-ключей, выданных для конкретного сервера (api_keys/list_for_server).

輸入參數server_id必填

get_api_key

Информация о конкретном API-ключе (api_keys/view).

輸入參數id必填

get_api_key_history

История использования API-ключа за период (api_keys/history).

輸入參數id必填period_toperiod_from

create_api_key

Создать новый API-ключ для аккаунта или конкретного сервера (api_keys/add). Значение ключа будет показано один раз в ответе — сохраните его.

輸入參數ipname必填active必填confirm必填server_idlogin_notify_method必填login_notify_address

update_api_key

Изменить параметры API-ключа (api_keys/edit): имя, IP-белый список, уведомления, активность.

輸入參數id必填ipname必填active必填confirm必填login_notify_method必填login_notify_address

delete_api_key

Удалить API-ключ (api_keys/delete). ДЕСТРУКТИВНО: приложения, использующие ключ, потеряют доступ.

輸入參數id必填confirm必填

get_network_status

Состояние сетевых интерфейсов сервера (net/get_status): порт, свитч, VLAN, скорость, MAC, статус подключения. Опциональный port ограничивает запрос одним интерфейсом (если другой NIC без upstream_id ломает ответ).

輸入參數id必填port

get_port_graphs

Графики загрузки порта за период (net/show_cacti): день/месяц/год.

輸入參數id必填port必填graph必填

get_ip_info

Информация о сетевом интерфейсе по IP-адресу (ip/get_ip).

輸入參數ip必填

get_ptr_record

Текущая PTR-запись (reverse DNS) для IP-адреса (ip/get_ptr).

輸入參數id必填ip必填

port_on

Включить сетевой порт сервера (net/port_on).

輸入參數id必填port必填confirm必填

port_off

Выключить сетевой порт сервера (net/port_off). ДЕСТРУКТИВНО: сервер потеряет сетевую связность по этому интерфейсу.

輸入參數id必填port必填confirm必填

block_ip

Заблокировать IP-адрес на сервере на уровне сети Hostkey (net/block_ip). Полезно для abuse-запросов.

輸入參數id必填ip必填confirm必填four_hoursdescription必填

unblock_ip

Снять блокировку IP-адреса на сервере (net/unblock_ip).

輸入參數id必填ip必填confirm必填

update_ptr_record

Обновить PTR-запись для IP-адреса (ip/update_ptr). Несколько записей передаются разделителем %0A.

輸入參數id必填ip必填ptr必填confirm必填

set_main_ip

Назначить основной IP-адрес сервера (ip/set_main), когда адресов несколько.

輸入參數id必填ip必填main必填confirm必填

list_dns_zones

Список всех DNS-зон аккаунта на серверах PowerDNS Hostkey (pdns/list_zones).

無需輸入參數。

get_dns_zone

Содержимое DNS-зоны: все записи (A, AAAA, CNAME, MX, TXT и т.д.) с авторитетного сервера (pdns/view_zone).

輸入參數zone必填

list_dns_domains

Список всех доменов пользователя из таблицы доменов (pdns/list_domains).

無需輸入參數。

list_dns_subdomains

Список сабдоменов по ID сервера (pdns/list_subdomains).

輸入參數server_id必填

add_dns_domain

Создать DNS-зону и добавить домен в таблицу доменов (pdns/add_domain). Требует права pdns/edit.

輸入參數name必填confirm必填

delete_dns_domain

Удалить домен по ID: DNS-зону, сам домен и все его сабдомены (pdns/delete_domain). ДЕСТРУКТИВНО. Требует права pdns/edit.

輸入參數confirm必填domain_id必填server_id必填

add_dns_subdomain

Добавить сабдомен в таблицу сабдоменов (pdns/add_subdomain). Требует права pdns/edit.

輸入參數name必填confirm必填domain_id必填server_id必填

edit_dns_subdomain

Обновить сабдомен (pdns/edit_subdomain). Требует права pdns/edit.

輸入參數id必填confirm必填server_id

delete_dns_subdomain

Удалить сабдомен из таблицы сабдоменов (pdns/delete_subdomain). ДЕСТРУКТИВНО. Требует права pdns/edit.

輸入參數id必填confirm必填server_id必填

add_dns_zone

Создать DNS-зону на авторитетном сервере PowerDNS (pdns/add_zone). Требует права pdns/edit.

輸入參數dnskindname必填dnssecrrsetsconfirm必填mastersnameservers

delete_dns_zone

Удалить DNS-зону по имени вместе со всеми записями и метаданными (pdns/delete_zone). ДЕСТРУКТИВНО. Требует права pdns/edit.

輸入參數zone必填confirm必填

add_dns_record

Добавить или изменить DNS-запись в зоне (pdns/add_dns). Требует права pdns/edit. Для SRV-записей заполните proto/priority/weight/port/target. Поля mname/rname в документации отмечены как обязательные для SOA-проверок — при ошибке заполните их.

輸入參數ttlnameporttype必填zone必填mnameprotornametargetweightconfirm必填content必填另有 3 個

delete_dns_record

Удалить DNS-запись из зоны (pdns/delete_dns). ДЕСТРУКТИВНО. Требует права pdns/edit.

輸入參數name必填type必填zone必填confirm必填

get_snapshots

Список снапшотов виртуальной машины (vm/get_snapshot): имя, snapshot_id, дата.

輸入參數id必填

get_vm_engine

Информация о движке виртуализации (vm/get_engine).

無需輸入參數。

get_vm_stats

Статистика виртуальной машины (vm/load_stats).

輸入參數id必填

create_snapshot

Создать снапшот виртуальной машины (vm/create_snapshot). Асинхронная операция — статус через check_task.

輸入參數id必填name必填confirm必填

remove_snapshot

Удалить снапшот (vm/remove_snapshot). ДЕСТРУКТИВНО: снапшот удаляется безвозвратно. Удаление возможно только на выключенной ВМ.

輸入參數id必填name必填confirm必填

restore_snapshot

Восстановить ВМ из снапшота (vm/restore_snapshot). ДЕСТРУКТИВНО: текущее состояние диска ВМ будет перезаписано состоянием снапшота.

輸入參數id必填name必填confirm必填

get_vnc_console

Доступ к VNC-консоли сервера (eq/console): возвращает конфиг console.vv в Base64 для virt-viewer.

輸入參數id必填

start_novnc

Запустить NoVNC (HTML5) сессию консоли сервера (eq/novnc): возвращает ссылку для открытия в браузере.

輸入參數id必填white_ip

list_post_install_tasks

Доступные post-install Ansible-задачи (jenkins/get_tasks) с тегами применимости: gpu, bm, vm, vgpu, default. Без токена — общий список, с токеном — доступные конкретному пользователю.

無需輸入參數。

run_post_install_task

Выполнить Jenkins/Ansible-задачу на сервере (jenkins/call): ID или имя задачи из list_post_install_tasks + доп. параметры. Например, установка GPU-драйверов после переустановки ОС.

輸入參數id必填task必填paramsconfirm必填

add_static_nat

Создать статический DNAT до IPMI сервера (nat/add_static_nat): публичный IP для классического IPMI. Это не Secure IPMI Proxy в ЛК — Active Proxy сам по себе может не удовлетворять вызов. Асинхронно; статус через check_task. При server_ipmi_acl_required передайте ip_acl.

輸入參數id必填ttlip_aclconfirm必填secured

remove_static_nat

Удалить статический DNAT до IPMI сервера (nat/remove_static_nat).

輸入參數id必填confirm必填

clear_static_nat

Удалить застывшие правила статического NAT-проброса по внутреннему IP (nat/clear_static_nat).

輸入參數ip必填confirm必填

drop_nat

Удалить запись о NAT из базы данных (nat/drop_nat). ДЕСТРУКТИВНО, служебная операция.

輸入參數idipconfirm必填

add_ipmi_user

Создать временного IPMI-пользователя для веб-доступа к IPMI (eq/add_ipmi_user).

輸入參數id必填confirm必填

remove_ipmi_user

Удалить временного IPMI-пользователя (eq/remove_ipmi_user).

輸入參數id必填confirm必填

reset_ipmi

Перезагрузить IPMI-модуль сервера (eq/unit_reset). Применять, если IPMI не отвечает.

輸入參數id必填confirm必填

request_rh_power_on

Заявка Remote Hands: включить сервер вручную (jira/request_pon). Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

輸入參數id必填confirm必填

request_rh_power_off

Заявка Remote Hands: выключить сервер вручную (jira/request_poff). ДЕСТРУКТИВНО для работающих сервисов. Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

輸入參數id必填confirm必填

request_rh_reboot

Заявка Remote Hands: перезагрузить сервер вручную (jira/request_reboot). Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

輸入參數id必填confirm必填

request_rh_pxe_boot

Заявка Remote Hands: загрузить сервер по PXE (jira/request_PXEboot). Нужна при переустановке ОС на серверах без модуля удалённого управления. Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

輸入參數id必填confirm必填

request_rh_kvm

Заявка Remote Hands: подключить IP KVM к серверу (jira/request_kvm). Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

輸入參數id必填confirm必填

request_rh_check

Заявка Remote Hands: проверить сервер и загрузить его в ОС (jira/request_check). Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

輸入參數id必填confirm必填

request_sales_assistance

Тикет в отдел продаж (jira/request_assistance): отмена или перенос услуги и подобные запросы. Опишите детали в message.

輸入參數idconfirm必填message必填subject

create_reinstall_task

Шаг 1 PXE-переустановки: создать мастер-ключ переустановки ОС (eq/reinstall). Возвращает reinstall_key, по которому check_task отслеживает стадии установки. ДЕСТРУКТИВНО: часть процесса, затирающего диски сервера.

輸入參數id必填confirm必填

create_pxe_config

Шаг 2 PXE-переустановки: создать PXE-конфиг для установки ОС (eq/create_pxe). ДЕСТРУКТИВНО.

輸入參數id必填os_id必填confirm必填ssh_keyhostname必填root_pass必填reinstall_keypost_install_scriptpost_install_callback

set_boot_device

Установить порядок загрузки сервера (eq/boot_dev): pxe — сетевая загрузка (шаг 3 переустановки), disk — загрузка с диска (шаг 6), cd — смонтированный ISO.

輸入參數id必填media必填confirm必填

clear_pxe_config

Шаг 7 PXE-переустановки: удалить PXE-конфиг (eq/clear_pxe). ОБЯЗАТЕЛЬНО после завершения — иначе возможна внезапная переустановка при следующей перезагрузке.

輸入參數id必填confirm必填hostname必填

list_iso_images

Список доступных ISO-образов (iso/list_iso). InvAPI требует id сервера (для клиентских ключей); образы подбираются под конфигурацию сервера.

輸入參數id必填

get_uploaded_isos

Список ISO-образов, загруженных клиентом (iso/uploaded).

無需輸入參數。

upload_iso

Загрузить новый ISO-образ по URL (iso/upload). Доступно клиентам.

輸入參數url必填nameconfirm必填

add_iso_image

Добавить новый ISO-образ или обновить существующий по имени (iso/add). Требует специального права 'add'.

輸入參數urlname必填confirm必填

mount_iso

Смонтировать ISO-образ на сервер (iso/mount_iso). Асинхронная операция — вернётся callback-ключ для check_task. InvAPI ждёт поле `iso` (имя или id). Можно передать iso, либо алиасы name / iso_id.

輸入參數id必填isonameiso_idconfirm必填

unmount_iso

Размонтировать ISO-образ с сервера (iso/unmount_iso). Асинхронная операция — вернётся callback-ключ для check_task.

輸入參數id必填confirm必填

delete_iso_image

Удалить ISO-образ по ID (iso/delete). ДЕСТРУКТИВНО. По документации доступно только сотрудникам Hostkey — у клиентов, скорее всего, вернёт ошибку прав.

輸入參數id必填confirm必填

s3_list_plans

List available S3 storage plans (s3/list_plans).

輸入參數location

s3_get_locations

List available locations for S3 (s3/get_available_locations).

無需輸入參數。

s3_get_buckets

List S3 account buckets and usage (s3/get_buckets_rmq). Pass s3uid or account_id from s3_get_users. May return a task key — then track with check_task.

輸入參數s3uidaccount_id

s3_get_buckets_via_queue

Same as s3_get_buckets: list buckets via s3/get_buckets_rmq. Prefer s3_get_buckets.

輸入參數s3uidaccount_id

s3_get_files

List files in a bucket with pagination and search (s3/get_files).

輸入參數pagelimits3uidbucket必填searchaccount_id

s3_get_users

List S3 users with service, traffic, and storage usage info (s3/get_users). Full filtering is available to administrators. Use returned s3uid/id with s3_get_buckets.

輸入參數location

s3_show_key

Get a decrypted S3 access key (s3/show_key). SECRET: do not log or share with third parties.

輸入參數s3uidkey_type必填account_id

s3_create_account

Create an S3 account: bind a plan and initial bucket (s3/create_account). Requires authentication.

輸入參數bucketconfirm必填plan_idlocation

s3_create_bucket

Create a new bucket in an existing S3 account (s3/create_bucket).

輸入參數s3uidbucket必填confirm必填account_id

s3_create_order

Create a paid S3 storage order linked to billing (s3/create_order). MONEY: creates a real order/invoice.

輸入參數confirm必填plan_idlocation

s3_delete_file

Delete a file from a bucket (s3/delete_file). DESTRUCTIVE: the file is permanently deleted.

輸入參數file必填s3uidbucket必填confirm必填account_id

s3_delete_bucket

Delete a bucket from an S3 account (s3/delete_bucket). DESTRUCTIVE: all files in the bucket will be deleted.

輸入參數s3uidbucket必填confirm必填account_id

s3_delete_account

Fully delete a user's S3 account (s3/delete_account). DESTRUCTIVE: all buckets and data will be deleted. Requires HOSTKEY_ALLOW_DESTRUCTIVE=1.

輸入參數s3uidconfirm必填account_id

s3_delete_payment_account

Initiate S3 account deletion via service cancellation in billing (s3/delete_payment_account). DESTRUCTIVE: an end date will be set on the active service. Requires HOSTKEY_ALLOW_DESTRUCTIVE=1.

輸入參數s3uidconfirm必填account_id

s3_cancel_account_deletion

Cancel S3 service deletion initiated via billing and restore the account to active status (s3/cancel_payment_account_deletion).

輸入參數s3uidconfirm必填account_id

s3_update_traffic_info

Update S3 account traffic information (s3/update_traffic_info). Available to administrators only.

輸入參數s3uidconfirm必填account_id

list_rhr_requests

Список заявок на удалённые работы с фильтрацией по локации и статусу (rhr/list).

輸入參數statuslocation

create_rhr_request

Создать заявку на удалённые работы (rhr/add): работы дежурной смены в дата-центре, которые нельзя выполнить удалённо. Опишите работы максимально подробно в comment. Использовать, только если модуль удалённого управления сервером недоступен/не работает.

輸入參數id必填comment必填confirm必填request_type

add_rhr_comment

Добавить видимое клиенту сообщение в историю заявки (rhr/chat).

輸入參數id必填confirm必填message必填

discard_rhr_request

Отменить/закрыть заявку на удалённые работы (rhr/discard). ДЕСТРУКТИВНО: заявка будет отменена.

輸入參數id必填confirm必填

get_billing_client

Данные клиента из биллинга (whmcs/get_client): контакты, валюта, статус аккаунта.

無需輸入參數。

get_invoices

Полный список инвойсов аккаунта (whmcs/get_invoices).

無需輸入參數。

get_invoice

Данные конкретного инвойса для оплаты (whmcs/get_invoice).

輸入參數invoice_id必填

get_server_invoices

Инвойсы, относящиеся к конкретному серверу (whmcs/get_related_invoices).

輸入參數id必填

get_server_billing_data

Платёжная информация по аренде сервера (whmcs/get_billing_data).

輸入參數id必填

get_transactions

Список транзакций по аккаунту клиента (whmcs/transactions).

輸入參數invoice_idtransaction_id

get_credit_history

Движение средств по лицевому счёту: начисления и списания кредитов (whmcs/getcredits).

輸入參數id必填

get_payment_gateway

Способы оплаты конкретного инвойса (whmcs/getpaymentgw).

輸入參數invoice_id必填

download_invoice

Скачать инвойс в PDF (whmcs/download_invoice). InvAPI отдаёт бинарный PDF; MCP возвращает JSON с encoding=base64 и data — декодируйте в .pdf.

輸入參數invoice_id必填

get_cancellation_requests

Список активных заявок на отмену услуг (whmcs/get_cancellation_requests).

輸入參數id

get_contacts

Список дополнительных контактов аккаунта (whmcs/get_contacts).

無需輸入參數。

update_billing_client

Изменить данные клиента в биллинге (whmcs/update_client): ФИО, компания, адрес, email, телефон и т.д.

輸入參數confirm必填billing_citybilling_emailbilling_statebilling_countrybilling_address1billing_address2billing_lastnamebilling_postcodebilling_firstnamebilling_companynamebilling_phonenumber

reset_billing_password

Сбросить пароль аккаунта биллинга (whmcs/reset_password): на указанный email придёт ссылка для сброса. Email должен совпадать с email аккаунта.

輸入參數email必填confirm必填

add_contact

Добавить дополнительный контакт в аккаунт (whmcs/add_contact). ВНИМАНИЕ: контакт создаётся со случайным email — его нужно поменять в Invapi.

輸入參數confirm必填

update_contact

Изменить дополнительный контакт (whmcs/update_contact): email, пароль, телефон. Указание телефона включает 2FA по SMS.

輸入參數email必填confirm必填password2contact_id必填phonenumber

delete_contact

Удалить дополнительный контакт аккаунта (whmcs/delete_contact). ДЕСТРУКТИВНО.

輸入參數confirm必填contact_id必填

generate_due_invoice

Создать следующий инвойс для сервера (whmcs/generate_due_invoice).

輸入參數id必填confirm必填

create_addfunds_invoice

Создать инвойс на пополнение кредитного баланса (whmcs/create_addfunds). ДЕНЬГИ: создаёт реальный инвойс на указанную сумму.

輸入參數amount必填confirm必填

apply_credit

Оплатить инвойс полностью или частично с кредитного баланса (whmcs/apply_credit). ДЕНЬГИ: списывает средства со счёта.

輸入參數amount必填confirm必填invoice_id必填

mass_pay

Создать групповой инвойс для оплаты нескольких инвойсов разом (whmcs/mass_pay). ДЕНЬГИ.

輸入參數confirm必填invoices必填

request_cancellation

Запросить отмену услуги (whmcs/request_cancellation). ДЕСТРУКТИВНО: cancellation_type=1 — немедленная отмена с частичным возвратом (если возможно), 0 — отмена в конце биллинг-периода. Требует HOSTKEY_ALLOW_DESTRUCTIVE=1.

輸入參數id必填confirm必填cancellation_type必填terminate_reason_custom

delete_cancellation_request

Отозвать заявку на отмену услуги (whmcs/delete_cancellation_request).

輸入參數id必填confirm必填

check_task

Проверка статуса асинхронной операции по callback-ключу (eq_callback/check). Многие операции InvAPI (вкл/выкл питания, заказ, переустановка, снапшоты) возвращают {"result":"OK","callback":"<ключ>"}. Передайте этот ключ сюда, чтобы узнать статус: result="Not ready" — операция ещё идёт; result="OK" — завершена успешно (после этого ключ сгорает). Деплой сервера может занимать 10–30 минут. Если клиент передал progressToken, шлёт notifications/progress.

輸入參數key必填

power_on

Включить сервер (eq/on). Асинхронная операция: в ответе будет callback-ключ для check_task.

輸入參數id必填confirm必填

power_off

Выключить сервер (eq/off). ДЕСТРУКТИВНО: прерывает работу всех сервисов на сервере. Требует confirm=true. Асинхронная операция: в ответе будет callback-ключ для check_task.

輸入參數id必填confirm必填

reboot_server

Перезагрузить сервер (eq/reboot). Прерывает работу сервисов на время перезагрузки. Требует confirm=true. Асинхронная операция: в ответе будет callback-ключ для check_task.

輸入參數id必填confirm必填

order_server

Заказ instant- или stock-сервера (eq/order_instance). ВАЖНО: заказ списывает средства с кредитного баланса или выставляет инвойс. По умолчанию работает в режиме dry_run=true — только проверяет доступность пресета и ОС и возвращает сводку без создания заказа. Для реального заказа передайте dry_run=false и confirm=true после явного согласия пользователя на стоимость. Деплой занимает 10–30 минут, статус — через check_task.

輸入參數os_id必填own_ospreset必填confirmdry_runsoft_idssh_keyhostnamepromocoderoot_pass必填traffic_plan必填deploy_notify另有 4 個

reinstall_server

Переустановка ОС на существующем сервере (упрощённый путь через eq/order_instance с id). ДЕСТРУКТИВНО: все данные на дисках будут удалены. Требуется HOSTKEY_ALLOW_DESTRUCTIVE=1 в окружении сервера, confirm=true и повторный ввод текущего hostname сервера. Асинхронная операция: статус — через check_task.

輸入參數id必填os_id必填own_osconfirm必填soft_idssh_keyhostname必填root_pass必填deploy_notifypost_install_script

call_api_raw

Универсальный прямой вызов InvAPI по ресурсу и action, для ресурсов без типизированных инструментов (например: iso — библиотека ISO-образов, s3 — S3 Object Storage, rhr — Remote Hands новой версии; список действий смотрите в документации: https://hostkey.ru/documentation/apidocs/). ВСЕГДА требует confirm=true; деструктивные/платные действия дополнительно требуют HOSTKEY_ALLOW_DESTRUCTIVE=1. Предпочитайте типизированные инструменты, если они есть для нужной операции.

輸入參數authaction必填paramsconfirm必填resource必填

版本歷史

6
  1. v1.0.8最新Oct 23, 2026
  2. v1.0.7Oct 21, 2026
  3. v1.0.4Oct 16, 2026
  4. v1.0.3Oct 14, 2026
  5. v1.0.2Sep 23, 2026
  6. v1.0.1Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分