Serwer MCP

Zarządzanie Public Cloud hostd z agenta AI (Cursor, Claude Code) przez Model Context Protocol.

Serwer MCP hostd pozwala agentowi AI pracować z Twoim Public Cloud w Twoim imieniu: wyświetlać projekty i obrazy systemów, dodawać klucze SSH, tworzyć VM i zarządzać nimi oraz ustawiać rekordy PTR. Korzysta z tego samego API i tego samego klucza API.

Endpoint: https://mcp.hostd.cloud/mcp (Streamable HTTP).

Podłączenie

Utwórz klucz API w portalu w Ustawienia → Klucze API. Dobrym wyborem jest osobny klucz dla agenta — możesz go w każdej chwili usunąć bez wpływu na inne integracje.

Cursor — dodaj do ~/.cursor/mcp.json (lub .cursor/mcp.json w projekcie):

{
  "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>"

Dostęp

Agent działa z Twoim kluczem API, więc ma taki sam dostęp jak klucz: Twoją rolę w każdym projekcie, ograniczoną przez ustawienie API access projektu wybrane przez jego właściciela (szczegóły). Projektów bez dostępu API agent nie widzi; w projektach tylko do odczytu może jedynie czytać.

Przykład

Utwórz VM w projekcie x, zainstaluj na niej Dockera, nazwa test.x.com.

Agent:

Znajduje projekt i odpowiedni obraz systemu.
Odczytuje Twój publiczny klucz SSH z komputera i dodaje go do hostd, jeśli go brakuje.
Pokazuje szkic (zasoby, sieć, cena za godzinę) i tworzy VM dopiero po Twojej akceptacji.
Czeka, aż VM się uruchomi, i pobiera jej publiczny adres IP.
Łączy się przez SSH z Twojego komputera i instaluje oprogramowanie.

SSH działa w terminalu agenta z Twoim kluczem — hostd nigdy nie otrzymuje klucza prywatnego. Do tego kroku agent potrzebuje dostępu do terminala.

Jeśli nie podasz hasła, zostanie wygenerowane losowe i zapisane w notatkach VM w portalu. Nie pojawia się w czacie.

Narzędzia

Narzędzie	Co robi
`hostd_list_clusters`	Strefy i ceny godzinowe
`hostd_list_projects`, `hostd_get_project`	Projekty i ich limity
`hostd_get_account_usage`	Zużycie CPU / RAM / dysku konta względem limitów
`hostd_list_os_images`	Obrazy systemów dla nowych VM
`hostd_list_ssh_keys`, `hostd_create_ssh_key`	Klucze SSH na koncie
`hostd_list_vms`, `hostd_get_vm`	VM, status, bieżące obciążenie, adresy IP
`hostd_get_vm_metrics`	Obciążenie CPU, RAM, sieci i dysku w ciągu godziny, dnia, tygodnia lub miesiąca
`hostd_create_vm`	Tworzenie VM (wymaga Twojej akceptacji)
`hostd_wait_vm_ready`	Oczekiwanie na uruchomienie VM i zwrot jej adresów IP
`hostd_power_vm`	Start, zamknięcie, zatrzymanie, restart, reset
`hostd_delete_vm`	Usunięcie zatrzymanej VM (wymaga Twojej akceptacji; agent pyta, czy zachować publiczne IP i kopie zapasowe)
`hostd_update_ptr`	Ustawienie rekordu PTR publicznego IP
`hostd_list_project_tasks`	Ostatnie zadania w projekcie

Limity

Serwer MCP stosuje limity API. Dodatkowo reguluje tempo agenta: powtarzane wywołania chwilę czekają zamiast kończyć się błędem, a po osiągnięciu limitu agent otrzymuje czas, po którym może ponowić próbę.