Docs /

Agents IA

Les agents de code (Claude Code, Cursor, Codex et d’autres) déploient avec la même CLI que les humains, et les assistants de chat sans système de fichiers déploient via un serveur MCP distant. Cette page explique comment configurer chacun d’eux.

npx -y lobsite --yes

Comment fonctionne le mode agent

La CLI sait qu’elle tourne sous un agent grâce aux variables que les agents définissent : CLAUDECODE (Claude Code), CURSOR_AGENT (Cursor), CODEX_SANDBOX (Codex), GEMINI_CLI, COPILOT_AGENT, GOOSE_TERMINAL, REPLIT_AGENT et AGENT. Définissez LOBSITE_AGENT=<name> pour nommer un autre agent, ou LOBSITE_AGENT=0 pour désactiver le mode agent. Sous un agent :

• Rien n’est jamais demandé. Le premier déploiement d’un dossier affiche son résumé et continue ; les commandes irréversibles demandent --yes.
• Pas de couleurs, d’animations, de QR codes ni de copie dans le presse-papiers, seulement des lignes simples.
• Un déploiement se termine par une ligne écrite pour que l’agent la relaie :

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

Les sites déployés sans compte durent 6 heures. Le lien de récupération garde le site : la personne l’ouvre et se connecte, sans toucher à un terminal. Relancer la même commande met à jour le même site, car lobsite.toml le mémorise.

Claude Code

Claude Code peut déployer avec la seule commande shell. Pour qu’il utilise Lobsite à chaque fois, ajoutez une ligne au CLAUDE.md du projet :

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

Ou ajoutez le serveur MCP, qui donne à Claude des outils pour déployer, lister les sites et les déploiements, revenir en arrière et mettre en ligne :

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

Cursor

Ajoutez le serveur MCP à .cursor/mcp.json :

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

Ou ajoutez une règle de projet dans .cursor/rules/ avec la section d’AGENTS.md.

Codex et les autres agents

Codex et les autres agents qui lisent AGENTS.md reprennent une section comme celle-ci. Collez-la dans le AGENTS.md du projet :

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

Tout agent qui parle MCP via stdin/stdout peut lancer npx -y lobsite@latest mcp à la place.

ChatGPT et Claude.ai

Les assistants de chat écrivent des pages mais n’ont pas de dossier à déployer. Ajoutez Lobsite comme connecteur personnalisé (un serveur MCP) avec cette URL :

https://lobsite.com/api/mcp

Il parle Streamable HTTP et a un seul outil, deploy_files, qui reçoit le contenu des fichiers. Demandez ensuite à l’assistant de mettre la page en ligne. Les sites déployés ainsi n’ont pas de compte : la réponse contient le lien de récupération qui permet de les garder.

Sans Node : curl

Là où npx ne peut pas tourner, une commande curl déploie une page ou quelques fichiers et répond avec l’URL, le lien de récupération et la façon de mettre à jour le 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

Pour mettre à jour le même site temporaire, passez son nom et le jeton de récupération de la première réponse :

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

?preview=1 déploie sans changer le site en ligne. Un déploiement direct accepte jusqu’à 25 Mo. Ajoutez ?format=json pour une réponse en JSON.

Outils MCP

Les outils locaux exécutent les commandes de la CLI avec --json --yes et prennent path, le dossier du projet (par défaut, le dossier où le serveur a démarré). deploy répond d’abord avec la ligne « Tell the user ». La connexion et la suppression de sites ne sont pas des outils : l’une demande la personne dans un navigateur, l’autre est irréversible.

Sortie JSON

--json affiche un objet JSON sur stdout, avec les journaux sur 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 et expires_at valent null pour les sites avec un compte. Un échec est { "error": { "code", "message", "why", "fix", "exit_code", "retryable" } }. Basez votre logique sur code, qui ne change jamais (voir Erreurs), et ne réessayez que si retryable vaut true.