ドキュメントCommerceAdobe Commerce as a Cloud Service

チュートリアルの前提条件

Last update: Wed Feb 25 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 中級
  • 開発者

このページでは、Adobe Commerce as a Cloud Service 評価の拡張チュートリアル ​ および ​ 発送方法の拡張チュートリアル ​ など、 のチュートリアルの前提条件と設定手順を示します。

Adobe Commerce as a Cloud Serviceの前提条件

  • Adobe I/O CLI のインストール

    code language-bash 
    npm install -g @adobe/aio-cli

  • Adobe I/O CLI Commerce、Adobe I/O CLI ランタイム ​、App Builder CLI プラグインをインストールします。

    code language-bash 
    aio plugins:install https://github.com/adobe-commerce/aio-cli-plugin-commerce @adobe/aio-cli-plugin-app-dev @adobe/aio-cli-plugin-runtime

  • Cursor （推奨）などの AI を利用した IDE のダウンロード、Claude Code、Gemini CLI、Copilot などの他の IDE もサポートされていますが、チュートリアルのプロンプトやその他の手順の変更が必要になる場合があります。

Adobe Developer Consoleの前提条件

  1. Adobe Developer Console に移動します。
  2. メールとパスワードを使用してログインします。

新規プロジェクトの作成

  1. Adobe Developer Console に移動します。

  2. テンプレートからプロジェクトを作成 をクリックします。

  3. App Builder テンプレートを選択します。

  4. プロジェクトタイトル および アプリ名 を入力します。

  5. 「Include Runtime」チェックボックスがオンになっていることを確認します。

    App Builder テンプレートを選択したAdobe Developer Console プロジェクトの作成 ​ {width="600" modal="regular"}

  6. 保存 をクリックします。

ワークスペースへの API の追加

  1. ステージング ワークスペースをクリックし、各 API に対して次の手順を繰り返します。

    API の「サービスを追加」オプションを使用したステージワークスペース ​ {width="600" modal="regular"}

  2. サービスを追加 をクリックし、「API」を選択します。

  3. 次のいずれかの API を選択します。 以下に示す各 API に対して、このプロセスを繰り返す必要があります。

    • Adobe サービス フィルター：

      • I/O Management API
      • I/O イベント API

    • Experience Cloud フィルター：

      • Adobe Commerce用Adobe I/O Events API

  4. 次へ をクリックします。

  5. 「設定済み API を保存」をクリックします。

  6. すべての API がワークスペースに追加されるまで、前の手順を繰り返します。

    ​ 必要なすべての API が正常に追加されたことを示すWorkspace {width="600" modal="regular"}

Adobe I/O CLI の設定

  1. 既存の設定を消去します。

    code language-bash 
    aio config clear

    Adobe I/O CLI を使用してログイン：

    code language-bash 
    aio auth login -f

  2. 次の各コマンドを使用して、組織、プロジェクト、ワークスペースを選択します。

    code language-bash 
    aio console org select
    code language-bash 
    aio console project select
    code language-bash 
    aio console workspace select

    Adobe I/O CLI の組織プロジェクトとワークスペースの選択を示すターミナル ​ {width="600" modal="regular"}

スターターキットのクローンを作成

構築している拡張機能に対して、次のCommerce スターターキットリポジトリーの 1 つを複製し、プロジェクトを準備します。

統合スターターキット：

git clone https://github.com/adobe/commerce-integration-starter-kit.git extension
cd extension

スターターキットのチェックアウト：

git clone https://github.com/adobe/commerce-checkout-starter-kit.git extension
cd extension
統合スターターキット

.env ファイルの作成

環境設定ファイルを作成します。

code language-bash 
cp env.dist .env

.env ファイルをテキストエディターで開き、次の OAuth 資格情報を追加します。

code language-shell-session 
OAUTH_CLIENT_ID=
OAUTH_CLIENT_SECRET=
OAUTH_TECHNICAL_ACCOUNT_ID=
OAUTH_TECHNICAL_ACCOUNT_EMAIL=
OAUTH_ORG_ID=

これらの値は、ワークスペースの「Credential details」タブをクリックして、Developer Console の OAuth Server-to-Server ページからコピーできます。

Adobe Developer Consoleの OAuth サーバー間資格情報ページ ​ {width="600" modal="regular"}

Commerce設定を追加

.env ファイルに次のCommerce インスタンスの詳細を追加します。

code language-shell-session 
COMMERCE_BASE_URL=
COMMERCE_GRAPHQL_ENDPOINT=

これらの値を検索するには：

  1. Commerce Cloud サービスインスタンス ​ に移動します。
  2. インスタンスの横にある「情報」アイコンをクリックします。
  3. REST エンドポイントを COMMERCE_BASE_URL としてコピーします。
  4. GraphQL エンドポイントを COMMERCE_GRAPHQL_ENDPOINT としてコピーします。

イベントのプレフィックスを設定

イベントプレフィックスに一時的な値を設定します。

code language-shell-session 
EVENT_PREFIX=test

ワークスペース設定のダウンロード

次のコマンドを実行して、ワークスペース設定ファイルをダウンロードします。

code language-bash 
aio console workspace download workspace.json

ワークスペース設定ファイルを scripts ディレクトリにコピーします。

code language-bash 
cp workspace.json scripts/

ローカルワークスペースのリモートワークスペースへの接続

ローカルプロジェクトをリモートワークスペースにリンクします。

code language-bash 
aio app use workspace.json -m

aio app use コマンドでワークスペース接続が成功したことを示すターミナル ​ {width="600" modal="regular"}

スターターキットをチェックアウト

ローカルワークスペースのリモートワークスペースへの接続

ローカルプロジェクトをリモートワークスペースにリンクします。 プロジェクトルート（extension フォルダー）から、次を実行します。

code language-bash 
aio app use --merge

プロンプトが表示されたら、Adobe I/O CLI の設定時に選択した組織、プロジェクト、ワークスペースを使用するオプションを選択します。 これにより、ワークスペース設定がアプリに書き込まれ、デプロイとローカル開発でそのワークスペースが使用されるようになります。

aio app use コマンドでワークスペース接続が成功したことを示すターミナル ​ {width="600" modal="regular"}

拡張 AI ツールのインストール

このプロセスにより、MCP 設定（.<agent>/mcp.json）、スキル ディレクトリ（.<agent>/skills/）が作成され、AGENTS.md がプロジェクト ルートに追加されます。 スターターキット、コーディングエージェント、パッケージマネージャーを選択するように求められます。

  1. 次のコマンドを使用して、extension フォルダー内に AI 支援開発ツールを設定します。

    code language-bash 
    cd extension
    code language-bash 
    aio commerce extensibility tools-setup

    AI 拡張ツール設定コマンド出力を示すターミナル ​ {width="600" modal="regular"}

  2. セットアップが完了したら、コーディング エージェントを再起動して、新しい MCP ツールとスキルをロードできるようにします。 これで、お使いの環境でCommerce App Builder ツールを使用できるようになりました。

    note note
    NOTE
    スターターキットのスキルが見つからないという警告が表示された場合は、問題が発生しました。多くの場合、セットアップがスターターキットのクローンを作成したフォルダー以外で実行されていることが原因です。 aio commerce extensibility tools-setup フォルダー（スターターキットプロジェクトルート）から extension を実行し、プロンプトが表示されたら適切なスターターキットを選択します。

    ​ チェックアウトスターターキットが選択された状態で AI 拡張ツールが設定されていることを示すターミナル ​ {width="600" modal="regular"}

recommendation-more-help
76c6d489-ee5b-4411-84d1-033660e03d8c