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

AEMコンテンツを自然言語で検索、分析

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

作成対象：

  • Beginner
  • Leader
  • User
  • Developer

Adobe CX Coworkerの​Content AI MCP Server （AEM MCP Serverのコンパニオン）を使用して、低レベルのAPI コードを記述したりUIを操作したりすることなく、Content AI ソースを自然言語で検索および分析します。

このチュートリアルでは、利用可能なソースを​ 検索 ​し、キーワード、セマンティック、ハイブリッド​の検索を実行し、自然言語検索​を使用して複雑な意図を表現します。これらはすべて、Adobe CX CoworkerからContent AI ソースに対して実行されます。

ツールとアクセス

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

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

Content AI MCP Server is public-source-only: X-Api-Key ヘッダーはソースアクセスを許可します。 API キーが必要です。このキーを含まないリクエストは拒否されます。

IMPORTANT
MCP セッションの認証に使用されるログイン Adobe IDまたはOAuth/IMS ベアラートークンは、Content AIに​転送されることはなく、検索できるソースに影響はありません。 サインイン IDの他の使用権限に関係なく、このサーバーを通じて検索できるのは、公開された読み取り専用のソースのみです。

Content AI MCP Serverの追加

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

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

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

    Adobe CX Coworker ログイン ​ {modal="regular"}

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

    MCP サーバーサイド レール ​ {modal="regular"}

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

    MCP サーバーを追加 {modal="regular"}

  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 サーバーダイアログの追加 {modal="regular"}

    note
    NOTE
    認証タイプ​はPassthroughに設定されているため、CX Coworkerはサインイン済みのAdobe IDをMCP Serverに転送します。 このIDはコンテンツ AI ソースへのアクセスに使用されないため（​ ツールとアクセス ​を参照）、検索自体に個別のサインインまたはOAuth ステップは必要ありません。

  5. 「ヘッダーを追加」をクリックして、次を追加します。

    table 0-row-2 1-row-2 2-row-2
    ヘッダー 値
    X-Api-Key コンテンツ AI API キー。 必須 – 検索は拒否されます。
    x-content-ai-mcp-routing （オプション）​環境/ルーティング情報（例：tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example）。
    note
    NOTE
    x-content-ai-mcp-routing ヘッダーを設定しない場合、サーバーは初めてツールを実行したときにチャットで環境（tierとbucket）を要求し、自動的に再試行します。
    natural_language_searchは、他の5つのツールよりも必要です。tierとbucketに加えて、cluster​と​**namespace**​がルーティングに必要です。 どちらも見つからない場合、ツールはmissing_nls_routing エラーを返します。見つからない値を返すと、サーバーは自動的に再試行します。

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

    ​ コンテンツ AI MCP サーバーがリストされています {modal="regular"}

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

    新しいチャット ​ {modal="regular"}

パブリックソースの検索

このサーバーを通じて公開されるコンテンツ AI ソースは​ public ​です。読み取り専用で、オープンに利用可能な機密性のないコンテンツを対象としています。 有効なAPI キーを持っている人なら誰でも検索できます。

このサーバーは、次の場合に使用します。

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

​ コンテンツ AI MCP サーバーを追加の説明に従ってサーバーが接続されている場合、チャットから直接ソースを検索して検索します。

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

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

    サーバーは、ルーティング/環境に一致するパブリックソースを返します。

おめでとうございます。

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

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