Buscar contenido de AEM mediante el servidor MCP de inteligencia artificial aplicada al contenido
Use Content AI MCP Server de Adobe CX Coworker para buscar y analizar índices de inteligencia artificial aplicada al contenido en lenguaje natural, sin código de API de bajo nivel ni navegación por la interfaz de usuario.
En este tutorial, descubrirá índices disponibles, ejecutará las búsquedas de keyword, semantic e hybrid, y usará la búsqueda de lenguaje natural para expresar intenciones complejas, todo desde Adobe CX Coworker con un índice de inteligencia artificial aplicada al contenido.
Información general
AEM as a Cloud Service proporciona servidores MCP para que su aplicación de chat o IDE pueda trabajar con AEM de forma segura. El servidor MCP de inteligencia artificial aplicada al contenido expone las herramientas de búsqueda y detección a través de los índices de inteligencia artificial aplicada al contenido. Consulte Servidores MCP en AEM para obtener más información.
El servidor MCP de Content AI proporciona seis herramientas:
list_indexesget_index_configfulltext_searchsemantic_searchhybrid_searchnatural_language_searchEl servidor MCP de inteligencia artificial aplicada al contenido admite dos modos de acceso, seleccionados por el encabezado que configure:
- Público (anónimo): busque índices públicos de solo lectura usando el encabezado
X-Api-Key. Utilice esto para contenido no confidencial y abiertamente disponible. Consulte Búsqueda de índices públicos. - Autenticado: busque índices autorizados o controlados por acceso usando el encabezado
x-content-ai-mcp-api-keyjunto con su identidad de Adobe iniciada (pasada por CX Coworker). Los resultados respetan sus permisos.
Cómo pueden usarlo los desarrolladores
Conecte a Adobe CX Coworker al servidor MCP de inteligencia artificial aplicada al contenido y ejecute el siguiente escenario.
Configuración: Content AI MCP Server en Adobe CX Coworker
Vamos a configurar Content AI MCP Server en Adobe CX Coworker siguiendo estos pasos.
-
Inicie sesión en Adobe CX Coworker.
-
En el carril lateral, haga clic en Servidores MCP.
-
Haga clic en Agregar servidor MCP.
-
En el cuadro de diálogo Agregar servidor MCP, escriba los siguientes detalles:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Campo Valor Nombre de servidor content-ai-mcpURL de MCP https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-aiTipo de conexión HTTPTipo de autenticación Passthrough
note NOTE El tipo de autenticación está establecido en Passthrough, por lo que CX Coworker reenvía su identidad de Adobe que ha iniciado sesión al servidor MCP. No necesita un inicio de sesión o un paso de OAuth independiente. -
Haga clic en Agregar encabezados y agregue los encabezados para el modo de acceso que necesita:
Para índices públicos (anónimos):
table 0-row-2 1-row-2 2-row-2 Encabezado Valor X-Api-KeySu clave API pública. Presente este encabezado cuando solo desee buscar índices públicos. x-content-ai-mcp-routing(Opcional) Información de entorno/enrutamiento, por ejemplo tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.Para índices no públicos (con derecho):
table 0-row-2 1-row-2 2-row-2 Encabezado Valor x-content-ai-mcp-api-keyLa clave API de Adobe Developer Console. x-content-ai-mcp-routing(Opcional) Información de entorno/enrutamiento, por ejemplo tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.note important IMPORTANT Cuando el encabezado X-Api-Keyestá presente, el servidor trata la solicitud como anónima y solo busca índices públicos. Se ignora cualquier identidad iniciada, por lo que no hay escalación accidental al acceso autenticado. Usex-content-ai-mcp-api-key(noX-Api-Key) cuando quiera buscar índices con derechos.note NOTE Si no establece el encabezado x-content-ai-mcp-routing, el servidor solicitará el entorno (tierybucket) en el chat la primera vez que ejecute una herramienta y, a continuación, volverá a intentarlo automáticamente. -
Haga clic en Agregar. El servidor content-ai-mcp aparece ahora en su lista de servidores MCP.
-
Haga clic en Nuevo chat para empezar a usar el servidor MCP de inteligencia artificial aplicada al contenido.
Búsqueda de índices públicos
Algunos índices de inteligencia artificial aplicada al contenido están marcados como públicos y se pueden buscar de forma anónima, sin una identidad con derecho. Los índices públicos son de solo lectura y están pensados para contenido no confidencial disponible abiertamente. Cualquier persona con la clave API pública puede buscarlos.
Utilice este modo cuando:
- Desea buscar contenido disponible abiertamente (por ejemplo, documentación pública o un catálogo de demostración).
- No necesita resultados con ámbito de permisos de cada usuario.
- Desea una configuración sencilla que solo requiera una clave de API.
Para buscar índices públicos, agregue Content AI MCP Server en CX Coworker exactamente como se describe en Configuración - Content AI MCP Server en Adobe CX Coworker, pero en el paso Agregar encabezados agregue solo el encabezado X-Api-Key (además de un encabezado x-content-ai-mcp-routing opcional para el entorno):
X-Api-Keyx-content-ai-mcp-routingtier=publish,bucket=p12345-e67890.X-Api-Key está presente, el servidor trata la solicitud como anónima y solo busca índices públicos. Se ignorará cualquier identidad con sesión iniciada. No use X-Api-Key cuando pretenda buscar índices válidos, use x-content-ai-mcp-api-key en su lugar.Con el servidor conectado, descubra y busque índices públicos del mismo modo que los índices autenticados.
-
En CX Coworker, abra un nuevo chat y enumere los índices públicos disponibles para su clave de API:
code language-text List all Content AI indexes available in my environment.El servidor solo busca índices públicos para esta solicitud y devuelve resultados coincidentes.
Resumen
Ha configurado el servidor MCP de AEM Content AI en Adobe CX Coworker y lo ha utilizado para buscar índices de Content AI. Ha descubierto índices disponibles y los ha buscado en lenguaje natural, usando búsqueda de palabras clave, semántica, híbrida y en lenguaje natural. También aprendió a buscar índices públicos de forma anónima con una clave de API y a reducir el tamaño de la respuesta al seleccionar los campos. Puede utilizar el mismo flujo centrado en las personas de CX Coworker para buscar y analizar índices de inteligencia artificial aplicada al contenido sin cambiar a una interfaz de usuario ni escribir código de API de búsqueda de bajo nivel.