DokumentationAEMTutorials zu AEM as a Cloud Service

Durchsuchen von AEM-Inhalten mit dem Content AI MCP Server

Letzte Aktualisierung: 23. Juli 2026
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • Beginner
  • Leader
  • User
  • Developer

Verwenden Sie den Content AI MCP Server von Adobe CX Coworker, um Content AI-Indizes in natürlicher Sprache, ohne API-Code auf niedriger Ebene oder Benutzeroberflächennavigation zu durchsuchen und zu analysieren.

In diesem Tutorial Sie verfügbare, Suchvorgänge mit Keyword, Semantic und Hybrid und verwenden Natural Language Search, um komplexe Absichten auszudrücken - alles von Adobe CX Coworker für einen Content AI-Index.

Überblick

AEM as a Cloud Service stellt MCP-Server bereit, damit Ihre IDE- oder Chat-App sicher mit AEM arbeiten kann. Der Content AI MCP Server stellt Such- und Erkennungstools für Content AI-Indizes bereit. Weitere Informationen finden ​ unter „MCP- in AEM".

Der Content AI MCP Server bietet sechs Tools:

Tool
Zweck
list_indexes
Verfügbare Indizes in Ihrer AEM-Umgebung entdecken.
get_index_config
Überprüfen Sie die Rohindexkonfiguration und die Metadaten.
fulltext_search
Keyword-basierte Suche mit Fuzzy Matching und Feldauswahl.
semantic_search
Vektorbasierte Ähnlichkeitssuche für konzeptionelle Abfragen.
hybrid_search
Kombinierte Keyword- und semantische Suche für den besten Allzweck-Recall.
natural_language_search
Bekunden Sie die Absicht in einfachem Englisch; der Server übersetzt sie in strukturierte Filter, Bereiche und Semantik.

Der Content AI MCP Server unterstützt zwei Zugriffsmodi, die von der konfigurierten -Kopfzeile ausgewählt werden:

  • Öffentlich (anonym) - Suchen Sie mithilfe des X-Api-Key-Headers nach öffentlichen, schreibgeschützten Indizes. Verwenden Sie diese Option für offen verfügbare, nicht vertrauliche Inhalte. Siehe Suchen öffentlicher Indizes.
  • Authentifiziert - Suchen Sie mithilfe des x-content-ai-mcp-api-key-Headers und Ihrer angemeldeten Adobe-Identität nach Indizes mit Berechtigungen oder Zugriffssteuerung (durch CX Coworker weitergeleitet). Die Ergebnisse berücksichtigen Ihre Berechtigungen.

So können Entwickler es verwenden

Verbinden Sie Adobe CX Coworker mit dem Content AI MCP-Server und führen Sie das folgende Szenario aus.

Setup - Content AI MCP Server in Adobe CX Coworker

Richten wir den Content AI MCP Server in Adobe CX Coworker wie folgt ein.

  1. Melden Sie sich bei Adobe CX Coworker an.

    Adobe CX-Mitarbeiter-Anmeldung

  2. Klicken Sie in der Seitenleiste auf MCP-Server.

    MCP-Server-Seitenleiste

  3. Klicken Sie MCP-Server hinzufügen.

    MCP-Server hinzufügen

  4. Geben im Dialogfeld MCP-Server hinzufügen“ die folgenden Details ein:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Feld Wert
    Server-Name content-ai-mcp
    MCP-URL https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    Verbindungstyp HTTP
    Authentifizierungstyp Passthrough

    Dialogfeld „MCP-Server hinzufügen“

    note
    NOTE
    Authentifizierungstyp ist auf Passthrough festgelegt, sodass CX Coworker Ihre angemeldete Adobe-Identität an den MCP-Server weiterleitet. Sie benötigen keinen separaten Anmelde- oder OAuth-Schritt.

  5. Klicken Sie Kopfzeilen hinzufügen und fügen Sie die Kopfzeilen für den benötigten Zugriffsmodus hinzu:

    Für öffentliche Indizes (anonym):

    table 0-row-2 1-row-2 2-row-2
    Kopfzeile Wert
    X-Api-Key Ihr öffentlicher API-Schlüssel. Zeigen Sie diese Kopfzeile an, wenn Sie nur öffentliche Indizes durchsuchen möchten.
    x-content-ai-mcp-routing (Optional) Umgebung/Routing-Informationen, z. B. tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.

    Für nicht öffentliche (berechtigte) Indizes:

    table 0-row-2 1-row-2 2-row-2
    Kopfzeile Wert
    x-content-ai-mcp-api-key Der API-Schlüssel aus der Adobe Developer Console.
    x-content-ai-mcp-routing (Optional) Umgebung/Routing-Informationen, z. B. tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.
    note important
    IMPORTANT
    Wenn der X-Api-Key-Header vorhanden ist, behandelt der Server die Anfrage als anonym und durchsucht nur öffentliche Indizes. Jede angemeldete Identität wird ignoriert, sodass es keine versehentliche Eskalation zum authentifizierten Zugriff gibt. Verwenden Sie x-content-ai-mcp-api-key (nicht X-Api-Key), wenn Sie nach berechtigten Indizes suchen möchten.
    note
    NOTE
    Wenn Sie den x-content-ai-mcp-routing-Header nicht festlegen, fragt der Server beim ersten Ausführen eines Tools nach Ihrer Umgebung (tier und bucket) im Chat und versucht es dann automatisch erneut.

  6. Klicken Sie auf Hinzufügen. Der content-ai-mcp-Server wird jetzt in der Liste der MCP-Server angezeigt.

    Content AI-MCP-Server aufgelistet

  7. Klicken Sie auf Neuer Chat, um den Content AI MCP Server zu verwenden.

    Neuer Chat

