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

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

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

AGENTS.md agentsmd

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

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

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

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

Adobeは、この機能がまだ一般公開されていないため、ブランチのadobe/skillsbeta リポジトリでAEM as a Cloud Service スキルを公開します。

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

AI コーディングツールに適した方法を選択してください。 スキルを一度インストールすれば、そのスキルをそのマシン上のすべてのプロジェクトで利用できるようになります。

クロード・コード claude-code

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

# 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/beta/skills/aem/cloud-service --all

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

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

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

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

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

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

最初に使用すると、スキルはprojectと既存のコンポーネントからpackage、group、pom.xmlを自動的に検出し、検出された値を確認するよう求め、プロジェクトのルートに.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 テストなどがあります。

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 Quickstart MCP サーバーは、ローカルのAEM SDK インスタンスにインストールすると、ランタイムデータを接続されたAI ツールに直接公開するコンテンツパッケージです。これにより、エージェントはIDEから離れることなく、ログを取得し、OSGi エラーを診断し、リクエスト処理を検査できます。

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

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

互換性： 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で入手できます。