Doku /

KI-Agenten

Coding-Agenten (Claude Code, Cursor, Codex und andere) deployen mit derselben CLI wie Menschen, und Chat-Assistenten ohne Dateisystem deployen über einen Remote-MCP-Server. Diese Seite zeigt, wie du jeden davon einrichtest.

npx -y lobsite --yes

Wie der Agentenmodus funktioniert

Die CLI erkennt an den Variablen, die Agenten setzen, dass sie unter einem Agenten läuft: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT und AGENT. Setz LOBSITE_AGENT=<name>, um einen anderen Agenten zu benennen, oder LOBSITE_AGENT=0, um den Agentenmodus auszuschalten. Unter einem Agenten gilt:

• Es wird nie etwas gefragt. Das erste Deploy eines Ordners gibt seine Zusammenfassung aus und macht weiter; Befehle, die sich nicht rückgängig machen lassen, brauchen --yes.
• Es gibt keine Farben, Spinner, QR-Codes oder Kopien in die Zwischenablage, nur schlichte Zeilen.
• Ein Deploy endet mit einer Zeile, die der Agent weitergeben soll:

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

Ohne Konto deployte Websites halten 6 Stunden. Der Übernahme-Link behält die Website: Die Person öffnet ihn und meldet sich an, ohne ein Terminal anzufassen. Derselbe Befehl aktualisiert beim nächsten Mal dieselbe Website, weil lobsite.toml sie sich merkt.

Claude Code

Claude Code kann allein mit dem Shell-Befehl deployen. Damit es jedes Mal Lobsite nutzt, füg der CLAUDE.md des Projekts eine Zeile hinzu:

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

Oder füg den MCP-Server hinzu, der Claude Tools zum Deployen, Auflisten von Websites und Deploys, Zurückrollen und Live-Schalten gibt:

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

Cursor

Füg den MCP-Server zu .cursor/mcp.json hinzu:

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

Oder füg in .cursor/rules/ eine Projektregel mit dem Abschnitt aus AGENTS.md hinzu.

Codex und andere Agenten

Codex und die anderen Agenten, die AGENTS.md lesen, übernehmen einen Abschnitt wie diesen. Füg ihn in die AGENTS.md des Projekts ein:

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

Jeder Agent, der MCP über stdin/stdout spricht, kann stattdessen npx -y lobsite@latest mcp ausführen.

ChatGPT und Claude.ai

Chat-Assistenten schreiben Seiten, haben aber keinen Ordner zum Deployen. Füg Lobsite als benutzerdefinierten Connector (einen MCP-Server) mit dieser URL hinzu:

https://lobsite.com/api/mcp

Er spricht Streamable HTTP und hat ein Tool, deploy_files, das den Inhalt der Dateien entgegennimmt. Dann bitte den Assistenten, die Seite online zu stellen. Auf diesem Weg deployte Websites haben kein Konto: Die Antwort enthält den Übernahme-Link, mit dem du sie behältst.

Ohne Node: curl

Wo npx nicht läuft, deployt ein curl-Befehl eine Seite oder ein paar Dateien und antwortet mit der URL, dem Übernahme-Link und der Anleitung, wie man die Website aktualisiert:

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

Um dieselbe temporäre Website zu aktualisieren, übergib ihren Namen und das Übernahme-Token aus der ersten Antwort:

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

?preview=1 deployt, ohne die Live-Website zu ändern. Ein direktes Deploy fasst bis zu 25 MB. Füg ?format=json für eine JSON-Antwort hinzu.

MCP-Tools

Die lokalen Tools führen die CLI-Befehle mit --json --yes aus und nehmen path, den Projektordner (standardmäßig den Ordner, in dem der Server gestartet wurde). deploy antwortet zuerst mit der Zeile „Tell the user“. Anmelden und Websites löschen sind keine Tools: Das eine braucht die Person in einem Browser, das andere lässt sich nicht rückgängig machen.

JSON-Ausgabe

--json gibt ein JSON-Objekt auf stdout aus, mit Logs auf 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 und expires_at sind bei Websites mit Konto null. Ein Fehlschlag ist { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Verzweige anhand von code, das sich nie ändert (siehe Fehler), und wiederhole nur, wenn retryable true ist.