Документація /

ШІ-агенти

Агенти для програмування (Claude Code, Cursor, Codex та інші) розгортають сайти через той самий CLI, що й люди, а чат-асистенти без файлової системи — через віддалений MCP-сервер. На цій сторінці показано, як налаштувати кожен варіант.

npx -y lobsite --yes

Як працює режим агента

CLI визначає, що працює під керуванням агента, за змінними, які встановлюють агенти: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT та AGENT. Установіть LOBSITE_AGENT=<name>, щоб указати іншого агента, або LOBSITE_AGENT=0, щоб вимкнути режим агента. Під керуванням агента:

• Запитань ніколи не виникає. Перше розгортання папки виводить підсумок і продовжується; команди, які не можна скасувати, потребують --yes.
• Немає кольорів, індикаторів очікування, QR-кодів або копіювання в буфер обміну — лише звичайні рядки.
• Розгортання закінчується рядком, який агент має передати користувачеві:

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

Сайти, розгорнуті без облікового запису, існують 6 годин. Посилання для закріплення дає змогу зберегти сайт: людина відкриває його та входить, не користуючись терміналом. Повторний запуск тієї самої команди оновлює той самий сайт, оскільки lobsite.toml запам’ятовує його.

Claude Code

Claude Code може розгортати сайти лише командою оболонки. Щоб він щоразу використовував Lobsite, додайте рядок до CLAUDE.md проєкту:

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

Або додайте MCP-сервер, який надає Claude інструменти для розгортання, перегляду списків сайтів і розгортань, відкату та активації розгортання:

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

Cursor

Додайте MCP-сервер до .cursor/mcp.json:

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

Або додайте правило проєкту в .cursor/rules/ із розділом з AGENTS.md.

Codex та інші агенти

Codex та інші агенти, які читають AGENTS.md, використовують розділ на зразок наведеного нижче. Вставте його в AGENTS.md проєкту:

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

Будь-який агент, що підтримує MCP через stdin/stdout, може натомість запускати npx -y lobsite@latest mcp.

ChatGPT і Claude.ai

Чат-асистенти створюють сторінки, але не мають папки для розгортання. Додайте Lobsite як власний конектор (MCP-сервер) із цією URL-адресою:

https://lobsite.com/api/mcp

Він підтримує Streamable HTTP і має один інструмент — deploy_files, який приймає вміст файлів. Потім попросіть асистента опублікувати сторінку. Сайти, розгорнуті цим способом, не прив’язані до облікового запису: відповідь містить посилання, за яким їх можна зберегти.

Без Node: curl

Там, де npx запустити неможливо, одна команда curl розгортає сторінку або кілька файлів і повертає URL-адресу, посилання для закріплення та спосіб оновлення сайту:

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

Щоб оновити той самий тимчасовий сайт, передайте його назву та токен закріплення з першої відповіді:

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

?preview=1 розгортає сайт, не змінюючи його робочу версію. Пряме розгортання передає до 25 MB. Додайте ?format=json, щоб отримати відповідь у JSON.

Інструменти MCP

Локальні інструменти запускають команди CLI з --json --yes і приймають path — папку проєкту (за замовчуванням папку, у якій запущено сервер). deploy спочатку повертає рядок "Tell the user". Вхід і видалення сайтів не представлені інструментами: для першого потрібна людина в браузері, друге неможливо скасувати.

Вивід JSON

--json виводить один об’єкт JSON у stdout, а журнали — у 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 і expires_at мають значення null для сайтів з обліковим записом. Помилка має вигляд { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Обирайте подальші дії за code, який ніколи не змінюється (див. Помилки), і повторюйте спробу лише тоді, коли retryable має значення true.