AI ツールを使用したローカル開発 local-development-with-ai-tools

AI コーディングエージェント（Claude Code、Cursor、GitHub Copilotなどのツール）は、AEMの基本テクノロジー（Java、OSGi、Sling、JCR、HTL）に幅広い知識を持っていますが、コードと設定の生成のベストプラクティスや、AEM開発の一般的な問題のデバッグ方法を必ずしも知っているわけではありません。

これに対応する4つの補完的なコンポーネント：

追加の実践的な手順については、AI支援による開発チュートリアル ​を参照してください。

AGENTS.md agentsmd

AGENTS.mdは、AEM プロジェクトのルートにあるマークダウン ファイルです。 AI コーディングツールは、AEM Cloud ServiceのJava スタックドメインに関する重要な専門知識（AEM 6.5やEdge Delivery Servicesなどの他のAEM ソリューションではなく）を基に構築するために、各セッションの開始時に、このファイルを自動的に読み込みます。

AGENTS.mdはコピーする静的ファイルではありません。 このドキュメントの次のセクションで説明するensure-agents-md スキルによって生成されます。 スキルでは、pom.xmlを読み取り、プロジェクト名を解決し、モジュールを見つけ出して、インストールされたアドオンを検出し、特定のプロジェクトに合わせたファイルを作成します。

エージェントスキル agent-skills

スキルは、マルチステップの開発ワークフローをエンコードする命令セットです。 AIを呼び出すと、一般的な知識のみに依存するのではなく、スキルの手順に従い、一貫した規則に準拠した結果が生成されます。

Adobeは、adobe/skills リポジトリでAEM as a Cloud Service スキルを公開します。

スキルのインストール install-skills

AI コーディングツールに適した方法を選択してください。 スキルを一度インストールすれば、そのスキルをそのマシン上のすべてのプロジェクトで利用できるようになります。 具体的なチュートリアルについては、AEM Agent Skillsの設定チュートリアル ​を参照してください。

クロード・コード claude-code

# Add the Adobe Skills marketplace (one-time setup)
/plugin marketplace add adobe/skills

# Install all available skills
/plugin install aem-cloud-service@adobe-skills

Npx Skills npx-skills

# Install all available skills
npx skills add https://github.com/adobe/skills/tree/main/skills/aem/cloud-service --all

Upskill （GitHub CLI拡張機能） upskill-github-cli-extension

# Install the gh-upskill extension (one-time setup)
gh extension install ai-ecoverse/gh-upskill

# Install all available skills
gh upskill adobe/skills --path plugins/aem/cloud-service --all

ensure-agents-md スキルの使用 use-the-ensure-agents-md-skill

スキルをインストールした後、AGENTS.mdを持たない任意のAEM as a Cloud Service プロジェクトでAI アシスタントを開きます。 スキルは、最初のリクエストを処理する前に自動的に実行され、明示的な呼び出しを必要とせずに、両方のファイルをプロジェクトルートに作成します。

コンポーネント作成スキルの使用 use-the-create-component-skill

最初に使用すると、スキルはpom.xmlと既存のコンポーネントからproject、package、groupを自動的に検出し、検出された値を確認するように求めます。 その後、プロジェクトのルートに.aem-skills-config.yamlが作成されます。 最初に使用する前に、手動で設定する必要はありません。

ファイルを事前作成する場合は、次の構造を持つプロジェクト ルートに.aem-skills-config.yamlを配置します。

configured: true

project: "wknd"                                    # Check /apps/{project}/ or pom.xml
package: "com.adobe.aem.guides.wknd.core"          # Check core/pom.xml
group: "WKND Components"                           # Check existing component .content.xml files

ファイルはスキルディレクトリの外側にあり、スキルの更新時に上書きされることはありません。

AI チャットのコンポーネントについて説明します。

Create an AEM component called "Hero Banner"

Dialog specification:
Title (title) - Textfield, mandatory
Subtitle (subtitle) - Textfield
Background Image (backgroundImage) - Fileupload
CTA Text (ctaText) - Textfield
CTA Link (ctaLink) - Pathfield

エージェントは、確認のためにフィールド仕様をエコーし、すべてのコンポーネントファイルを生成します。 サポートされているパターンには、複合ネストされたアイテムを含むマルチフィールド、条件付き表示/非表示ロジック、Sling Resource Mergerを介したコアコンポーネント拡張機能、AEM Mocksを使用したJUnit 5 テストなどがあります。 デザインは、テキストの説明、画像、FigmaのMCP サーバーを使用したFigma デザイン URLなど、さまざまなソースから取得できます。

詳しくは、AEM Agent Skills チュートリアルを使用したコンポーネント開発を参照してください。

Dispatcher スキルの使用 use-the-dispatcher-skill

DispatcherまたはApache HTTPD設定作業のDispatcher スキルを呼び出します。 このスキルは、リクエストの性質に応じて、リクエストを6つの専門サブスキルのいずれかにルーティングします。

幅広いリクエストまたは初めてのリクエストの場合は、workflow-orchestrator個のサブスキルから始めます。 ターゲットを絞った作業については、特定の懸念事項と適切な専門家へのスキルルートを説明してください。

Dispatcher スキルは、オーケストレーションとアドバイザリーガイダンスを処理します。 次の節で説明するDispatcher MCP サーバーには、スキルがローカルのエビデンスを必要とする場合に使用する7つの検証ツールとランタイムツールが用意されています。

