ドキュメント /

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 に 1 行追加してください。

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

MCP を stdin/stdout で扱えるエージェントは、代わりに npx -y lobsite@latest mcp を実行できます。

ChatGPT と Claude.ai

チャットアシスタントはページを書きますが、デプロイするフォルダがありません。次の URL で Lobsite をカスタムコネクタ（MCP サーバー）として追加してください。

https://lobsite.com/api/mcp

Streamable HTTP を使い、ファイルの内容を受け取るツール deploy_files が 1 つあります。その後、アシスタントにページの公開を依頼してください。この方法でデプロイしたサイトにアカウントはなく、応答にサイトを残す取得リンクが含まれます。

Node なし: curl

npx を実行できない場所では、curl コマンド 1 つで 1 ページまたは少数のファイルをデプロイでき、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 MB までです。JSON の応答には ?format=json を追加してください。

MCP ツール

ローカルのツールは --json --yes で CLI のコマンドを実行し、プロジェクトフォルダ path（デフォルトはサーバーを起動したフォルダ）を受け取ります。deploy は「Tell the user」行から応答します。ログインとサイトの削除はツールではありません。前者はブラウザで人が操作する必要があり、後者は元に戻せないからです。

JSON 出力

--json は stdout に 1 つの 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 の場合のみにしてください。