Dokümanlar /

Yapay zekâ ajanları

Kodlama ajanları (Claude Code, Cursor, Codex ve diğerleri) insanlarla aynı CLI ile deploy eder; dosya sistemi olmayan sohbet asistanları ise uzak bir MCP sunucusu üzerinden deploy eder. Bu sayfa her birinin nasıl kurulacağını gösterir.

npx -y lobsite --yes

Ajan modu nasıl çalışır

CLI, bir ajan altında çalıştığını ajanların ayarladığı değişkenlerden anlar: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT ve AGENT. Başka bir ajanı adlandırmak için LOBSITE_AGENT=<name>, ajan modunu kapatmak için LOBSITE_AGENT=0 ayarlayın. Bir ajan altında:

• Hiçbir şey sorulmaz. Bir klasörün ilk deploy'u özetini yazdırıp devam eder; geri alınamayan komutlar --yes gerektirir.
• Renk, animasyon, QR kod veya panoya kopyalama yoktur; yalnızca düz satırlar vardır.
• Bir deploy, ajanın iletmesi için yazılmış bir satırla biter:

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

Hesapsız deploy edilen siteler 6 saat yaşar. Sahiplenme bağlantısı siteyi korur: kişi onu açıp giriş yapar, terminale dokunmadan. Aynı komutu yeniden çalıştırmak aynı siteyi günceller, çünkü lobsite.toml onu hatırlar.

Claude Code

Claude Code yalnızca kabuk komutuyla deploy edebilir. Her seferinde Lobsite'ı kullanması için projenin CLAUDE.md dosyasına bir satır ekleyin:

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

Ya da Claude'a deploy etme, siteleri ve deploy'ları listeleme, geri alma ve yayına alma araçları veren MCP sunucusunu ekleyin:

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

Cursor

MCP sunucusunu .cursor/mcp.json dosyasına ekleyin:

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

Ya da .cursor/rules/ içine AGENTS.md bölümünü içeren bir proje kuralı ekleyin.

Codex ve diğer ajanlar

Codex ve AGENTS.md okuyan diğer ajanlar bunun gibi bir bölümü dikkate alır. Onu projenin AGENTS.md dosyasına yapıştırın:

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

stdin/stdout üzerinden MCP konuşan herhangi bir ajan bunun yerine npx -y lobsite@latest mcp çalıştırabilir.

ChatGPT ve Claude.ai

Sohbet asistanları sayfa yazar ama deploy edecek bir klasörleri yoktur. Lobsite'ı şu URL ile özel bir bağlayıcı (bir MCP sunucusu) olarak ekleyin:

https://lobsite.com/api/mcp

Streamable HTTP konuşur ve dosyaların içeriğini alan tek bir aracı vardır: deploy_files. Sonra asistandan sayfayı yayına almasını isteyin. Bu yolla deploy edilen sitelerin hesabı yoktur: yanıt, onları koruyan sahiplenme bağlantısını içerir.

Node olmadan: curl

npx çalışamadığı yerlerde tek bir curl komutu bir sayfayı ya da birkaç dosyayı deploy eder ve URL'yi, sahiplenme bağlantısını ve sitenin nasıl güncelleneceğini yanıt olarak verir:

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

Aynı geçici siteyi güncellemek için ilk yanıttaki adını ve sahiplenme token'ını gönderin:

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

?preview=1, yayındaki siteyi değiştirmeden deploy eder. Doğrudan bir deploy en fazla 25 MB taşır. JSON yanıtı için ?format=json ekleyin.

MCP araçları

Yerel araçlar CLI komutlarını --json --yes ile çalıştırır ve proje klasörü olan path değerini alır (varsayılan olarak sunucunun başlatıldığı klasör). deploy önce "Tell the user" satırıyla yanıt verir. Giriş yapmak ve site silmek araç değildir: biri kişinin tarayıcıda olmasını gerektirir, diğeri geri alınamaz.

JSON çıktısı

--json, stdout'a tek bir JSON nesnesi, stderr'e günlükleri yazdırır:

{
  "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
}

Hesabı olan siteler için claim_url ve expires_at değeri null olur. Bir başarısızlık { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } } biçimindedir. Hiç değişmeyen code değerine göre dallanın (bkz. Hatalar) ve yalnızca retryable true olduğunda yeniden deneyin.