AEM Quickstart MCP Server aem-quickstart-mcp-server

Model Context Protocol （MCP）は、AI コーディングツールを外部のデータソースやサービスに接続できるようにする、オープンスタンダードです。 AEM クイックスタート MCP サーバーは、ローカルのAEM SDK インスタンスにインストールすると、ランタイムデータを接続されたAI ツールに直接公開するコンテンツパッケージです。これにより、エージェントはIDEから離れることなく、ログを取得し、OSGi エラーを診断し、リクエスト処理を検査できます。

コンテンツパッケージのインストール install-the-content-package

​ ソフトウェア配布ポータル ​からコンテンツ パッケージをダウンロードし、/crx/packmgrのパッケージ マネージャーを使用してcom.adobe.aem:com.adobe.aem.mcp-server-contribs-contentをローカル クイックスタートにインストールします。

互換性： AEM SDK 2026.2.24678.20260226T154829Z-260200以降で検証されました。

利用可能なツール available-tools

IDEの設定 configure-your-ide

カーソル cursor

カーソル設定で、新しいカスタム MCP サーバーを追加します。

"aem-cs-sdk": {
  "type": "streamable-http",
  "url": "http://localhost:4502/bin/mcp",
  "headers": {
    "Authorization": "Basic YWRtaW46YWRtaW4="
  }
}

IntelliJ IDEAによるGitHub Copilot github-copilot-with-ihtellij-idea

ツール/GitHub コパイロット/モデルコンテキストプロトコル（MCP）​に移動し、設定​をクリックします。 次の行を追加します。

"aem-cs-sdk": {
  "url": "http://localhost:4502/bin/mcp",
  "requestInit": {
    "headers": {
      "Authorization": "Basic YWRtaW46YWRtaW4="
    }
  }
}

他のIDE other-ides

任意のMCP クライアントは、http://localhost:4502/bin/mcpをAuthorization: Basic YWRtaW46YWRtaW4= ヘッダーで指定して接続できます。 IDEのMCP設定を使用してカスタムヘッダーを設定します。

Dispatcher MCP Server dispatcher-mcp-server

Dispatcher MCP サーバーは、AEM Dispatcher SDKにバンドルされています。 これにより、AI ツールは、DispatcherとApache HTTPD設定を検証し、リクエスト処理を追跡し、Dockerでローカルに実行されているDispatcher インスタンスに対するキャッシュ動作を調べることができます。

Dispatcher スキルとは異なり、Dispatcher MCP サーバーはツールのみを公開します。7つのMCP ツールとプロンプトやリソースはありません。

前提条件 prerequisites

Dispatcher SDKのインストール install-the-dispatcher-sdk

macOSとLinux:

chmod +x aem-sdk-dispatcher-tools-<version>-unix.sh
./aem-sdk-dispatcher-tools-<version>-unix.sh
cd dispatcher-sdk-<version>
chmod +x ./bin/docker_run_mcp.sh
./bin/docker_run_mcp.sh test

Windows:

Expand-Archive aem-sdk-dispatcher-tools-<version>-windows.zip

./bin/docker_run_mcp.sh helpを実行してコピー&ペーストのIDE設定を取得し、./bin/docker_run_mcp.sh versionを実行して、バンドルされたMCPとSDKのバージョンを確認します。 ./bin/docker_run_mcp.sh diagnoseを使用して、接続性の問題を調査します。

カーソルの設定 configure-cursor

aem-dispatcher-mcp エントリを~/.cursor/mcp.jsonに追加：

{
  "mcpServers": {
    "aem-dispatcher-mcp": {
      "command": "<path_to_dispatcher_sdk>/bin/docker_run_mcp.sh",
      "env": {
        "DOCKER_API_VERSION": "1.43",
        "AEM_DEPLOYMENT_MODE": "cloud",
        "MCP_LOG_LEVEL": "trace",
        "MCP_LOG_FILE": "/tmp/dispatcher-mcp.log",
        "DISPATCHER_CONFIG_PATH": "<path_to_dispatcher_src>"
      }
    }
  }
}

<path_to_dispatcher_sdk>を抽出したDispatcher SDKの場所に、<path_to_dispatcher_src>をプロジェクトのDispatcher src ディレクトリに置き換えます。 DISPATCHER_CONFIG_PATHを、/docrootが定義されているファイルを含む構成ルートに設定します。 MCP_LOG_LEVELとMCP_LOG_FILEはオプションのデバッグ設定です。 client version 1.43 is too newが表示される場合は、DOCKER_API_VERSIONを1.41に設定します。 他のMCP サーバーが既に設定されている場合は、置き換えずにaem-dispatcher-mcp エントリを追加します。 保存後にカーソルを再起動します。

他のIDEも同様の方法で設定できます。 SDKのdocs/DispatcherMCP.mdには、Claude DesktopとVS Codeの完全な例が含まれています。

利用可能なツール available-tools-dispatcher

MCP サーフェスでは、意図的にこれらの7つのツールのみを公開します。プロンプトとリソースはスキルレイヤーに残ります。 完全な参照ドキュメントは、抽出されたDispatcher SDK内のdocs/DispatcherMCP.mdで入手できます。