HostBase dla agentów AI

Podłącz agenta. Zbuduj wszystko.

Jeden serwer MCP i Twój agent — Claude Code, Codex, Cursor, Antigravity, Hermes — ma pod ręką bazy Postgres, workery, strony, sandboxy, maile i bramkę AI. Opisujesz, co ma powstać; agent zakłada, wdraża i sprawdza logi.

Podłącz agenta Załóż konto

170+: narzędzi MCP
16: gotowych klientów
OAuth 2.1: lub token PAT
EU: dane w Warszawie

terminal — agent z MCP HostBase170+ narzędzi MCP

❯ Zbuduj sklep z koszykiem na Next.js i Postgresie, wdróż go i podaj mi link.

Plan: projekt z bazą → schemat z RLS → worker do maili → witryna.

⏺ hostbase.create_project({ name: "sklep", region: "pl-waw-1" })

⎿ ✓ projekt k3x9qz7mwa2c · active · Postgres 17

⏺ hostbase.execute_sql({ ref: "k3x9qz…", query: "create table products …; create table cart_items …" })

⎿ ✓ CREATE TABLE ×4 · RLS włączone · 12 produktów (seed)

⏺ hostbase.deploy_worker({ name: "order-mailer", type: "queue", runtime: "node22" })

⎿ ✓ build ok · v1 aktywna · kolejka pgmq podpięta

⏺ hostbase.set_site_env({ name: "sklep", env: { NEXT_PUBLIC_SUPABASE_URL: "…" } })

⎿ ✓ 3 zmienne zapisane

⏺ hostbase.deploy_site({ name: "sklep", mode: "source", target: "production" })

⎿ ✓ wdrożenie d1 · next build 38 s

⏺ hostbase.get_site_logs({ name: "sklep", build: true })

⎿ ✓ 14 tras · 0 błędów · healthcheck 200

Gotowe. Sklep działa, koszyk zapisuje się w Postgresie:

https://sklep-k3x9qz7m.host.ulewicz.space

przykładowa sesja

Przykładowa sesja — nazwy narzędzi są prawdziwe, identyfikatory i adresy poglądowe.

Gotowe konfiguracje dla agentów i edytorów

Jak to działa

Połącz → Opisz → Wdróż

01
Połącz
Dodaj serwer MCP jedną komendą, linkiem „Add to Cursor” albo wpisem w konfiguracji. Logujesz się przez OAuth lub podajesz token.
claude mcp add --transport http hostbase …
02
Opisz
Napisz po polsku, co ma powstać: sklep, API, raport, bot. Agent sam dobiera narzędzia HostBase i planuje kroki.
❯ postaw API z kolejką zamówień…
03
Wdróż
Agent tworzy projekt, uruchamia migracje, wdraża workera i stronę, ustawia zmienne i czyta logi. Dostajesz adres HTTPS.
https://api-k3x9….host.ulewicz.space

Konfiguracja

Wybierz klienta, skopiuj, gotowe.

Każdy zestaw to dokładnie ta konfiguracja, której oczekuje dany klient. Wybierz OAuth (bez sekretów w plikach) albo token PAT. Oznaczenie przy kliencie mówi, na ile snippet pokrywa się z dokumentacją producenta.

Claude Code

Transport: Streamable HTTP (natywnie)

Zgodne z dokumentacjąDokumentacja klienta

Uwierzytelnianie

OAuth (logowanie w przeglądarce)Token PAT

Zalecane: bez kopiowania sekretów, zakresy zatwierdzasz na ekranie zgody.

Dodaj serwer

claude mcp add --transport http hostbase https://host.ulewicz.space/api/mcp

Zaloguj się (w Claude Code)

/mcp

Wybierz hostbase w /mcp i zatwierdź zakresy w przeglądarce (OAuth 2.1).

Jedna komenda z CLI HostBase:hostbase mcp install --client claude-code

Co potrafi agent

174 narzędzi, ułożonych według produktów.

Lista jest generowana z kodu serwera MCP, więc zawsze odpowiada temu, co agent faktycznie zobaczy. Token z ograniczonymi zakresami widzi tylko te narzędzia, które może wywołać.

Organizacje i projekty 25 Postgres 19 Edge Functions i sekrety 8 Workers 31 Sites 27 Sandboxes 7 Aplikacje 1-klik (60) 7 Email 6 AI Gateway 13 Ruch, WAF i sieć 14 Feature Flags i config-as-code 5 Monitoring, koszty i limity 12

Organizacje i projekty25 narz.

