문서 /

AI 에이전트

코딩 에이전트(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

.cursor/mcp.json에 MCP 서버를 추가하세요.

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

또는 AGENTS.md의 섹션으로 .cursor/rules/에 프로젝트 규칙을 추가하세요.

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

stdin/stdout으로 MCP를 사용하는 모든 에이전트는 대신 npx -y lobsite@latest mcp를 실행할 수 있습니다.

ChatGPT와 Claude.ai

채팅 어시스턴트는 페이지를 작성하지만 배포할 폴더가 없습니다. 다음 URL로 Lobsite를 커스텀 커넥터(MCP 서버)로 추가하세요.

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은 공개 사이트를 변경하지 않고 배포합니다. 직접 배포는 25MB까지입니다. JSON 응답에는 ?format=json을 추가하세요.

MCP 도구

로컬 도구는 --json --yes로 CLI 명령을 실행하고 프로젝트 폴더 path(기본값은 서버를 시작한 폴더)를 받습니다. deploy는 "Tell the user" 줄로 먼저 답합니다. 로그인과 사이트 삭제는 도구가 아닙니다. 전자는 사람이 브라우저에 있어야 하고, 후자는 되돌릴 수 없기 때문입니다.

JSON 출력

--json은 stdout에 JSON 객체 하나를, 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일 때만 재시도하세요.