Serwer MCP

HostBase udostępnia zdalny serwer MCP (Model Context Protocol), dzięki któremu asystenci AI mogą zarządzać Twoimi projektami: listować je, tworzyć nowe, pobierać klucze czy pauzować nieużywane środowiska.

Parametr	Wartość
Adres	https://host.ulewicz.space/api/mcp
Transport	Streamable HTTP
Uwierzytelnianie	Authorization: Bearer hb_pat_...

1. Wygeneruj token

Przejdź do Konto → Tokeny dostępu i utwórz nowy token. Zostanie wyświetlony tylko raz — skopiuj go od razu.

2. Skonfiguruj klienta

Claude Code

claude mcp add --transport http hostbase https://host.ulewicz.space/api/mcp --header "Authorization: Bearer hb_pat_..."

Claude Desktop

Claude Desktop łączy się ze zdalnymi serwerami przez most mcp-remote. W pliku claude_desktop_config.json:

{
  "mcpServers": {
    "hostbase": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://host.ulewicz.space/api/mcp",
        "--header", "Authorization: Bearer hb_pat_..."
      ]
    }
  }
}

Cursor

W pliku .cursor/mcp.json w projekcie (lub globalnie w ~/.cursor/mcp.json):

{
  "mcpServers": {
    "hostbase": {
      "url": "https://host.ulewicz.space/api/mcp",
      "headers": { "Authorization": "Bearer hb_pat_..." }
    }
  }
}

Dostępne narzędzia

Narzędzie	Opis
list_organizations	Lista organizacji, do których należysz, wraz z planem.
list_projects	Lista projektów (opcjonalnie w danej organizacji).
get_project	Szczegóły projektu: status, region, rozmiar instancji, URL API.
create_project	Tworzy projekt (name, organization_slug, region, compute_size).
get_project_keys	Zwraca URL API oraz klucz anon projektu.
pause_project	Pauzuje projekt (oszczędność zasobów).
restore_project	Przywraca spauzowany projekt.
execute_sql	Wykonuje zapytanie SQL na bazie projektu (ref, query) i zwraca wiersze wyniku. Wymaga roli owner, admin lub developer.
list_edge_functions	Lista Edge Functions projektu (nazwa, wersja, verify_jwt, URL).
get_edge_function	Kod źródłowy i konfiguracja funkcji (ref, name).
deploy_edge_function	Tworzy lub aktualizuje funkcję (ref, name, code lub files, opcjonalnie verify_jwt).
delete_edge_function	Usuwa funkcję.
list_function_secrets	Nazwy sekretów funkcji (bez wartości).
set_function_secrets	Ustawia sekrety funkcji (secrets: mapa NAZWA → wartość).
list_edge_function_versions	Historia wdrożeń funkcji (wersja, data, autor, opis, rozmiar).
rollback_edge_function	Przywraca kod wskazanej wersji (ref, name, version) jako nową wersję.

Przykładowe polecenia

• „Pokaż moje projekty HostBase i ich statusy.”
• „Utwórz projekt sklep-staging w Warszawie w organizacji acme.”
• „Daj mi URL i klucz anon projektu sklep-staging i dopisz je do .env.local.”
• „Utwórz w projekcie sklep-staging tabelę products z RLS i dodaj 3 przykładowe produkty.”
• „Napisz i wdróż w sklep-staging funkcję send-email wysyłającą e-mail przez Resend, a potem ustaw sekret RESEND_API_KEY.”

Bezpieczeństwo

• Token ma uprawnienia Twojego konta — traktuj go jak hasło i nie commituj do repozytorium.
• Narzędzia MCP nie zwracają klucza service_role ani hasła do bazy.
• execute_sql działa z uprawnieniami administratora bazy — przeglądaj zapytania, które agent chce wykonać, zanim je zatwierdzisz.
• Nieużywane tokeny usuwaj w panelu — działa to natychmiast.