AEM as a Cloud ServiceでのMCPの使用 using-mcp-with-aem-as-a-cloud-service
はじめに introduction
現在、多くのAdobe Experience Manager（AEM）チームは、統合開発環境（IDE）や、Cursor、OpenAI ChatGPT、Anthropic Claude、Microsoft Copilot Studioなどのチャットベースのアプリケーションで作業しています。 これらのアプリケーションは、モデルコンテキストプロトコル（MCP）をサポートしています。これにより、アプリケーションはバックエンドツールを標準化された方法で大規模言語モデル（LLM）に公開できます。
AEMのMCPとの統合により、様々なペルソナが同じコンテンツを中心に共同作業できるようになります。
- 開発者は、IDEまたはチャットアプリケーションからコンテンツ操作とワークフローを調整できます
- 実務担当者およびコンテンツアーキテクトは、AEMの既存の権限モデル内で、AIの支援を受けながら、サイトとコンテンツフラグメントを管理し、アセットをインポートできます。
この記事では、AEMのMCP機能の内容、サポートされているMCP アプリケーション、設定方法、および実際の使用方法について説明します。
MCPがAEMのお客様に役立つ理由 why-mcp-is-useful-for-aem-customers
最新のIDEおよびチャットアプリケーションでは、LLMがMCP サーバーの背後にあるツールを呼び出す方法としてMCPを使用しています。 顧客は、低レベルのAPI仕様に照らしてコードを記述するのではなく、自然言語で意図を説明できます。 例えば、のようなプロンプトを入力すると、「すべてのページにわたってこのキャンペーンのヒーローバナーを更新する」と入力すると、LLMは適切なMCP ツールを呼び出し、その後AEMのAPIとやり取りできます。
主なメリットは次のとおりです。
- API配管の代わりに自然言語による操作
MCP ツールは、使用可能な操作とその呼び出し方法を説明します。 LLMでは、これらのスキーマを使用して、どのツールをどのパラメーターで呼び出すかを決定します。 - アプリケーション間で一貫したエクスペリエンス
複数のMCP互換アプリケーションから同じAEM MCP ツールを使用できるため、同じAEM機能を呼び出しながら、最も生産的な場所で作業できます。 - セキュリティとガバナンスが保持されました
AEM MCP ツールへのリクエストは、認証済みユーザーのIDで実行され、各ツールはユーザーの既存のAEM権限を適用します。 AIを活用したオペレーションは、AEMでの手作業と同じアクセスルールに従います。
AEMが提供するMCP サーバー mcp-servers-provided-by-aem
AEMは、MCP サーバーをHTTP エンドポイントとして公開します。 以下に示すエンドポイントは、次に関連しています。
https://mcp.adobeaemcloud.com/adobe/mcp/
MCP サーバー mcp-servers
/content/content-readonly/cloudmanager各MCP サーバーによって公開される特定のツールは、時間の経過とともに進化する可能性があります。 実際には、MCP対応アプリケーションに、次のようなプロンプトを使用してツールを検索するように依頼できます。
"List all AEM MCP tools available from this server and describe what they do."
MCP クライアントはMCP プロトコルを使用してツールリストとスキーマを取得し、LLMはそれを使用できます。
機能とその使用方法について詳しくは、Content MCP Server TutorialおよびCloud Manager MCP Server Videoを参照してください。
サポートされているMCP アプリケーション supported-mcp-applications
AEMのMCP サーバーは、定義されたMCP互換アプリケーションのセットで動作するように設計されています。 各アプリケーションは独自の設定エクスペリエンスを提供しますが、大まかな手順は似ています。
チャットアプリケーション（Webおよびデスクトップ） chat-applications
- 人道クロード
- OpenAI ChatGPT
開発者用ツール（IDE拡張機能、デスクトップアプリ、CLI） developer-tools
- 人工クロードコード（CLI、JetBrains、VS Code、カーソル）
- 拡張コード（CLI、JetBrains、VS Code、カーソル）
- インデントデスクトップアプリを拡張
- Cline （JetBrains、VS Code、カーソル）
- カーソル
- GitHub Copilot （JetBrains, VS Code）
- Kiro （デスクトップアプリ、CLI）
- OpenAI Codex （デスクトップアプリ）
- OpenAI Codex CLI
- ウィンドサーフ
エンタープライズプラットフォーム enterprise-platforms
- Microsoft Copilot Studio
設定の概要 setup-overview
AEM用のMCPの設定には、次の2つの主要な部分があります。
- 各MCP クライアントアプリケーションの設定。これにより、アプリケーションはAEM MCP サーバーへの接続方法とOAuth ログインの実行方法を認識できます
- MCP クライアントが使用を認識できるように、プロンプトを開始する前にMCP サーバーを選択します。
両方のステップをカバーするステップバイステップガイドは、次の目的で利用できます。
AEM の設定 aem-configuration
デフォルトでは、AEM内の個々のユーザーが持つ権限によって、AEMのMCP サーバーへのアクセスが管理されます。 MCP クライアントアプリケーションを介して認証を行う場合、MCP ツールは、AEMの手動操作と同じアクセスルールを適用します。 ユーザーは、既に実行が許可されているアクションのみを実行できます。
許可されているMCP クライアントアプリケーション permitted-mcp-client-applications
サポートされているMCP アプリケーション にリストされているすべてのアプリケーションは、デフォルトで許可されています。
MCP サーバーの制限 restricting-mcp-servers
デフォルトでは、すべてのMCP サーバが許可リストに加えるされます。 管理者は、組織、プログラム、または環境レベルで特定のMCP サーバーへのアクセスを制限するオプションを使用できます。 この制限により、組織内のユーザーが利用できるMCP機能を詳細に制御できます。
MCP クライアントアクセスの管理 managing-mcp-client-access
管理者は、組織のポリシーでアクセスが必要な場合は、特定のMCP クライアントアプリケーションのアクセスを無効にすることもできます。 Adobeで他のMCP クライアント製品のサポートを有効にする場合は、製品web サイトへのリンクを送信します。 カスタム MCP クライアントを許可リストに加えるする必要がある場合も、連絡してください。
MCP サーバーに関連するすべてのリクエストについては、aemcs-mcp-feedback@adobe.comまでお気軽にお問い合わせください
MCP クライアントアプリケーション設定 mcp-client-application-configuration
各ユーザーがこの手順を実行するか、MCP クライアントアプリケーションの管理者がサポートされている場合に実行できます。 設定の詳細は、アプリケーションによって少し異なります。 MCP クライアントは急速に進化しており、リモート MCP サーバーのサポートが積極的に開発されています。 リモートサーバーを追加する機能にアクセスするには、開発者モードを有効にする必要がある場合がありますが、一般的なプロセスは次のとおりです。
- 1つ以上のAEM MCP サーバーURLを追加する
- 上記の表から1つ以上のMCP エンドポイントを設定します。 次に例を示します。
https://mcp.adobeaemcloud.com/adobe/mcp/content-readonly
- 上記の表から1つ以上のMCP エンドポイントを設定します。 次に例を示します。
- 接続をトリガー
- MCP クライアントアプリケーションがAEM MCP サーバーへの接続を試みるように、設定を保存またはアクティブ化します
- Adobe IDでログイン
- プロンプトが表示されたら、Adobe ログインフローを完了して、アプリケーションがAdobe IDに関連付けられたOAuth トークンを取得できるようにします
- 検出されたツールの確認
- 認証されると、アプリケーションはサーバーからMCP ツールを検出します。 その後、LLMに対してAEM操作を実行するように求めるプロンプトを開始できます。
サポートされているアプリケーションの完全なリストについては、 サポートされているMCP アプリケーション を参照してください。
認証 authentication
AdobeでホストされるMCP サーバーは、OAuthを実装し、Adobe ID システムと統合されます。
- MCP クライアントアプリケーションがAEM MCP サーバーに接続すると、Adobe ログインダイアログが表示され、Adobe IDで認証されます
- ログインが成功すると、システムはMCP クライアントアプリケーションが組織内で許可され、要求されたMCP サーバーが許可されていることを確認します。 いずれかのチェックが失敗すると、エラーメッセージが表示されます。
- MCP サーバーが検証すると、アプリケーションが後続のツール呼び出しに使用するトークンが発行されます
- MCP ツールは、ユーザーのAEM権限を尊重します。 AEMでコンテンツフラグメントを変更する権限を持つユーザーのみが、MCPを介してコンテンツフラグメントを変更できます。
このアプローチにより、AIを活用した運用が、既存のAEMのセキュリティおよびガバナンスモデルに準拠できるようになります。
AEMでのMCPの使用 using-mcp-with-aem
AEMとMCP クライアントアプリケーションを設定したら、任意のアプリケーションで作業し、LLMにAEM操作を実行するように求めることができます。 LLMは、MCP ツールスキーマを読み取り、呼び出すツールを選択し、必要に応じてシーケンス化して、リクエストを処理します。
使用例 example-usecases
代表的なシナリオには、次のようなものがあります。
-
環境の検出
- ワークフローを実行する場所を決定するための環境とライセンスのリスト。
-
サイト管理
- サイトの一覧表示
- ページとページコンテンツを作成、読み取り、更新、削除します。
-
コンテンツフラグメント管理
- コンテンツフラグメントの検索
- 新しいフラグメントを作成
- キャンペーンメッセージが変更された場合に既存のフラグメントを更新します。
-
アセットの読み込み
- ステータスチェック付きアセットの読み込み
ワークフローの例 example-workflows
次の例は、LLMがMCP ツールを連鎖させる方法を示しています。
-
ページで参照されているコンテンツフラグメントの操作
- ページコンテンツを取得 -
get-aem-page-contentなどのツールを呼び出して、ページを取得し、fragmentPathプロパティを見つけます。 - フラグメントパスを解決 -
resolve_fragment_pathを使用してパスをUUIDに変換します。 - フラグメントデータを取得 -
get_fragmentを呼び出して、現在のフィールドを取得します。 - フラグメントを更新 -
patch_fragmentを呼び出して、フラグメントコンテンツに変更を適用します。
- ページコンテンツを取得 -
-
モデルに基づく新しいコンテンツの作成
- モデルを見つける -
list_modelsを使用して、使用可能なコンテンツフラグメントモデルを確認します。 - モデルを検査 -
get_modelを使用して、モデルのフィールドスキーマを理解します。 - コンテンツを作成 -
create_fragmentを使用して、プロンプトから派生した値を持つ新しいフラグメントを作成します。
- モデルを見つける -
-
既存のコンテンツを安全に更新する
- 現在のデータを読み取る -
get_fragmentを使用して、既存のデータとETagを取得します。 - JSON パッチを適用 - ETagとJSON パッチドキュメントで
patch_fragmentを使用してフラグメントを更新し、楽観的な同時実行をサポートします。
- 現在のデータを読み取る -
ユーザーの観点からは、次のようなプロンプトを使用してこれらのワークフローを開始できます。
"Create a new content fragment for the spring campaign based on our hero banner model and fill in its fields from this brief."
LLMは、必要なMCP ツールを自動的に選択して調整します。
期待管理 expectation-management
MCPを通じてLLMを使用する場合は、次の点に留意してください。
-
高度な機能を備えているが間違いがない
LLMは複雑なタスクを実行できますが、ミスが発生することがあります。 同じプロンプトでも、明確な理由がなくても、結果やプレゼンテーションが少し異なる場合があります。 本番コンテンツに変更を適用する前に、必ず出力を確認してください。 -
機能の進化
LLM モデルは継続的に改善されています。 時間の経過とともに、MCP ツールを組み合わせて目標を達成するための新しい方法を見出す能力が高まります。 今日、複数のプロンプトを入力する必要があったタスクは、明日には1つのプロンプトとシームレスに連携する可能性があります。 -
人間による監視が不可欠です：
LLMは、監督を必要とする知識豊富なアシスタントだと考えてください。 幅広い知識を備えており、クリエイティブソリューションを考案することもできますが、ガイダンスとレビューから利点があります。 特に重要な操作について結果を検証し、出力が期待に沿わない場合にフィードバックを提供します。 -
ツールの自動確認に注意する
Claudeなどの一部のMCP クライアントアプリケーションでは、LLMから要求されたツール実行を自動承認するオプションが提供されています。 このオプションは、コンテンツの検索や取得などの読み取り専用の操作には便利ですが、コンテンツを更新または削除するツールでは注意が必要です。 AEM環境を変更するアクションを確認する前に、各ツールの実行リクエストを確認します。
制限事項 limitations
AEMは現在、 サポートされているMCP アプリケーション に記載されているアプリケーションでMCP サーバーの設定をサポートしています。
別のMCP クライアントアプリケーションを使用する場合は、お気軽に aemcs-mcp-feedback@adobe.com に連絡して、その他のクライアントのサポートをリクエストするか、カスタムクライアントを許可リストに加えるしてください。