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

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

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

作成対象：

  • Beginner
  • Leader
  • User
  • Developer

Adobe CX Enterprise CoworkerのAEM MCP Serverのコンパニオンである​ Content AI MCP Server ​を使用して、自然言語でContent AI コンテンツ ソースを検索および分析します。低レベルのAPI コードやUI ナビゲーションは使用できません。

このチュートリアルでは、利用可能なコンテンツソースを​検索し、キーワード、セマンティック、ハイブリッド​の検索を実行し、生成検索​を使用して、Coworkerからコンテンツ AI コンテンツソースに対する回答を取得します。

ツールとアクセス

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

ツール
目的
list_content_sources
AEM環境で利用可能なコンテンツソースを検索します。
get_content_source_config
生のコンテンツソースの設定とメタデータを調べます。
fulltext_search
ファジーマッチングとフィールド選択によるキーワードベース検索。
semantic_search
概念クエリのベクトルベースの類似性検索。
hybrid_search
キーワードとセマンティック検索を組み合わせて、最適な汎用的リコールを実現。
gen_search
生のドキュメントを返す代わりに、一致するコンテンツから合成された回答を生成します。

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

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

Content AI MCP Serverの追加

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

CoworkerでContent AI MCP Serverを設定します。

  1. 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に設定されているため、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-Api-Key コンテンツ AI 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）を要求し、自動的に再試行します。
    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 ​とマークされ、権限のあるIDなしで匿名で検索できます。 パブリックコンテンツソースは読み取り専用で、機密性のないオープン利用可能なコンテンツを目的としています。 公開API キーを持っている人なら誰でも検索できます。

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

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

パブリックコンテンツソースを検索するには、​ コンテンツ AI MCP サーバーをCoworkerに正確に追加します（ コンテンツ AI MCP サーバーを追加します）。ただし、ヘッダーを追加​の手順では、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. Coworkerで、新しいチャットを開き、API キーで使用可能な公開コンテンツソースを一覧表示します。

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

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

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

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

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