Dokumentasi /

Agen AI

Agen coding (Claude Code, Cursor, Codex, dan lainnya) melakukan deploy dengan CLI yang sama seperti orang, dan asisten chat tanpa sistem file melakukan deploy melalui server MCP jarak jauh. Halaman ini menunjukkan cara menyiapkan masing-masing.

npx -y lobsite --yes

Cara kerja mode agen

CLI tahu dirinya berjalan di bawah agen dari variabel yang disetel agen: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT, dan AGENT. Setel LOBSITE_AGENT=<name> untuk menyebut agen lain, atau LOBSITE_AGENT=0 untuk mematikan mode agen. Di bawah agen:

• Tidak ada yang ditanyakan. Deploy pertama folder mencetak ringkasan dan lanjut; perintah yang tidak dapat dibatalkan memerlukan --yes.
• Tidak ada warna, spinner, kode QR, atau salinan clipboard, hanya baris biasa.
• Deploy diakhiri baris yang ditulis untuk disampaikan agen:

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

Situs yang di-deploy tanpa akun bertahan 6 jam. Tautan klaim menyimpan situs: orang membukanya dan masuk, tanpa menyentuh terminal. Menjalankan perintah yang sama lagi memperbarui situs yang sama, karena lobsite.toml mengingatnya.

Claude Code

Claude Code dapat melakukan deploy hanya dengan perintah shell. Agar memakai Lobsite setiap kali, tambahkan satu baris ke CLAUDE.md proyek:

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

Atau tambahkan server MCP, yang memberi Claude alat untuk deploy, mencantumkan situs dan deploy, rollback, dan promosi:

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

Cursor

Tambahkan server MCP ke .cursor/mcp.json:

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

Atau tambahkan aturan proyek di .cursor/rules/ dengan bagian dari AGENTS.md.

Codex dan agen lainnya

Codex dan agen lain yang membaca AGENTS.md mengambil bagian seperti ini. Tempelkan ke AGENTS.md proyek:

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

Agen apa pun yang memakai MCP melalui stdin/stdout dapat menjalankan npx -y lobsite@latest mcp sebagai gantinya.

ChatGPT dan Claude.ai

Asisten chat menulis halaman tetapi tidak memiliki folder untuk di-deploy. Tambahkan Lobsite sebagai konektor kustom (server MCP) dengan URL ini:

https://lobsite.com/api/mcp

Server memakai Streamable HTTP dan memiliki satu alat, deploy_files, yang menerima isi file. Lalu minta asisten menayangkan halaman. Situs yang di-deploy dengan cara ini tidak memiliki akun: jawabannya membawa tautan klaim untuk menyimpannya.

Tanpa Node: curl

Di tempat npx tidak dapat berjalan, satu perintah curl melakukan deploy halaman atau beberapa file dan menjawab dengan URL, tautan klaim, dan cara memperbarui situs:

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

Untuk memperbarui situs sementara yang sama, berikan nama dan token klaim dari jawaban pertama:

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

?preview=1 melakukan deploy tanpa mengubah situs aktif. Deploy langsung membawa hingga 25 MB. Tambahkan ?format=json untuk jawaban JSON.

Alat MCP

Alat lokal menjalankan perintah CLI dengan --json --yes dan menerima path, folder proyek (secara bawaan, folder tempat server dimulai). deploy menjawab dengan baris "Tell the user" terlebih dahulu. Login dan menghapus situs bukan alat: yang pertama memerlukan orang di browser, yang kedua tidak dapat dibatalkan.

Keluaran JSON

--json mencetak satu objek JSON di stdout, dengan log di 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 dan expires_at bernilai null untuk situs dengan akun. Kegagalan adalah { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Bercabanglah berdasarkan code, yang tidak pernah berubah (lihat Error), dan coba ulang hanya jika retryable bernilai true.