list_organizations
Lista organizacji HostBase, do których należy użytkownik.
list_projects
Lista wszystkich projektów (baz danych) użytkownika we wszystkich organizacjach.
get_project
Szczegóły projektu: status, region, rozmiar instancji, URL API.
create_project
Tworzy nowy projekt Postgres/Supabase w wybranej organizacji i regionie.
get_project_keys
Zwraca URL API i publiczny klucz anon projektu.
pause_project
Wstrzymuje aktywny projekt (wymaga roli owner/admin).
restore_project
Wznawia wstrzymany projekt (wymaga roli owner/admin).
delete_project
Trwale usuwa projekt wraz z bazą danych, plikami i funkcjami (wymaga roli owner/admin).
list_custom_domains
Własne domeny API projektu ze statusem certyfikatu (pending/active/error) i stanem rekordu DNS (CNAME → <ref>.host.ulewicz.space).
add_custom_domain
Dodaje własną domenę API (np.
remove_custom_domain
Usuwa własną domenę z projektu (routing i certyfikat).
move_project
Przenosi projekt do innego regionu (ten sam ref, URL i klucze).
get_move_status
Stan ostatniego przenoszenia projektu między regionami: krok, błąd, ostrzeżenia, czasy.
list_templates
Szablony projektów (SaaS multi-tenant, blog/CMS, sklep, czat AI z RAG, czat Realtime, lista zadań): tabele, funkcje SQL, Edge Functions, buckety i wy…
apply_template
Stosuje szablon w aktywnym projekcie: rozszerzenia, migracje (historia supabase_migrations), Storage/Realtime, Edge Functions.
get_import_status
Stan ostatniego importu z Supabase/Postgresa do projektu: krok, postęp, log, błąd.
list_toolsets
Pokazuje grupy narzędzi (toolsets) tego serwera MCP i które są teraz aktywne.
create_upload
Tworzy jednorazowy, ważny 15 minut adres do wysłania lokalnych plików (tar.gz lub zip, do 24 MB) bez przepuszczania ich przez kontekst modelu.
search_docs
Przeszukuje dokumentację HostBase (strony docs + llms.txt) i zwraca najtrafniejsze fragmenty z linkami.
get_project_context
Zestaw informacji do ugruntowania agenta o projekcie w jednym wywołaniu: adresy (API, Studio), publiczny klucz anon, schemat (tabele i kolumny), Edge…
generate_types
Generuje typy TypeScript (zgodne z `supabase gen types typescript`) z aktualnego schematu bazy.
get_logs
Logi z jednego miejsca: service = db | auth | rest | realtime | storage | functions | api-gw | meta (stos Supabase) albo site | worker | app (wymaga…
run_sql
Wykonuje SQL na bazie projektu.
list_migrations
Historia migracji projektu (supabase_migrations.schema_migrations): wersja, nazwa, liczba instrukcji.
apply_migration
Stosuje migrację SQL atomowo (jedna transakcja) i zapisuje ją w historii.

Postgres — gałęzie, PITR, repliki, upgrade19 narz.

execute_sql
Wykonuje zapytanie SQL na bazie Postgres projektu (wymaga roli owner/admin/developer).
list_branches
Gałęzie bazy projektu: main (produkcja) i gałęzie podglądowe ze statusem, trybem (schema/data) i URL API.
create_branch
Tworzy gałąź bazy z main projektu: osobny stos Supabase z własnym URL i kluczami.
delete_branch
Usuwa gałąź (ref lub nazwa) razem z jej bazą.
merge_branch
Scala gałąź do main: wykonuje w main (w jednej transakcji) migracje z supabase_migrations.schema_migrations gałęzi, których main nie ma.
get_pitr
Stan point-in-time recovery projektu: włączone, retencja, okno przywracania (UTC), rozmiar archiwum WAL, backupy bazowe.
restore_pitr
Przywraca CAŁĄ bazę projektu do wskazanego momentu (ISO 8601, w oknie z get_pitr).
list_replicas
Repliki odczytu projektu: region, status, adresy (REST, Postgres) i opóźnienie replikacji (lag).
create_replica
Tworzy replikę odczytu projektu (strumieniowa replikacja Postgresa) w wybranym regionie.
delete_replica
Usuwa replikę odczytu (stack, DNS i slot replikacji na projekcie głównym).
get_autoscaling
Ustawienia autoskalowania compute projektu (min/max rozmiar, cooldown, reguły) i historia zmian rozmiaru.
set_autoscaling
Włącza/wyłącza autoskalowanie compute w granicach min_size..max_size.
import_from_supabase
Importuje bazę z Supabase (lub dowolnego Postgresa) do PUSTEGO projektu HostBase: schemat, dane, opcjonalnie użytkownicy Auth i pliki Storage (przez…
get_postgres_version
Bieżąca wersja Postgresa projektu (obraz, wersja serwera, rozszerzenia), dostępne wersje docelowe (poprawki, wersja główna 15→17, wariant hb1), zapla…
check_postgres_upgrade
Raport zgodności przed aktualizacją Postgresa (nic nie zmienia): dostępność rozszerzeń, typy reg*, tabele UNLOGGED, repliki, miejsce na dysku, szacow…
upgrade_postgres
Aktualizuje Postgresa projektu do wersji `to`.
cancel_postgres_upgrade
Anuluje zaplanowaną (jeszcze nierozpoczętą) aktualizację Postgresa.
confirm_postgres_upgrade
Potwierdza zakończoną aktualizację główną: usuwa stary katalog danych (po tym nie można już wycofać).
rollback_postgres_upgrade
Wycofuje niepotwierdzoną aktualizację główną do poprzedniego katalogu danych.

Edge Functions i sekrety8 narz.

list_edge_functions
Lista Edge Functions projektu (nazwa, wersja, verify_jwt, adres URL).
get_edge_function
Zwraca kod źródłowy (pliki) i konfigurację Edge Function.
deploy_edge_function
Tworzy lub aktualizuje Edge Function (Deno, TypeScript).
delete_edge_function
Usuwa Edge Function (wymaga roli owner/admin/developer).
list_function_secrets
Lista nazw sekretów Edge Functions projektu (wartości nie są zwracane).
set_function_secrets
Ustawia sekrety (zmienne środowiskowe) Edge Functions, np.
list_edge_function_versions
Historia wdrożeń Edge Function: numer wersji, data, autor, opis zmiany, rozmiar.
rollback_edge_function
Przywraca kod wskazanej wersji Edge Function (wdraża go jako nową wersję).

Workers — backend i zadania31 narz.

list_workers
Lista workerów projektu (ciężkie, długo działające kontenery): status, typ, środowisko, rozmiar, repliki, adres.
get_worker
Szczegóły workera: status, wersje (build/aktywna), ostatnie uruchomienia (cron), zmienne środowiskowe.
deploy_worker
Tworzy lub aktualizuje workera i buduje jego obraz (asynchronicznie — sprawdź status przez get_worker, błędy budowania przez get_worker_logs z build=…
list_worker_templates
Galeria gotowych szablonów workerów (FastAPI, Stripe webhook, OCR, scraper Playwright, boty, Rust Axum, Spring Boot, Laravel, Rails, .NET, ...).
deploy_worker_template
Wdraża gotowy szablon workera jako nowy worker (jedno wywołanie).
move_worker
Przenosi workera między serwerem bazodanowym (local) a dedykowanym serwerem workerów (dedicated) bez przerwy (nowa instancja jest budowana i sprawdza…
worker_action
Steruje workerem: start, stop, restart, run (cron — uruchom teraz), scale (replicas 0-10; autoskalowanie przez workers_scale), activate (version — pr…
get_worker_logs
Logi workera (stdout/stderr wszystkich replik, najnowsze na końcu).
delete_worker
Usuwa workera (kontenery, obrazy i adres).
workers_scale
Skaluje workera.
worker_config_set
Zmienia konfigurację workera bez przebudowy: health ({type: http|tcp|command|none, path, command, interval_s, timeout_s, failures, start_period_s}),…
worker_jobs_run
Uruchamia jednorazowe zadanie na obrazie workera (migracja, backfill, raport).
worker_jobs_list
Historia zadań workera (name) albo całego projektu (bez name): status, próba, kod wyjścia, czas.
worker_job_logs
Logi zadania workera (zachowane po zakończeniu).
worker_volume_set
Tworzy lub powiększa trwały wolumen workera (1-50 GB) zamontowany w /data.
worker_volume_delete
Usuwa wolumen workera razem z danymi (nieodwracalne).
worker_events
Dziennik zdarzeń workera: skalowanie, wybudzenia, zimne starty (ms), OOM, restarty, zadania.
worker_generate
Generuje (bez wdrażania) workera z opisu w języku naturalnym: kod, zależności, schemat zmiennych env i testy, w wybranym środowisku.
worker_db_trigger_create
Tworzy trigger bazodanowy: zdarzenia INSERT/UPDATE/DELETE na tabeli trafiają do kolejki pgmq (tworzonej w razie potrzeby), z której czyta worker typu…
list_worker_db_triggers
Lista triggerów bazodanowych utworzonych przez Workers (prefiks hb_wt_): tabela, kolejka, definicja.
worker_db_trigger_delete
Usuwa trigger bazodanowy Workers (name musi zaczynać się od hb_wt_) razem z jego funkcją.
worker_workflows
Trwałe workflowy na Postgresie (schemat hostbase_workflows, kolejka pgmq hb_workflows; wykonuje je worker z SDK - szablony workflows-node / workflows…
list_worker_workflow_runs
Przebiegi trwałych workflowów (status, kroki).
get_worker_insights
Inteligentne sugestie dla workerów projektu: zmiana rozmiaru, scale-to-zero i redukcja replik z szacunkiem oszczędności (zł/mies.), przyczyny pętli r…
workers_deploy_image
Wdraża gotowy obraz Docker (Docker Hub, GHCR, dowolny rejestr) jako workera — bez budowania.
get_worker_image_info
Pobiera obraz na serwer danych (opcjonalnie z danymi logowania do rejestru) i zwraca rozmiar, wystawione porty, użytkownika, entrypoint i ostrzeżenia.
workers_import
Konwertuje definicję usługi z innej platformy na workera: Procfile + app.json (Heroku/Dokku), render.yaml, railway.json/toml, fly.toml, docker-compos…
workers_deploy_git_url
Tworzy workera z publicznego repozytorium Git (github.com, gitlab.com, bitbucket.org, codeberg.org) — pobiera archiwum wskazanej gałęzi/tagu i podkat…
workers_git_link
Łączy workera z repozytorium GitHub projektu (Integracje → GitHub): push do gałęzi wdraża nową wersję, PR dostaje własny worker podglądowy <worker>-p…
workers_transfer
Przenosi workera: do innego projektu tej samej organizacji (target_ref; kopiuje kod, konfigurację i zmienne, zwraca raport co skopiowano i co wymaga…
workers_replay
Przechwytywanie i odtwarzanie żądań workera HTTP.

Sites — strony i aplikacje web27 narz.

site_automation
Konfiguracja automatyzacji witryny (jak hostbase.json): pipeline (preBuild, postBuild, preDeploy, postDeploy z krokami smoke/sql/script/webhook, cach…
site_env_groups
Grupy zmiennych środowiskowych witryny (production, preview, development; wartości sekretne są maskowane).
site_pipeline_runs
Przebiegi potoku wdrożeniowego witryny (kroki: build, kontrole, pre-deploy, promocja, smoke po wdrożeniu, nadzór 5xx, rollback).
site_scripts
Skrypty witryny uruchamiane w obrazie budowania (np.
site_checks
Kontrole jakości wdrożenia: Lighthouse (wydajność, dostępność, SEO, dobre praktyki), zrzut ekranu i różnice wizualne vs produkcja (pixelmatch).
site_rum
Opcjonalny znacznik Web Vitals (RUM) witryny: action=get zwraca fragment <script>, set (enabled) włącza lub wyłącza zbieranie LCP/CLS/INP/FCP/TTFB.
site_platform
Konfiguracja platformy witryny (v23): protection {mode none|password|sso, scope previews|all, password}, maintenance {enabled,title,message,retry_aft…
site_rules_test
Tester reguł witryny: co zrobi bramka dla żądania {url, country?, device?, cookies?, headers?, random?, config?}.
site_freeze
Zamrożenie wdrożeń produkcyjnych witryny (rollback nadal działa).
site_notifications
Powiadomienia i alerty witryny: notify_ready/failed/promoted/comments, bw_limit_gb, revalidate_url/secret.
site_comments
Komentarze przypięte w podglądach witryny.
site_revalidate
Rewalidacja na żądanie (ISR / CDN): paths ["/blog"], tags, all.
site_import
Migracja z Vercel / Netlify / Cloudflare Pages.
site_cutover
Instrukcja przełączenia DNS dla domen witryny (rekordy do ustawienia, aktualny stan, status TLS) — po imporcie lub przeniesieniu.
site_move
Przenieś witrynę do innego projektu / regionu (np.
list_sites
Lista witryn projektu (Sites): status, typ (static/ssr), framework, adres produkcyjny <witryna>-<ref>.host.ulewicz.space, domeny i ostatnie wdrożenia.
get_site
Szczegóły witryny: ustawienia, zmienne środowiskowe, domeny oraz lista wdrożeń (id dN, status, cel production/preview, adres podglądu, błąd).
deploy_site
Tworzy wdrożenie witryny (asynchronicznie — sprawdzaj get_site, błędy przez get_site_logs z build=true).
promote_site_deployment
Ustawia wdrożenie jako produkcyjne (awans podglądu albo natychmiastowy rollback do starszego wdrożenia dN).
site_action
Akcje witryny: redeploy (przebuduj ostatni kod z aktualnymi zmiennymi), restart (SSR), delete_deployment (deployment=dN), wake (obudź uśpiony podgląd…
get_site_logs
Logi witryny: build=true zwraca log budowania wdrożenia (deployment=dN, domyślnie najnowsze); inaczej logi działającej aplikacji SSR.
set_site_env
Zastępuje zmienne środowiskowe witryny ({NAZWA: wartość}).
site_domains
Własne domeny witryny: action=list|add|remove (hostname).
site_cdn
CDN witryny (Cloudflare proxy, pomarańczowa chmurka): action=status (domyślnie)|enable|disable|purge|analytics.
get_site_analytics
Statystyki witryny z logów dostępu: żądania, transfer, kody statusu, najpopularniejsze strony i zasoby.
site_deploy_hook
Hook wdrożeniowy witryny (URL do wywołania POST z CI/CMS): action=get (domyślnie), create (utwórz lub zrotuj), delete.
delete_site
Usuwa witrynę wraz ze wszystkimi wdrożeniami, domenami i hookiem.

Sandboxes — uruchamianie kodu7 narz.

create_sandbox
Tworzy izolowany sandbox (microVM Kata/Cloud Hypervisor, opcjonalnie gVisor) do bezpiecznego wykonywania kodu.
list_sandboxes
Lista sandboxów projektu (stan, szablon, zasoby, czas wygaśnięcia).
sandbox_exec
Wykonuje polecenie powłoki w sandboxie (bash -c) i zwraca exit_code, stdout i stderr.
sandbox_run_code
Uruchamia fragment kodu w sandboxie jak komórkę Jupytera.
sandbox_write_file
Zapisuje plik w sandboxie (tworzy katalogi).
sandbox_read_file
Odczytuje plik z sandboxa jako tekst UTF-8 (do 200 kB; większe są obcięte).
close_sandbox
Zamyka sandbox i usuwa jego maszynę, dysk i sieć (kończy naliczanie opłat).

Aplikacje 1-klik (60)7 narz.

list_app_catalog
Katalog ~60 aplikacji 1-klik (autoinstalatory) w 14 kategoriach (BI, CMS, wiki, Git, auth, AI, CRM…): cena PLN/mies., RAM, licencja, popularność i li…
list_apps
Aplikacje 1-klik zainstalowane w projekcie: status, wersja, adres HTTPS, host, cena, rola bazy.
get_app
Szczegóły zainstalowanej aplikacji 1-klik (status, wersje do aktualizacji, licencja, rola bazy).
install_app
Instaluje aplikację 1-klik w projekcie (kontener pod https://<app>-<ref>.host.ulewicz.space, połączony z Postgresem projektu rolą o minimalnych upraw…
app_action
Steruje aplikacją 1-klik: start, stop, restart, upgrade (version — aktualizacja/zmiana przypiętej wersji).
get_app_logs
Logi kontenerów aplikacji 1-klik (najnowsze na końcu).
remove_app
Usuwa aplikację 1-klik: kontenery, rola i schemat w bazie oraz dane aplikacji.

Email6 narz.

get_email_overview
Usługa Email projektu: wysłane/dostarczone/zwroty z 30 dni, wykorzystanie limitu dziennego i miesięcznego planu, stan reputacji (ok/warning/critical).
list_email_domains
Domeny nadawcy Email z rekordami DNS (DKIM, SPF, return-path, DMARC) i ich stanem weryfikacji.
add_email_domain
Dodaje domenę nadawcy (generuje klucz DKIM) i zwraca rekordy DNS do opublikowania.
verify_email_domain
Sprawdza w DNS rekordy domeny nadawcy i aktualizuje jej status.
list_email_messages
Ostatnie wiadomości wysłane przez usługę Email (status, odbiorcy, temat).
list_email_suppressions
Lista wyłączeń Email: adresy pomijane przy wysyłce (twarde zwroty, skargi, ręczne).

AI Gateway13 narz.

get_ai_gateway
AI Gateway projektu: adres bramki zgodnej z OpenAI (base_url), skonfigurowani dostawcy (klucze nigdy nie są zwracane), liczba kluczy, ustawienia (cac…
get_ai_gateway_usage
Zużycie AI Gateway: żądania, tokeny, szacowany koszt, p50/p95, cache hit-rate, błędy wg dostawcy i modelu.
list_ai_gateway_keys
Klucze bramki AI (prefiks, zakresy, limit rpm, budżet, wydatki w miesiącu).
create_ai_gateway_key
Tworzy klucz bramki AI (hbai_…).
revoke_ai_gateway_key
Unieważnia klucz bramki AI (natychmiast przestaje działać).
set_ai_provider
Konfiguruje dostawcę LLM (BYOK) dla bramki AI: kind = anthropic | openai | mistral | custom (OpenAI-compatible, wymaga base_url i models) | mock.
delete_ai_provider
Usuwa dostawcę z bramki AI (wraz z zaszyfrowanym kluczem).
set_ai_gateway_settings
Ustawienia bramki AI: pii (redakcja PESEL/e-mail/telefon), cache_ttl_seconds (0 = wyłączony), retention_days, log_bodies, budget_usd (miesięczny budż…
list_ai_gateway_evals
Evals AI Gateway: zestawy przypadków testowych i ostatnie uruchomienia (porównanie modeli: jakość, koszt, opóźnienie).
create_ai_gateway_eval_set
Tworzy/aktualizuje zestaw evals.
run_ai_gateway_eval
Uruchamia eval w tle na wielu modelach (zużywa tokeny u Twoich dostawców BYOK).
get_ai_gateway_eval_run
Wynik uruchomienia evals: status/postęp, podsumowanie per model (średnia ocena, zaliczone, opóźnienia, koszt) oraz wyniki per przypadek.
get_ai_gateway_end_users
Zużycie AI Gateway per użytkownik końcowy (nagłówek x-hb-user) w tym miesiącu: żądania, tokeny, szacowany koszt.

Ruch, WAF i sieć14 narz.

get_traffic
Ruch projektu z logu dostępowego brzegu: żądania, klasy statusów, bajty, opóźnienia p50/p95/p99 per usługa (rest/auth/storage/realtime/functions/api,…
get_waf
Konfiguracja zapory WAF projektu (Coraza + OWASP CRS): mode (off | detect | block), paranoia 1-4, wyjątki reguł per ścieżka, reguły własne (IP/CIDR,…
set_waf
Zmienia ustawienia WAF (scalane z bieżącymi — podaj tylko to, co zmieniasz).
list_waf_events
Ostatnie zdarzenia WAF (id reguły, komunikat, zredagowane dopasowane dane, IP, ścieżka, akcja blocked/detected/limited/banned).
get_waf_stats
Statystyki WAF: serie czasowe (żądania, zablokowane, wykryte, limity, bany), top reguły / adresy IP / ścieżki.
list_waf_bans
Aktywne bany adresów IP (automatyczne po wielu nieudanych logowaniach oraz ręczne).
ban_ip
Ręcznie banuje adres IP w projekcie (blokuje całe API) na duration_s sekund (domyślnie 3600).
unban_ip
Zdejmuje ban z adresu IP (także automatyczny po nieudanych logowaniach).
get_static_egress
Statyczny adres IP ruchu wychodzącego projektu (Edge Functions, pg_net, Workers) — do allowlist u partnerów.
set_static_egress
Włącza/wyłącza dedykowany statyczny adres IP ruchu wychodzącego projektu (płatny dodatek, plan Pro+).
get_network_restrictions
Lista adresów IP/CIDR, z których wolno łączyć się bezpośrednio z Postgresem (:5432) i poolerem (:6543).
set_network_restrictions
Zastępuje listę dozwolonych adresów (IPv4/IPv6, CIDR; maks.
get_rate_limits
Reguły limitów żądań w bramce API projektu: path_prefix (/rest/v1, /auth/v1/token…), rps (tempo), burst (zapas), scope (ip | global).
set_rate_limits
Zastępuje wszystkie reguły limitów API (maks.

Feature Flags i config-as-code5 narz.

list_feature_flags
Lista Feature Flags projektu wraz ze stanem w środowiskach (production, staging, development).
get_feature_flag
Pełna definicja flagi: warianty, reguły (atrybuty, wdrożenia procentowe) i konfiguracja każdego środowiska.
set_feature_flag
Włącza lub wyłącza flagę w wybranym środowisku (kill-switch).
config_plan
Config-as-code: porównuje obiekt konfiguracji (jak z hostbase.config.ts: autoscaling, network, rateLimits, domains, secrets, functions, workers, feat…
config_apply
Config-as-code: stosuje konfigurację (najpierw wywołaj config_plan i pokaż plan użytkownikowi).

Monitoring, koszty i limity12 narz.

list_issues
Błędy z Edge Functions i Workerów zgrupowane według odcisku (typ, komunikat, stack).
get_issue
Szczegóły issue: stack trace, ostatnie wystąpienia i agent_context — gotowy brief w markdown (stack, logi, ostatni deploy) do naprawy przez agenta.
set_issue_status
Zmienia status issue: resolved (wraca jako open, jeśli błąd się powtórzy), ignored albo open.
list_monitors
Syntetyczne monitory HTTP projektu: stan, dostępność, pozostały budżet błędów SLO, p95 czasu odpowiedzi.
create_monitor
Tworzy monitor HTTP (interwał 60/300/900/1800/3600 s, oczekiwany status np.
delete_monitor
Usuwa monitor HTTP wraz z historią sprawdzeń.
get_runtime_advisors
Health Check Advisors na żywo: odsetek 5xx API, saturacja połączeń, lag replik, zapełnienie dysku, nieudane kopie — z poziomem severity.
get_org_costs
Eksplorator kosztów organizacji (PLN netto): koszt per usługa / projekt / dzień, prognoza na koniec miesiąca, porównanie z poprzednim miesiącem.
get_org_credits
Saldo kredytów prepaid organizacji (PLN brutto): pule, daty wygaśnięcia i ostatnie operacje księgi.
list_spend_limits
Limity wydatków organizacji i projektów wraz ze zużyciem (alerty 50/80/100%).
set_spend_limit
Ustawia miesięczny limit wydatków (PLN netto) dla organizacji lub projektu.
delete_spend_limit
Usuwa limit wydatków organizacji (bez project) lub wskazanego projektu.

Galeria promptów

Skopiuj. Wklej do agenta. Patrz, jak działa.

Przykłady, od których warto zacząć. Pod każdym widać narzędzia MCP, których agent użyje.

Zbuduj sklep z koszykiem na Next.js i Postgresie, wdróż go i podaj mi link.
create_projectexecute_sqlset_site_envdeploy_siteget_site_logs
Dodaj logowanie przez Google do mojej aplikacji i powiedz, co mam wkleić w panelu.
get_project_keysset_site_envdeploy_site
Zrób landing page dla mojej firmy z formularzem kontaktowym zapisującym leady w bazie i podepnij domenę moja-firma.pl.
deploy_siteexecute_sqlsite_domains
Postaw workera, który co noc robi raport PDF z zamówień i wysyła go mailem.
deploy_workerworker_config_setadd_email_domainworker_jobs_runget_worker_logs
Zrób RAG nad moimi PDF-ami: wgrywam pliki, a czat odpowiada z cytatami.
execute_sqldeploy_workerdeploy_edge_functioncreate_ai_gateway_keyset_function_secrets
Dodaj webhook Stripe, który po płatności zmienia status zamówienia i wysyła potwierdzenie.
list_worker_templatesdeploy_worker_templateset_function_secretsexecute_sql
Przetestuj tę migrację na gałęzi bazy, a jeśli przejdzie, scal ją na produkcję.
create_branchexecute_sqlmerge_branch
Przenieś mój projekt z Supabase do HostBase i sprawdź, czy dane się zgadzają.
import_from_supabaseget_import_statusexecute_sql
Postaw Metabase połączony z moją bazą i zrób dashboard sprzedaży.
list_app_cataloginstall_appexecute_sql
Napisz i uruchom skrypt w Pythonie, który czyści ten CSV — w piaskownicy, nie u mnie.
create_sandboxsandbox_write_filesandbox_run_codesandbox_read_fileclose_sandbox
Zrób chatbota na Edge Function z kluczem AI Gateway i limitem budżetu 50 zł miesięcznie.
create_ai_gateway_keyset_ai_gateway_settingsdeploy_edge_functionset_function_secrets
Wdróż nową wersję za feature flagą i włącz ją najpierw dla 10% użytkowników.
set_feature_flagdeploy_siteget_site_analytics
Dlaczego strona zwalnia? Zajrzyj w logi i doradców, a potem zaproponuj poprawkę.
get_site_logsget_runtime_advisorslist_issuesget_worker_logs
Zablokuj boty skanujące /wp-admin i ustaw limit zapytań na API.
set_waflist_waf_eventsban_ipset_rate_limits
Ktoś skasował tabelę o 14:32 — przywróć bazę do 14:31.
get_pitrrestore_pitr

Bezpieczeństwo

Agent dostaje dokładnie tyle, ile mu dasz.

Dajesz agentowi shell i deploy, więc kontrola jest częścią produktu: zakresy, role, ograniczone tokeny i izolacja kodu.

Tokeny z zakresami

PAT z presetem „Agent AI” (bez usuwania projektów, przywracania kopii i rotacji kluczy) albo własny zestaw uprawnień. Token można przypiąć do jednej organizacji lub jednego projektu i ustawić termin ważności.

OAuth 2.1 i ekran zgody

Klienci rejestrują się dynamicznie (DCR), a Ty widzisz listę zakresów i zatwierdzasz je w przeglądarce. Dostęp cofniesz jednym kliknięciem.

Role per projekt

Agent nie obejdzie ról: owner, admin, developer. Wywołania SQL, deploy i usuwanie są sprawdzane z rolą właściciela tokenu.

Tryb tylko do odczytu

Preset „Tylko odczyt” i zakresy *:read dają agentowi wgląd w projekty, logi i metryki bez prawa zmian. Idealne do diagnozy.

Dziennik audytu

Tworzenie i unieważnianie tokenów oraz każda odmowa dostępu agenta (zakres, rola, adres IP) trafiają do dziennika audytu organizacji.

Sandboxes dla kodu

Kod, którego nie znasz, agent uruchamia w izolowanym Sandboxie, a nie na Twojej maszynie ani w bazie. Limity zasobów i czasu są wbudowane.

Zakresy OAuth zatwierdzane przy połączeniu22

projects:read — Odczyt projektów, organizacji, ustawień (sieć, domeny, PITR, skalowanie)
projects:write — Tworzenie, wstrzymywanie, usuwanie i konfiguracja projektów, klucze API
db:read — Odczyt danych SQL (tylko SELECT), migracje i typy - bez zapisu
db:write — Wykonywanie zapytań SQL na bazie projektu (odczyt i zapis)
sites:read — Odczyt Sites (lista, wdrożenia, logi)
sites:write — Wdrażanie i konfiguracja Sites (pliki z terminala, zmienne, domeny)
functions:read — Odczyt Edge Functions i listy sekretów
functions:deploy — Wdrażanie, wycofywanie i usuwanie funkcji; ustawianie sekretów
workers:read — Odczyt Workers i ich logów
workers:write — Wdrażanie, skalowanie i sterowanie Workers
branches:read — Odczyt gałęzi bazy danych
branches:write — Tworzenie, scalanie i usuwanie gałęzi
email:read — Odczyt modułu Email
email:write — Konfiguracja domen Email
ai:read — Odczyt AI Gateway i zużycia
ai:write — Zarządzanie kluczami i dostawcami AI Gateway
sandboxes:read — Odczyt Sandboxes (lista, metryki, logi)
sandboxes:write — Uruchamianie kodu w izolowanych Sandboxes (exec, pliki, terminal)
flags:read — Odczyt Feature Flags
flags:write — Zmiana Feature Flags
config:read — Podgląd planu config-as-code
config:write — Zastosowanie config-as-code

Skills i AGENTS.md

Nauczmy agenta HostBase raz, w repozytorium.

CLI zapisuje w projekcie umiejętność dla Claude Code, regułę Cursora i blok w AGENTS.md (Codex i inni) — z numerem projektu, komendami i dobrymi praktykami. Agent zaczyna pracę z kontekstem.

CLI zapisuje konfigurację dla Claude Code, Cursora i Codexa. Pozostałych klientów konfigurujesz snippetami powyżej.

Dokumentacja: agenci i config-as-code

hostbase CLI

hostbase mcp install     # konfiguracja MCP: Claude Code, Cursor, Codex
hostbase skills install  # SKILL.md, reguła Cursora, blok AGENTS.md
hostbase init            # AGENTS.md + CLAUDE.md z numerem projektu

Dla maszyn

FAQ

Pytania o agentów i MCP

Czy mój agent musi obsługiwać MCP?

Tak, ale prawie każdy współczesny agent go obsługuje. Dla pozostałych masz Management API (OpenAPI) i plik llms.txt.

OAuth czy token PAT?

OAuth jest wygodniejszy i bezpieczniejszy: zero sekretów w plikach, zgoda na ekranie. Token PAT wybierz w CI, na serwerach bez przeglądarki lub gdy klient nie obsługuje OAuth dla zdalnych serwerów.

Czy agent może usunąć mi bazę?

Tylko jeśli mu na to pozwolisz. Preset „Agent AI” nie daje usuwania projektów, a delete_project wymaga dodatkowo podania dokładnej nazwy projektu. Do diagnozy użyj trybu tylko do odczytu.

Gdzie działa kod napisany przez agenta?

Strony w Sites, backendy w Workers, funkcje w Edge Functions, a doraźne skrypty w Sandboxes. Wszystko w Twoim projekcie, w UE.

Ile to kosztuje?

Serwer MCP jest bezpłatny i dostępny na każdym planie. Płacisz za zasoby, które agent uruchomi (projekt, worker, aplikacje) — według cennika.

Mój klient nie ma tu swojej zakładki.

Dowolny klient MCP z obsługą Streamable HTTP połączysz adresem serwera i nagłówkiem Authorization. Jeśli klient zna tylko stdio, użyj mostu npx mcp-remote.

Załóż konto, utwórz token, połącz agenta.

Trzy kroki i pierwsze wdrożenie od agenta w kilka minut. Bez karty kredytowej.

Zacznij projekt Porozmawiaj z nami