Docs /

Agentes de IA

Los agentes de programación (Claude Code, Cursor, Codex y otros) despliegan con la misma CLI que las personas, y los asistentes de chat sin sistema de archivos despliegan a través de un servidor MCP remoto. Esta página muestra cómo configurar cada uno.

npx -y lobsite --yes

Cómo funciona el modo agente

La CLI sabe que se ejecuta bajo un agente por las variables que definen los agentes: CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT y AGENT. Define LOBSITE_AGENT=<name> para nombrar otro agente, o LOBSITE_AGENT=0 para desactivar el modo agente. Bajo un agente:

• Nunca se pregunta nada. El primer deploy de una carpeta imprime su resumen y continúa; los comandos que no se pueden deshacer necesitan --yes.
• No hay colores, animaciones, códigos QR ni copias al portapapeles, solo líneas simples.
• Un deploy termina con una línea escrita para que el agente la transmita:

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

Los sitios desplegados sin cuenta duran 6 horas. El enlace para reclamarlo conserva el sitio: la persona lo abre e inicia sesión, sin tocar una terminal. Ejecutar el mismo comando otra vez actualiza el mismo sitio, porque lobsite.toml lo recuerda.

Claude Code

Claude Code puede desplegar solo con el comando de shell. Para que use Lobsite siempre, añade una línea al CLAUDE.md del proyecto:

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

O añade el servidor MCP, que da a Claude herramientas para desplegar, listar sitios y deploys, revertir y publicar:

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

Cursor

Añade el servidor MCP a .cursor/mcp.json:

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

O añade una regla de proyecto en .cursor/rules/ con la sección de AGENTS.md.

Codex y otros agentes

Codex y los demás agentes que leen AGENTS.md toman una sección como esta. Pégala en el AGENTS.md del proyecto:

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

Cualquier agente que hable MCP por stdin/stdout puede ejecutar npx -y lobsite@latest mcp en su lugar.

ChatGPT y Claude.ai

Los asistentes de chat escriben páginas pero no tienen una carpeta que desplegar. Añade Lobsite como conector personalizado (un servidor MCP) con esta URL:

https://lobsite.com/api/mcp

Usa Streamable HTTP y tiene una herramienta, deploy_files, que recibe el contenido de los archivos. Después pide al asistente que publique la página. Los sitios desplegados así no tienen cuenta: la respuesta incluye el enlace para reclamarlos y conservarlos.

Sin Node: curl

Donde npx no puede ejecutarse, un comando curl despliega una página o unos pocos archivos y responde con la URL, el enlace para reclamarla y cómo actualizar el sitio:

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 actualizar el mismo sitio temporal, pasa su nombre y el token para reclamarlo de la primera respuesta:

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

?preview=1 despliega sin cambiar el sitio publicado. Un deploy directo admite hasta 25 MB. Añade ?format=json para una respuesta en JSON.

Herramientas MCP

Las herramientas locales ejecutan los comandos de la CLI con --json --yes y reciben path, la carpeta del proyecto (por defecto, la carpeta donde arrancó el servidor). deploy responde primero con la línea «Tell the user». Iniciar sesión y borrar sitios no son herramientas: lo primero necesita a la persona en un navegador y lo segundo no se puede deshacer.

Salida JSON

--json imprime un objeto JSON en stdout, con los registros en 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 y expires_at son null en los sitios con cuenta. Un fallo es { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Decide según code, que nunca cambia (consulta Errores), y reintenta solo cuando retryable es true.