Dokumentacja /

Agenci AI

Agenci do kodowania (Claude Code, Cursor, Codex i inni) wdrażają tym samym CLI co ludzie, a asystenci czatu bez systemu plików wdrażają przez zdalny serwer MCP. Ta strona pokazuje, jak skonfigurować każdego z nich.

npx -y lobsite --yes

Jak działa tryb agenta

CLI rozpoznaje, że działa pod agentem, po zmiennych ustawianych przez agentów: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT i AGENT. Ustaw LOBSITE_AGENT=<name>, aby wskazać innego agenta, albo LOBSITE_AGENT=0, aby wyłączyć tryb agenta. Pod agentem:

• Nic nigdy nie jest pytane. Pierwsze wdrożenie folderu wypisuje podsumowanie i działa dalej; polecenia, których nie da się cofnąć, wymagają --yes.
• Nie ma kolorów, animacji, kodów QR ani kopiowania do schowka, tylko zwykłe linie.
• Wdrożenie kończy się linią przeznaczoną do przekazania przez agenta:

Tell the user: the site is live at https://quiet-fox-4821.lobsite.app. It's temporary and is removed in 6h. To keep it, open https://lobsite.com/claim/quiet-fox-4821#lob_claim_… and sign in (free).

Strony wdrożone bez konta działają 6 godzin. Link do przejęcia zachowuje stronę: osoba otwiera go i się loguje, bez dotykania terminala. Ponowne uruchomienie tego samego polecenia aktualizuje tę samą stronę, bo lobsite.toml ją pamięta.

Claude Code

Claude Code może wdrażać samym poleceniem powłoki. Aby za każdym razem używał Lobsite, dodaj linię do CLAUDE.md w projekcie:

Deploy with `npx -y lobsite --yes` and relay the "Tell the user:" line from the output.

Albo dodaj serwer MCP, który daje Claude narzędzia do wdrażania, listowania stron i wdrożeń, wycofywania i publikowania:

claude mcp add lobsite -- npx -y lobsite@latest mcp

Cursor

Dodaj serwer MCP do .cursor/mcp.json:

{ "mcpServers": { "lobsite": { "command": "npx", "args": ["-y", "lobsite@latest", "mcp"] } } }

Albo dodaj regułę projektu w .cursor/rules/ z sekcją z AGENTS.md.

Codex i inni agenci

Codex i inni agenci czytający AGENTS.md korzystają z sekcji takiej jak ta. Wklej ją do AGENTS.md w projekcie:

## Deploying

This site deploys with [Lobsite](https://lobsite.com). Build it, then from the project folder run:

```bash
npx -y lobsite --yes
```

- Tell the user the URL, and relay the "Tell the user:" line from the output word for word.
- Sites deployed without logging in are removed after 6 hours. The claim link in the output keeps the site; the user opens it and signs in.
- `lobsite.toml` remembers the site, so the same command updates it. Use `--preview` to deploy without changing the live site, and `--json` for machine-readable output.
- If a deploy fails, follow the fix in the error message. Never pass `--include-secrets`.

Każdy agent obsługujący MCP przez stdin/stdout może zamiast tego uruchomić npx -y lobsite@latest mcp.

ChatGPT i Claude.ai

Asystenci czatu piszą strony, ale nie mają folderu do wdrożenia. Dodaj Lobsite jako własny konektor (serwer MCP) z tym adresem URL:

https://lobsite.com/api/mcp

Używa Streamable HTTP i ma jedno narzędzie, deploy_files, które przyjmuje zawartość plików. Potem poproś asystenta o opublikowanie strony. Strony wdrożone w ten sposób nie mają konta: odpowiedź zawiera link do przejęcia, który pozwala je zachować.

Bez Node: curl

Tam, gdzie npx nie działa, jedno polecenie curl wdraża stronę lub kilka plików i odpowiada adresem URL, linkiem do przejęcia oraz informacją, jak zaktualizować stronę:

curl --data-binary @index.html https://lobsite.com/api/v1/drop
curl -F index.html=@index.html -F css/site.css=@site.css https://lobsite.com/api/v1/drop

Aby zaktualizować tę samą tymczasową stronę, przekaż jej nazwę i token przejęcia z pierwszej odpowiedzi:

curl --data-binary @index.html -H "Authorization: Bearer lob_claim_…" "https://lobsite.com/api/v1/drop?site=quiet-fox-4821"

?preview=1 wdraża bez zmieniania działającej strony. Bezpośrednie wdrożenie mieści do 25 MB. Dodaj ?format=json, aby dostać odpowiedź w JSON.

Narzędzia MCP

Narzędzia lokalne uruchamiają polecenia CLI z --json --yes i przyjmują path, czyli folder projektu (domyślnie folder, w którym uruchomiono serwer). deploy odpowiada najpierw linią „Tell the user”. Logowanie i usuwanie stron nie są narzędziami: pierwsze wymaga osoby w przeglądarce, drugiego nie da się cofnąć.

Wynik w JSON

--json wypisuje jeden obiekt JSON na stdout, a logi na stderr:

{
  "site": "quiet-fox-4821",
  "deploy_id": "d7k2m9qa",
  "url": "https://quiet-fox-4821.lobsite.app",
  "preview_url": "https://d7k2m9qa--quiet-fox-4821.lobsite.app",
  "live": true,
  "expires_at": "2026-10-13T16:20:38Z",
  "claim_url": "https://lobsite.com/claim/quiet-fox-4821#lob_claim_…",
  "files": { "total": 42, "uploaded": 3 },
  "bytes_uploaded": 14336,
  "duration_ms": 812
}

claim_url i expires_at są null dla stron z kontem. Niepowodzenie to { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Rozgałęziaj logikę po code, który nigdy się nie zmienia (zobacz Błędy), i ponawiaj tylko wtedy, gdy retryable ma wartość true.