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 分