Docs /

AI-agents

Codeeragents (Claude Code, Cursor, Codex en andere) deployen met dezelfde CLI als mensen, en chatassistenten zonder bestandssysteem deployen via een externe MCP-server. Deze pagina laat zien hoe je elk ervan instelt.

npx -y lobsite --yes

Hoe de agentmodus werkt

De CLI weet dat hij onder een agent draait aan de variabelen die agents instellen: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT en AGENT. Stel LOBSITE_AGENT=<name> in om een andere agent te noemen, of LOBSITE_AGENT=0 om de agentmodus uit te zetten. Onder een agent:

• Er wordt nooit iets gevraagd. De eerste deploy van een map drukt zijn samenvatting af en gaat door; opdrachten die niet ongedaan kunnen worden gemaakt, hebben --yes nodig.
• Er zijn geen kleuren, spinners, QR-codes of kopieën naar het klembord, alleen gewone regels.
• Een deploy eindigt met een regel die bedoeld is om door de agent te worden doorgegeven:

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).

Sites die zonder account worden gedeployd, duren 6 uur. De claimlink houdt de site: de persoon opent hem en logt in, zonder een terminal aan te raken. Dezelfde opdracht opnieuw uitvoeren werkt dezelfde site bij, omdat lobsite.toml hem onthoudt.

Claude Code

Claude Code kan met alleen de shellopdracht deployen. Wil je dat het elke keer Lobsite gebruikt, voeg dan een regel toe aan de CLAUDE.md van het project:

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

Of voeg de MCP-server toe, die Claude tools geeft om te deployen, sites en deploys te tonen, terug te draaien en live te zetten:

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

Cursor

Voeg de MCP-server toe aan .cursor/mcp.json:

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

Of voeg in .cursor/rules/ een projectregel toe met de sectie uit AGENTS.md.

Codex en andere agents

Codex en de andere agents die AGENTS.md lezen, nemen een sectie zoals deze over. Plak hem in de AGENTS.md van het project:

## 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`.

Elke agent die MCP via stdin/stdout spreekt, kan in plaats daarvan npx -y lobsite@latest mcp uitvoeren.

ChatGPT en Claude.ai

Chatassistenten schrijven pagina's maar hebben geen map om te deployen. Voeg Lobsite toe als aangepaste connector (een MCP-server) met deze URL:

https://lobsite.com/api/mcp

Hij spreekt Streamable HTTP en heeft één tool, deploy_files, die de inhoud van de bestanden ontvangt. Vraag de assistent daarna de pagina online te zetten. Sites die zo worden gedeployd, hebben geen account: het antwoord bevat de claimlink waarmee je ze houdt.

Zonder Node: curl

Waar npx niet kan draaien, deployt één curl-opdracht een pagina of een paar bestanden en antwoordt met de URL, de claimlink en hoe je de site bijwerkt:

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

Wil je dezelfde tijdelijke site bijwerken, geef dan zijn naam en het claimtoken uit het eerste antwoord mee:

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

?preview=1 deployt zonder de live site te veranderen. Een directe deploy neemt tot 25 MB mee. Voeg ?format=json toe voor een JSON-antwoord.

MCP-tools

De lokale tools voeren de CLI-opdrachten uit met --json --yes en nemen path, de projectmap (standaard de map waarin de server is gestart). deploy antwoordt eerst met de regel ‘Tell the user’. Inloggen en sites verwijderen zijn geen tools: het ene heeft de persoon in een browser nodig, het andere kan niet ongedaan worden gemaakt.

JSON-uitvoer

--json drukt één JSON-object af op stdout, met logs op 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 en expires_at zijn null voor sites met een account. Een mislukking is { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Beslis op basis van code, dat nooit verandert (zie Fouten), en probeer alleen opnieuw als retryable true is.