DocumentationAEMTutoriels d’AEM as a Cloud Service

Recherche de contenu AEM à l’aide du serveur MCP IA dédiée au contenu

Dernière mise à jour : 23 juillet 2026
  • S'applique à :
  • Experience Manager as a Cloud Service

Créé pour :

  • Beginner
  • Leader
  • User
  • Developer

Utilisez le Content AI MCP Server de Adobe CX Coworker pour rechercher et analyser les index Content AI en langage naturel, sans code API de bas niveau ni navigation dans l’interface utilisateur.

Dans ce tutoriel, vous découvrez les index disponibles, exécutez des recherches mot-clé, sémantique et hybride et utilisez recherche en langage naturel pour exprimer une intention complexe, le tout à partir du programme de travail Adobe CX par rapport à un index IA dédiée au contenu.

Vue d’ensemble

AEM as a Cloud Service fournit des serveurs MCP afin que votre IDE ou votre application de chat puisse fonctionner avec AEM en toute sécurité. Le serveur MCP IA dédiée au contenu expose des outils de recherche sur les index IA dédiée au contenu. Voir Serveurs MCP dans AEM pour plus d’informations.

Le serveur MCP IA dédiée au contenu propose six outils :

Outil
Objectif
list_indexes
Découvrez les index disponibles dans votre environnement AEM.
get_index_config
Inspectez la configuration et les métadonnées de l’index brut.
fulltext_search
Recherche par mot-clé avec correspondance approximative et sélection de champ.
semantic_search
Recherche par analogie vectorielle de requêtes conceptuelles.
hybrid_search
Mot-clé combiné + recherche sémantique pour le meilleur rappel d’usage général.
natural_language_search
Exprimez l’intention en anglais clair : le serveur la traduit en filtres, plages et sémantiques structurés.

Le serveur MCP IA dédiée au contenu prend en charge deux modes d’accès, sélectionnés par lequel l’en-tête que vous configurez :

  • Public (anonyme) — Recherchez des index publics, en lecture seule à l’aide de l’en-tête X-Api-Key. Utilisez cette option pour le contenu non sensible et disponible ouvertement. Voir ​ Recherche d’index publics ​.
  • Authentifié — Recherchez les index autorisés ou contrôlés par l’accès à l’aide de l’en-tête x-content-ai-mcp-api-key avec votre identité Adobe connectée (transmise par le collègue CX). Les résultats respectent vos autorisations.

Comment les développeurs peuvent-ils l’utiliser ?

Connectez Adobe CX Coworker au serveur MCP IA dédiée au contenu et exécutez le scénario ci-dessous.

Configuration - Serveur MCP IA dédiée au contenu dans Adobe CX Coworker

