Documentação /

Agentes de IA

Agentes de programação (Claude Code, Cursor, Codex e outros) publicam com a mesma CLI que as pessoas, e assistentes de chat sem sistema de arquivos publicam por um servidor MCP remoto. Esta página mostra como configurar cada um.

npx -y lobsite --yes

Como funciona o modo agente

A CLI sabe que está rodando sob um agente pelas variáveis que os agentes definem: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT e AGENT. Defina LOBSITE_AGENT=<name> para nomear outro agente, ou LOBSITE_AGENT=0 para desligar o modo agente. Sob um agente:

• Nada é perguntado. O primeiro deploy de uma pasta imprime o resumo e segue em frente; comandos que não podem ser desfeitos exigem --yes.
• Não há cores, animações, QR codes nem cópias para a área de transferência, só linhas simples.
• Um deploy termina com uma linha escrita para o agente repassar:

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

Sites publicados sem conta duram 6 horas. O link de resgate mantém o site: a pessoa o abre e entra, sem mexer num terminal. Rodar o mesmo comando de novo atualiza o mesmo site, porque o lobsite.toml o lembra.

Claude Code

O Claude Code consegue publicar só com o comando de shell. Para que ele use o Lobsite sempre, adicione uma linha ao CLAUDE.md do projeto:

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

Ou adicione o servidor MCP, que dá ao Claude ferramentas para publicar, listar sites e deploys, fazer rollback e colocar no ar:

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

Cursor

Adicione o servidor MCP ao .cursor/mcp.json:

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

Ou adicione uma regra de projeto em .cursor/rules/ com a seção do AGENTS.md.

Codex e outros agentes

O Codex e os outros agentes que leem o AGENTS.md aproveitam uma seção como esta. Cole-a no AGENTS.md do projeto:

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

Qualquer agente que fala MCP por stdin/stdout pode rodar npx -y lobsite@latest mcp no lugar.

ChatGPT e Claude.ai

Assistentes de chat escrevem páginas, mas não têm uma pasta para publicar. Adicione o Lobsite como conector personalizado (um servidor MCP) com esta URL:

https://lobsite.com/api/mcp

Ele fala Streamable HTTP e tem uma ferramenta, deploy_files, que recebe o conteúdo dos arquivos. Depois peça ao assistente para colocar a página no ar. Sites publicados assim não têm conta: a resposta traz o link de resgate que os mantém.

Sem Node: curl

Onde o npx não roda, um comando curl publica uma página ou alguns arquivos e responde com a URL, o link de resgate e como atualizar o site:

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

Para atualizar o mesmo site temporário, passe o nome dele e o token de resgate da primeira resposta:

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

?preview=1 publica sem mudar o site no ar. Um deploy direto aceita até 25 MB. Adicione ?format=json para uma resposta em JSON.

Ferramentas MCP

As ferramentas locais rodam os comandos da CLI com --json --yes e recebem path, a pasta do projeto (por padrão, a pasta onde o servidor foi iniciado). deploy responde primeiro com a linha "Tell the user". Fazer login e apagar sites não são ferramentas: um precisa da pessoa num navegador, o outro não pode ser desfeito.

Saída JSON

--json imprime um objeto JSON no stdout, com os logs no 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 e expires_at são null para sites com conta. Uma falha é { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Decida com base em code, que nunca muda (veja Erros), e tente de novo só quando retryable for true.