AI エージェントで組み込む
導入プロンプトを 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 に許可の手順を表示します。設定を変えたら、同じコマンドを打ち直します。
手順
導入プロンプトをコピーする
管理画面の「開発者設定」で、導入プロンプトをコピーします。
本番用とサンドボックス用で、プロンプトの内容が違います。サンドボックスの管理画面から取ったプロンプトは、テスト購入までで止まります。本番へ進むには、本番の管理画面から取ったプロンプトを使います。
エージェントに貼る
サイトのプロジェクトのフォルダで、エージェントにプロンプトを渡します。エージェントは init を実行して SDK を入れ、CLI の案内に従って進めます。
CLI のログインを承認する
エージェントは login を実行し、承認用の URL とコードを表示します。ブラウザで URL を開き、表示されたコードがエージェントの出力と同じことを確かめてから承認します。
サンドボックスで組み込み、テスト購入で確かめる
エージェントはサンドボックスの商品を作り、サイトのコードに購入リンクと限定ページを書きます。テスト購入で、購入から入場までを確かめます。
本番へ切り替える
本番で販売するかは、利用者が決めます。許可されたら、エージェントは本番にログインして既定の接続先を切り替え、商品を本番で作り直します。コードの商品IDと購入リンクも差し替えます。本番の環境変数から COZENI_ENVIRONMENT を外すのは、利用者です。
導入プロンプトを使わず、手で組み込むこともできます。手順は Next.js に組み込む を見てください。
エージェントがすること
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 にあります。
- 各ページの Markdown はページの URL の末尾に
.mdを付けて取得できます。例:https://docs.cozeni.net/integrate/ai-agents.md