Configurez le serveur MCP IA dédiée au contenu dans Adobe CX Coworker en procédant comme suit.

  1. Connectez-vous à Adobe CX Coworker.

    Collègue Adobe CX

  2. Dans le rail latéral, cliquez sur Serveurs MCP.

    ​ Rail latéral des serveurs MCP ​

  3. Cliquez sur Ajouter un serveur MCP.

    Ajouter un serveur MCP

  4. Dans la boîte de dialogue Ajouter un serveur MCP, saisissez les informations suivantes :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Champ Valeur
    Nom du serveur content-ai-mcp
    URL MCP https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    Type de connexion HTTP
    Type d’authentification Passthrough

    ​ Boîte de dialogue Ajouter un serveur MCP ​

    note
    NOTE
    Le type d’authentification est défini sur Passthrough afin que CX Coworker transfère votre identité Adobe connectée au serveur MCP. Vous n’avez pas besoin d’une connexion distincte ni d’une étape OAuth.

  5. Cliquez sur Ajouter des en-têtes et ajoutez les en-têtes pour le mode d’accès dont vous avez besoin :

    Pour les index publics (anonymes) :

    table 0-row-2 1-row-2 2-row-2
    En-tête Valeur
    X-Api-Key Votre clé API publique. Présentez cet en-tête lorsque vous souhaitez uniquement rechercher des index publics.
    x-content-ai-mcp-routing (Facultatif) Informations sur l’environnement/le routage, par exemple tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.

    Pour les index non publics (autorisés) :

    table 0-row-2 1-row-2 2-row-2
    En-tête Valeur
    x-content-ai-mcp-api-key Clé API de 🔗.
    x-content-ai-mcp-routing (Facultatif) Informations sur l’environnement/le routage, par exemple tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.
    note important
    IMPORTANT
    Lorsque l’en-tête X-Api-Key est présent, le serveur traite la requête comme anonyme et ne recherche que les index publics. Toute identité de connexion est ignorée, il n’y a donc aucune réaffectation accidentelle vers l’accès authentifié. Utilisez x-content-ai-mcp-api-key (non X-Api-Key) lorsque vous avez l’intention de rechercher des index intitulés.
    note
    NOTE
    Si vous ne définissez pas l’en-tête x-content-ai-mcp-routing, le serveur demande votre environnement (tier et bucket) dans le chat la première fois que vous exécutez un outil, puis réessaie automatiquement.

  6. Cliquez sur Add (Ajouter). Le serveur content-ai-mcp apparaît désormais dans la liste des serveurs MCP.

    Content AI MCP Server répertorié

  7. Cliquez sur Nouvelle conversation pour commencer à utiliser le serveur MCP IA dédiée au contenu.

    Nouvelle conversation

Recherche dans les index publics

Certains index IA dédiée au contenu sont marqués publics et peuvent faire l’objet de recherches anonymes, sans identité autorisée. Les index publics sont en lecture seule et sont destinés à un contenu non sensible disponible ouvertement. Toute personne disposant de la clé API publique peut effectuer une recherche.

Utilisez ce mode lorsque :

  • Vous souhaitez rechercher du contenu ouvert disponible (par exemple, de la documentation publique ou un catalogue de démonstration).
  • Vous n’avez pas besoin de résultats par utilisateur avec une étendue d’autorisation.
  • Vous avez besoin d’une configuration simple qui ne nécessite qu’une clé API.

Pour rechercher des index publics, ajoutez le serveur Content AI MCP dans CX Coworker exactement comme décrit dans Configuration - Serveur Content AI MCP dans Adobe CX Coworker, mais à l’étape Ajouter des en-têtes ajoutez uniquement l’en-tête X-Api-Key (plus un en-tête x-content-ai-mcp-routing facultatif pour l’environnement) :

En-tête
Valeur
X-Api-Key
Votre clé API publique.
x-content-ai-mcp-routing
(Facultatif) Informations sur l’environnement/le routage, par exemple tier=publish,bucket=p12345-e67890.
IMPORTANT
Lorsque l’en-tête X-Api-Key est présent, le serveur traite la requête comme anonyme et ne recherche que les index publics. Toute identité de connexion est ignorée. N’utilisez pas X-Api-Key lorsque vous avez l’intention de rechercher des index intitulés, utilisez plutôt x-content-ai-mcp-api-key.

Une fois le serveur connecté, découvrez et recherchez les index publics de la même manière que les index authentifiés.

  1. Dans CX Coworker, ouvrez une nouvelle conversation et répertoriez les index publics disponibles pour votre clé API :

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

    Le serveur recherche uniquement des index publics pour cette requête et renvoie les résultats correspondants.

Résumé

Vous configurez le serveur MCP IA dédiée au contenu d’AEM dans Adobe CX Coworker et l’utilisez pour rechercher des index IA dédiée au contenu. Vous avez découvert les index disponibles et les avez recherchés en langage naturel, à l’aide de la recherche par mot-clé, sémantique, hybride et en langage naturel. Vous avez également appris à rechercher anonymement des index publics avec une clé API et à réduire la taille de la réponse à l’aide de la sélection de champ. Vous pouvez utiliser le même flux pour des intervenants humains de CX Coworker pour rechercher et analyser les index IA dédiée au contenu sans passer par une interface utilisateur ou écrire du code d’API de recherche de bas niveau.

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