MCP-сервер

Керування Public Cloud hostd з AI-агента (Cursor, Claude Code) через Model Context Protocol.

MCP-сервер hostd дає AI-агенту змогу працювати з вашим Public Cloud від вашого імені: переглядати проєкти й образи ОС, додавати SSH-ключі, створювати VM і керувати ними, встановлювати 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, тож має такий самий доступ, як і ключ: вашу роль у кожному проєкті, обмежену налаштуванням API access проєкту, яке обирає його власник (докладніше). Проєктів без доступу API агент не бачить; у проєктах лише для читання він може тільки читати.

Приклад

Створи VM у проєкті x, встанови на неї Docker, ім'я test.x.com.

Агент:

Знаходить проєкт і відповідний образ ОС.
Читає ваш публічний SSH-ключ з комп'ютера і додає його в hostd, якщо його там немає.
Показує чернетку (ресурси, мережа, ціна за годину) і створює VM лише після вашого підтвердження.
Чекає, поки VM запуститься, і отримує її публічну IP-адресу.
Підключається по SSH з вашого комп'ютера і встановлює програмне забезпечення.

SSH працює в терміналі агента з вашим ключем — hostd ніколи не отримує приватний ключ. Для цього кроку агенту потрібен доступ до термінала.

Якщо ви не вкажете пароль, буде згенеровано випадковий і збережено в нотатках VM у порталі. У чаті він не показується.

Інструменти

Інструмент	Що робить
`hostd_list_clusters`	Зони та погодинні ціни
`hostd_list_projects`, `hostd_get_project`	Проєкти та їхні ліміти
`hostd_get_account_usage`	Використання CPU / RAM / диска акаунта відносно лімітів
`hostd_list_os_images`	Образи ОС для нових VM
`hostd_list_ssh_keys`, `hostd_create_ssh_key`	SSH-ключі акаунта
`hostd_list_vms`, `hostd_get_vm`	VM, статус, поточне навантаження, IP-адреси
`hostd_get_vm_metrics`	Навантаження CPU, RAM, мережі та диска за годину, день, тиждень або місяць
`hostd_create_vm`	Створення VM (потрібне ваше підтвердження)
`hostd_wait_vm_ready`	Очікування запуску VM і повернення її IP-адрес
`hostd_power_vm`	Запуск, завершення роботи, зупинка, перезавантаження, скидання
`hostd_delete_vm`	Видалення зупиненої VM (потрібне ваше підтвердження; агент питає, чи зберегти публічні IP та резервні копії)
`hostd_update_ptr`	Встановлення PTR-запису публічної IP
`hostd_list_project_tasks`	Останні задачі в проєкті

Ліміти

MCP-сервер дотримується лімітів API. Крім того, він регулює темп агента: повторні виклики коротко чекають замість помилки, а після досягнення ліміту агент отримує час, через який можна повторити спробу.