コンテンツにスキップ
Docs
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

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 に読ませる

このページは役に立ちましたか?