文档AEMAEM as a Cloud Service 教程

使用Content AI MCP服务器搜索AEM Content

最近更新： 2026年7月23日
  • 适用对象：
  • Experience Manager as a Cloud Service

创建对象：

  • Beginner
  • Leader
  • User
  • Developer

使用来自Adobe CX Co-worker的​ Content AI MCP服务器 ​以自然语言（无低级API代码或UI导航）搜索和分析Content AI索引。

在本教程中，您​ 发现 ​可用的索引，运行​关键字、语义​和​ 混合 ​搜索，并使用​ 自然语言搜索 ​来表达复杂的意图，所有这些搜索都是针对Content AI索引从Adobe CX Co-worker获得的。

概述

AEM as a Cloud Service提供​MCP服务器，以便您的IDE或聊天应用可以安全地与AEM配合使用。 Content AI MCP服务器​通过Content AI索引公开搜索和发现工具。 有关详细信息，请参阅AEM🔗中的MCP服务器。

Content AI MCP Server提供六种工具：

工具
用途
list_indexes
发现AEM环境中的可用索引。
get_index_config
检查原始索引配置和元数据。
fulltext_search
基于关键字的模糊匹配和字段选择搜索。
semantic_search
基于向量的概念查询相似性搜索。
hybrid_search
结合关键词+语义搜索实现最佳通用召回率。
natural_language_search
用浅显的英语表达意图；服务器将其转换为结构化筛选器、范围和语义。

Content AI MCP服务器支持两种访问模式，选择这两种模式后，将根据哪种标头进行配置：

  • 公共（匿名） — 使用X-Api-Key标头搜索公共、只读索引。 将其用于公开的、非敏感的内容。 请参阅搜索公共索引。
  • 已通过身份验证 — 使用x-content-ai-mcp-api-key标头以及您的登录Adobe身份（由CX Co-worker传递）搜索授权索引或访问控制索引。 结果会尊重您的权限。

开发人员可怎样使用它

将Adobe CX Co-worker连接到Content AI MCP Server并运行以下方案。

设置 — Adobe CX Co-worker中的Content AI MCP Server

让我们按照以下步骤在Adobe CX Co-worker中设置Content AI MCP Server。

  1. 登录到Adobe CX Co-worker。

    Adobe CX Co-worker登录

  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 Co-worker将您的登录Adobe身份转发给MCP服务器。 您不需要单独的登录或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标头时，服务器将该请求视为​匿名，并且只搜索公共索引。 任何登录身份都会被忽略，因此不会意外升级为经过身份验证的访问。 当您打算搜索授权索引时，请使用x-content-ai-mcp-api-key （而不是X-Api-Key）。
    note
    NOTE
    如果未设置x-content-ai-mcp-routing标头，则服务器会在您首次运行工具时在聊天中询问您的环境（tier和bucket），然后自动重试。

  6. 单击​添加。 content-ai-mcp​服务器现在出现在您的MCP服务器列表中。

    已列出Content AI MCP服务器

  7. 单击​ 新建聊天 ​以开始使用Content AI MCP服务器。

    新聊天

搜索公共索引

某些Content AI索引标记为​public，可以匿名搜索，没有授权的标识。 公共索引是只读的，用于公开的非敏感内容。 拥有公共API密钥的任何人都可以搜索它们。

在以下情况下使用此模式：

  • 您要搜索公开可用的内容（例如，公共文档或演示目录）。
  • 您不需要每个用户、权限范围内的结果。
  • 您需要一个仅需要API密钥的简单设置。

要搜索公共索引，请完全按照Adobe CX Co-worker中的设置 — Content AI MCP Server中的说明添加CX Co-worker中的Content AI MCP Server，但在​ 添加标头 ​步骤中仅添加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标头时，服务器将该请求视为​匿名，并且只搜索公共索引。 任何登录身份都将被忽略。 当您打算搜索授权索引时，不要使用X-Api-Key，请改用x-content-ai-mcp-api-key。

连接服务器后，发现并搜索公共索引的方式与已验证索引相同。

  1. 在CX Co-worker中，打开新聊天并列出可用于您的API密钥的公共索引：

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

    服务器仅搜索此请求的公共索引并返回匹配结果。

摘要

您可以在Adobe CX Co-worker中设置AEM Content AI MCP服务器，并使用它搜索Content AI索引。 您发现了可用的索引，并使用关键字、语义、混合和自然语言搜索以自然语言搜索这些索引。 您还学习了如何使用API密钥匿名搜索​公共索引，以及如何通过选择字段来减小响应大小。 您可以使用来自CX Co-worker的相同以人为中心的流程来搜索和分析Content AI索引，而无需切换到UI或编写低级搜索API代码。

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