MCP-сервер
Керування Public Cloud hostd з AI-агента (Cursor, Claude Code) через Model Context Protocol.
MCP-сервер hostd дає AI-агенту змогу працювати з вашим Public Cloud від вашого імені: переглядати проєкти й образи ОС, додавати SSH-ключі, створювати VM і керувати ними, налаштовувати firewall, резервні копії та високу доступність, встановлювати PTR-записи. Він використовує той самий API і той самий ключ API.
Ендпоінт: https://mcp.hostd.cloud/mcp (Streamable HTTP).
Підключення
Створіть ключ API в порталі в Налаштування → Ключі API. Добрий варіант – окремий ключ для агента: його можна будь-коли видалити, не зачіпаючи інші інтеграції.
Cursor – додайте до ~/.cursor/mcp.json (або .cursor/mcp.json у проєкті):
{
"mcpServers": {
"hostd": {
"url": "https://mcp.hostd.cloud/mcp",
"headers": { "Authorization": "Bearer <your-api-key>" }
}
}
}Claude Code:
claude mcp add --transport http hostd https://mcp.hostd.cloud/mcp \
--header "Authorization: Bearer <your-api-key>"Доступ
Агент працює з вашим ключем API, тож має такий самий доступ, як і ключ: для кожного проєкту Read, Write (усе, крім видалення) або Full (додатково видалення VM, проєкту та публічних IP) і доступ до ключів SSH, вибраний для ключа, ніколи понад вашу роль у проєкті (докладніше). Проєктів поза доступом ключа агент не бачить; з доступом Read він може тільки читати. Видалення VM (разом з усіма її резервними копіями) потребує Full.
Перед ризикованими діями – видаленням VM, перевстановленням, режимом відновлення, відновленням копії, відкатом до знімка, зміною розміру або зміною firewall – агент показує, що станеться, і чекає на ваше підтвердження.
Приклад
У проєкті web створи VM з іменем git. Встанови Docker і запусти Gitea. На firewall дозволь HTTP і HTTPS звідусіль, а SSH лише з security group management.
Агент знаходить проєкт, ваш SSH-ключ і цю групу. Пропонує образ і розмір, якого вистачить для Gitea, разом із ціною за годину. VM створюється лише після вашої згоди.
Далі він чекає, поки VM запуститься, підключається по SSH з вашого комп'ютера і встановлює Docker та Gitea. hostd не отримує приватний ключ. Пароль, який ви не задавали, зберігається в нотатках VM у порталі і не з'являється в чаті.
Потім він відкриває HTTP і HTTPS, підключає management, щоб SSH ішов за правилами цієї групи, і питає ще раз, перш ніж увімкнути firewall і відкинути решту вхідних з'єднань.
Інструменти
Сорок п'ять інструментів.
| Інструмент | Що робить |
|---|---|
hostd_list_clusters | Зони та погодинні ціни |
hostd_list_projects | Проєкти, до яких цей ключ має доступ |
hostd_get_project | Один проєкт: ліміти та погодинні ціни |
hostd_create_project | Створити проєкт після вашої згоди; ключ має мати право створювати проєкти |
hostd_get_account_usage | Використання CPU, RAM і диска акаунта відносно лімітів |
hostd_list_os_images | Образи ОС, доступні для нових VM у проєкті |
hostd_list_ssh_keys | Публічні SSH-ключі акаунта |
hostd_create_ssh_key | Додати публічний SSH-ключ |
hostd_list_vms | VM у проєкті: статус, розмір і поточне навантаження |
hostd_get_vm | Одна VM: статус, адреси, нотатки та користувач cloud-init |
hostd_get_vm_metrics | CPU, RAM, мережа та диск за годину, день, тиждень або місяць |
hostd_list_project_tasks | Останні задачі в проєкті |
hostd_create_vm | Створити VM після вашої згоди |
hostd_wait_vm_ready | Зачекати, поки VM запуститься, і повернути її адреси |
hostd_power_vm | Запуск, завершення роботи, зупинка, перезавантаження або скидання |
hostd_resize_vm | Змінити vCPU, RAM, диск або клас CPU після вашої згоди |
hostd_reinstall_vm | Перевстановити ОС зупиненої VM після вашої згоди |
hostd_enable_rescue | Запустити зупинену Linux VM з тимчасової копії її ОС після вашої згоди. Висока доступність має бути вимкнена |
hostd_disable_rescue | Прибрати цей тимчасовий диск і завантажити системний диск після вашої згоди |
hostd_delete_vm | Видалити зупинену VM і її копії; потрібні Full і ваша згода |
hostd_list_vm_snapshots | Знімок VM |
hostd_manage_vm_snapshot | Створити, видалити або відкотити цей знімок |
hostd_list_vm_backups | Резервні копії VM |
hostd_create_vm_backup | Зробити резервну копію VM зараз |
hostd_restore_vm_backup | Відновити копію на зупинену VM після вашої згоди |
hostd_list_backup_jobs | Заплановані завдання копій і VM, які не входять у жодне |
hostd_manage_backup_job | Створити, змінити або видалити завдання, або додати й прибрати VM |
hostd_get_project_ha | Які VM мають високу доступність, і правила розміщення |
hostd_set_vm_ha | Увімкнути або вимкнути високу доступність VM |
hostd_manage_ha_rule | Створити, змінити або видалити правило розміщення |
hostd_get_vm_firewall | Опції firewall VM, правила і під'єднані групи |
hostd_set_vm_firewall_options | Увімкнути або вимкнути firewall VM і задати політики |
hostd_manage_vm_firewall_rules | Додати, змінити, видалити або змінити порядок правил firewall VM |
hostd_list_ip_sets | IP sets, їхні елементи і де вони використовуються |
hostd_manage_ip_set | Створити IP set, змінити коментар або видалити |
hostd_manage_ip_set_members | Додати або прибрати адреси в IP set |
hostd_list_security_groups | Security groups, їхні правила і які VM їх використовують |
hostd_manage_security_group | Створити, перейменувати або видалити security group |
hostd_manage_security_group_rules | Додати, змінити, видалити або змінити порядок правил security group |
hostd_list_private_networks | Приватні мережі або вільні адреси однієї з них |
hostd_create_private_network | Створити приватну мережу після вашої згоди |
hostd_manage_vm_network | Додати або видалити інтерфейс приватної мережі ВМ чи увімкнути й вимкнути її публічну мережу; видалення та зміни публічної мережі лише після вашої згоди |
hostd_list_public_ips | Публічні адреси, зарезервовані в проєкті |
hostd_update_ptr | Встановити PTR-запис публічної адреси |
hostd_get_current_agent_ip | Публічна адреса, з якої приходить це з'єднання MCP |
Ліміти
MCP-сервер дотримується лімітів API. Крім того, він регулює темп агента: повторні виклики коротко чекають замість помилки, а після досягнення ліміту агент отримує час, через який можна повторити спробу.