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

ИИ-агенты

Агенты для программирования (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 МБ. Добавьте ?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.