---
title: AI エージェントで組み込む
description: 導入プロンプトを AI エージェントに渡して、サイトに組み込ませる。
---

管理画面の導入プロンプトを AI エージェントに渡すと、エージェントが CLI と SDK を使って、サイトに Cozeni を組み込みます。商品の作成や本番への切り替えは、利用者が許可してからエージェントが行います。

## 使えるエージェント

使えるのは、シェルを実行できるコーディングエージェントです。エージェントが CLI（`npx` のコマンド）を実行して、Cozeni の API と通信できることが条件です。

| エージェント | 使えるか |
| --- | --- |
| Claude Code、Cursor、Codex、Replit Agent、Cursor Cloud Agents | 使えます。 |
| Codex cloud、Claude Code on the web | 使えます。既定で外部への通信が制限されているため、Cozeni の API のホストへの通信を許可します（下の「通信が制限された環境」）。 |
| Lovable など、シェルを持たないツール | 使えません。CLI を実行できないためです。 |

### 通信が制限された環境

Codex cloud や Claude Code on the web では、環境の設定で次のホストへの通信を許可します。

| 接続先 | 許可するホスト |
| --- | --- |
| 本番 | `api.cozeni.net` |
| サンドボックス | `api-sandbox.cozeni.net` |

導入プロンプトの流れはサンドボックスから始まるので、本番まで進めるなら両方を許可します。

- Codex cloud：環境の設定で、エージェントのインターネットアクセスを有効にし、許可するドメインにホストを追加します。
- Claude Code on the web：環境のネットワークアクセスを「カスタム」にし、許可するドメインにホストを追加します。

許可していないと、CLI は `network_unreachable`（終了コード5）で止まり、`error.hint` に許可の手順を表示します。設定を変えたら、同じコマンドを打ち直します。

## 手順

1. **導入プロンプトをコピーする**

    管理画面の「開発者設定」で、導入プロンプトをコピーします。

    本番用とサンドボックス用で、プロンプトの内容が違います。サンドボックスの管理画面から取ったプロンプトは、テスト購入までで止まります。本番へ進むには、本番の管理画面から取ったプロンプトを使います。

2. **エージェントに貼る**

    サイトのプロジェクトのフォルダで、エージェントにプロンプトを渡します。エージェントは `init` を実行して SDK を入れ、CLI の案内に従って進めます。

3. **CLI のログインを承認する**

    エージェントは `login` を実行し、承認用の URL とコードを表示します。ブラウザで URL を開き、表示されたコードがエージェントの出力と同じことを確かめてから承認します。

4. **サンドボックスで組み込み、テスト購入で確かめる**

    エージェントはサンドボックスの商品を作り、サイトのコードに購入リンクと限定ページを書きます。テスト購入で、購入から入場までを確かめます。

5. **本番へ切り替える**

    本番で販売するかは、利用者が決めます。許可されたら、エージェントは本番にログインして既定の接続先を切り替え、商品を本番で作り直します。コードの商品IDと購入リンクも差し替えます。本番の環境変数から `COZENI_ENVIRONMENT` を外すのは、利用者です。

導入プロンプトを使わず、手で組み込むこともできます。手順は [Next.js に組み込む](/integrate/guides/nextjs) を見てください。

## エージェントがすること

- `init` で SDK を入れ、CLI で商品を作成し、購入リンクを取得します。商品の作成の前に、利用者に内容を確認します。
- サイトのコードに、購入リンクと限定ページの認可を書きます。既存の認証や middleware は置き換えません。
- テスト購入で、購入から入場までを確かめます。
- 機能フラグを使う場合は、利用者が API キーを環境変数に入れるように案内します。エージェントはキーの値を読みも書きもしません。

## エージェントがしないこと

- 本番での実際の課金。決済を試すことを含みます。
- 公開、デプロイ、本番の環境変数の変更。
- 既存の認証の置き換え。
- API キー、購入者の Cookie、ワンタイムコードなどの秘密の値を、チャットやログに出すこと。
- 利用者の確認なしに、商品を作ること、価格や購入後に表示するページを変えること。

## 同梱の skill

SDK には AI エージェント向けの手順書（`cozeni-setup`）が入っています。`init` がプロジェクトの `.agents/skills/cozeni-setup/` に置きます。Claude Code から実行したときと、プロジェクトに `.claude` フォルダがあるときは、`.claude/skills/cozeni-setup/` にも置きます。

手順書は、`init` が管理します。手で編集せず、プロジェクト独自の手順は `AGENTS.md` などに書いてください。手順書はプロジェクトと一緒にコミットしてください。

## このドキュメントを AI に読ませる

- ドキュメントの一覧は [https://docs.cozeni.net/llms.txt](https://docs.cozeni.net/llms.txt) にあります。
- 各ページの Markdown はページの URL の末尾に `.md` を付けて取得できます。例：[https://docs.cozeni.net/integrate/ai-agents.md](https://docs.cozeni.net/integrate/ai-agents.md)
