ドキュメントAEMAEM as a Cloud Service のチュートリアル

Content AI MCP Serverを使用したAEM コンテンツの検索

最終更新日： 2026年7月23日
  • 適用対象：
  • Experience Manager as a Cloud Service

作成対象：

  • Beginner
  • Leader
  • User
  • Developer

Adobe CX Coworkerの​ Content AI MCP Server ​を使用して、低レベルのAPI コードやUI ナビゲーションを使用せずに、Content AI インデックスを自然言語で検索および分析します。

このチュートリアルでは、discover​使用可能なインデックスを検索し、keyword、semantic、hybrid​の検索を実行し、自然言語検索​を使用して複雑な意図を表現します。これらはすべて、Adobe CX CoworkerからContent AI インデックスに対して実行されます。

概要

AEM as a Cloud Serviceは​ MCP サーバー ​を提供しているため、IDEまたはチャットアプリはAEMと安全に連携できます。 Content AI MCP Server​は、Content AI インデックス上に検索ツールと検出ツールを公開します。 詳しくは、AEMのMCP サーバーを参照してください。

Content AI MCP Serverには、次の6つのツールがあります。

ツール
目的
list_indexes
AEM環境で使用可能なインデックスを検索します。
get_index_config
生のインデックス設定とメタデータを調べます。
fulltext_search
ファジーマッチングとフィールド選択によるキーワードベース検索。
semantic_search
概念クエリのベクトルベースの類似性検索。
hybrid_search
キーワードとセマンティック検索を組み合わせて、最適な汎用的リコールを実現。
natural_language_search
意図を平易な英語で表現します。サーバーはそれを構造化されたフィルター、範囲、およびセマンティクスに翻訳します。

Content AI MCP Serverでは、設定するヘッダーによって選択される2つのアクセスモードをサポートしています。

  • パブリック （匿名） — X-Api-Key ヘッダーを使用して、パブリックで読み取り専用のインデックスを検索します。 これは、機密性の低いオープン利用可能なコンテンツに使用できます。 公開インデックスの検索を参照してください。
  • 認証済み — x-content-ai-mcp-api-key ヘッダーとサインイン済みAdobe ID （CX Coworkerによって渡される）を使用して、資格のあるインデックスまたはアクセス制御されたインデックスを検索します。 結果はユーザーの権限を尊重します。

開発者による使用方法

Adobe CX CoworkerをContent AI MCP Serverに接続し、以下のシナリオを実行します。

セットアップ - Adobe CX CoworkerのContent AI MCP Server

Adobe CX CoworkerでContent AI MCP Serverを設定するには、次の手順に従います。

  1. Adobe CX Coworkerにログインします。

    Adobe CX共同作業者ログイン ​

  2. サイドレールで、MCP サーバー​をクリックします。

    MCP サーバーサイド レール ​

  3. 「MCP サーバーを追加」をクリックします。

    MCP サーバーを追加

  4. MCP サーバー​を追加ダイアログで、次の詳細を入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    フィールド 値
    サーバー名 content-ai-mcp
    MCP URL https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    接続タイプ HTTP
    認証タイプ Passthrough

    MCP サーバーダイアログの追加

    note
    NOTE
    認証タイプ​はPassthroughに設定されているため、CX CoworkerはサインインしたAdobe IDをMCP Serverに転送します。 個別のサインインやOAuth手順は必要ありません。

  5. 「ヘッダーを追加」をクリックし、必要なアクセスモードのヘッダーを追加します。

    公開インデックス （匿名）の場合：

    table 0-row-2 1-row-2 2-row-2
    ヘッダー 値
    X-Api-Key 公開API キー。 公開インデックスのみを検索する場合は、このヘッダーを表示します。
    x-content-ai-mcp-routing （オプション）​環境/ルーティング情報（例：tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example）。

    非公開（使用権限が付与された）インデックス：

    table 0-row-2 1-row-2 2-row-2
    ヘッダー 値
    x-content-ai-mcp-api-key Adobe Developer ConsoleのAPI キー。
    x-content-ai-mcp-routing （オプション）​環境/ルーティング情報（例：tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example）。
    note important
    IMPORTANT
    X-Api-Key ヘッダーが存在する場合、サーバーはリクエストを​ 匿名 ​として処理し、公開インデックスのみを検索します。 ログイン IDは無視されるので、認証済みアクセスに誤ってエスカレーションされることはありません。 使用権限のあるインデックスを検索する場合は、x-content-ai-mcp-api-key （X-Api-Keyではなく）を使用してください。
    note
    NOTE
    x-content-ai-mcp-routing ヘッダーを設定しない場合、サーバーは初めてツールを実行したときにチャットで環境（tierとbucket）を要求し、自動的に再試行します。

  6. 「追加」をクリックします。 content-ai-mcp サーバーがMCP サーバーのリストに表示されるようになりました。

    ​ コンテンツ AI MCP サーバーがリストされています

  7. 「新しいチャット」をクリックして、Content AI MCP Serverの使用を開始します。

    新しいチャット ​

公開インデックスの検索

一部のコンテンツ AI インデックスは​ public ​とマークされ、権限のあるIDなしで匿名で検索できます。 公開インデックスは読み取り専用で、機密性のないオープン利用可能なコンテンツを対象としています。 公開API キーを持っている人なら誰でも検索できます。

このモードは、次の場合に使用します。

  • 公開されているコンテンツ（公開ドキュメントやデモカタログなど）を検索する。
  • ユーザーごとに、権限の範囲に応じた結果は必要ありません。
  • API キーのみを必要とするシンプルな設定が必要です。

公開インデックスを検索するには、Setup - Content AI MCP Server in Adobe CX Coworkerで説明されているとおりにContent AI MCP Server in CX Coworkerを正確に追加します。ただし、Add headers​手順では、X-Api-Key ヘッダーのみを追加します（オプションでx-content-ai-mcp-routing ヘッダーを追加します）。

ヘッダー
値
X-Api-Key
公開API キー。
x-content-ai-mcp-routing
（オプション）​環境/ルーティング情報（例：tier=publish,bucket=p12345-e67890）。
IMPORTANT
X-Api-Key ヘッダーが存在する場合、サーバーはリクエストを​ 匿名 ​として処理し、公開インデックスのみを検索します。 ログイン IDはすべて無視されます。 資格のあるインデックスを検索する場合は、X-Api-Keyを使用しないでください。代わりに、x-content-ai-mcp-api-keyを使用してください。

サーバーが接続されている場合は、認証済みインデックスと同じように公開インデックスを検索して検索します。

  1. CX Coworkerで、新しいチャットを開き、API キーで使用可能な公開インデックスを一覧表示します。

    code language-text 
    List all Content AI indexes available in my environment.

    サーバーは、このリクエストの公開インデックスのみを検索し、一致する結果を返します。

概要

Adobe CX CoworkerでAEM Content AI MCP Serverを設定し、それを使用してContent AI インデックスを検索します。 キーワード、セマンティック、ハイブリッド、自然言語検索を使用して、利用可能なインデックスを発見し、自然言語で検索しました。 また、API キーを使用して​ 公開インデックス ​を匿名で検索する方法と、フィールド選択で応答サイズを削減する方法についても学習しました。 CX Coworkerと同様の人間中心のフローを使用することで、UIに切り替えたり、低レベルの検索API コードを記述したりすることなく、コンテンツ AI インデックスを検索および分析できます。

recommendation-more-help
experience-manager-learn-help-cloud-service