Durchsuchen öffentlicher Indizes

Einige Content-KI-Indizes sind öffentlich und können anonym ohne berechtigte Identität durchsucht werden. Öffentliche Indizes sind schreibgeschützt und für offen verfügbare, nicht vertrauliche Inhalte vorgesehen. Jeder Benutzer mit dem öffentlichen API-Schlüssel kann danach suchen.

Verwenden Sie diesen Modus, wenn:

  • Sie möchten offen verfügbare Inhalte durchsuchen (z. B. öffentliche Dokumentation oder einen Demokatalog).
  • Sie benötigen keine Ergebnisse für einzelne Benutzer bzw. für einzelne Berechtigungen.
  • Sie möchten eine einfache Einrichtung, für die nur ein API-Schlüssel erforderlich ist.

Um öffentliche Indizes zu durchsuchen, fügen Sie den Content AI-MCP-Server in CX Coworker genau wie unter Setup - Content AI-MCP-Server in Adobe CX Coworker beschrieben hinzu, aber fügen Sie im Schritt Kopfzeilen hinzufügen nur den X-Api-Key-Header (plus einen optionalen x-content-ai-mcp-routing-Header für die Umgebung) hinzu:

Kopfzeile
Wert
X-Api-Key
Ihr öffentlicher API-Schlüssel.
x-content-ai-mcp-routing
(Optional) Umgebung/Routing-Informationen, z. B. tier=publish,bucket=p12345-e67890.
IMPORTANT
Wenn der X-Api-Key-Header vorhanden ist, behandelt der Server die Anfrage als anonym und durchsucht nur öffentliche Indizes. Jede angemeldete Identität wird ignoriert. Verwenden Sie X-Api-Key nicht, wenn Sie nach Indizes mit dem Titel suchen möchten, sondern verwenden Sie stattdessen x-content-ai-mcp-api-key.

Wenn der Server verbunden ist, ermitteln und durchsuchen Sie öffentliche Indizes auf die gleiche Weise wie authentifizierte Indizes.

  1. Öffnen Sie in CX Coworker einen neuen Chat und listen Sie die öffentlichen Indizes auf, die für Ihren API-Schlüssel verfügbar sind:

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

    Der Server sucht nur öffentliche Indizes für diese Anfrage und gibt übereinstimmende Ergebnisse zurück.

Zusammenfassung

Sie haben den AEM Content AI MCP Server in Adobe CX Coworker eingerichtet und ihn verwendet, um Content AI-Indizes zu durchsuchen. Sie haben verfügbare Indizes entdeckt und sie in natürlicher Sprache durchsucht, mit Keyword-, semantischer, hybrider und natürlicher Sprachsuche. Sie haben auch gelernt, wie Sie öffentliche Indizes anonym mit einem API-Schlüssel suchen und die Antwortgröße durch die Feldauswahl reduzieren können. Sie können den gleichen am Menschen orientierten Fluss von CX Coworker verwenden, um Content-KI-Indizes zu suchen und zu analysieren, ohne zu einer Benutzeroberfläche zu wechseln oder API-Code für die Suche auf niedriger Ebene zu schreiben.

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