Einrichten des Experience Manager Guides MCP-Servers

MCP-Server-Endpunkt

Experience Manager Guides stellt seine MCP-Funktionen über einen einzigen HTTP-Endpunkt bereit.

Um die aktuelle Toolliste für Ihre Umgebung zu erhalten, fragen Sie Ihren Assistenten:

List all Experience Manager Guides tools available from the author https://author-pXXXX-eXXXX.adobeaemcloud.com and describe what they do.

Anfordern des Zugriffs für Ihre Organisation

Der Zugriff auf den Experience Manager Guides MCP-Server erfolgt Opt-in pro Organisation. Bevor sich jemand in Ihrer Organisation verbinden kann:

• Experience Manager Guides muss in Ihrer AEM as a Cloud Service-Umgebung aktiviert sein.
• Die IMS-Organisations-ID (Organisations-ID) Ihres Unternehmens muss vom Team Adobe Guides auf die Zulassungsliste gesetzt werden.

Um Zugriff zu erhalten, wenden Sie sich an Ihr Adobe Customer Success-Team.

Einrichtung

Sie installieren keine lokalen Komponenten. Sie verweisen Ihren Client auf die Server-URL und authentifizieren sich über den Adobe IMS-Anmeldefluss.

Claude Anthropica

Folgen Sie der offiziellen Anleitung: Einrichten von Claude für AEM MCP. Verwenden Sie beim Hinzufügen des benutzerdefinierten Connectors den Experience Manager Guides-Endpunkt:

https://mcp.adobeaemcloud.com/adobe/mcp/guides

Cursor/Visual Studio Code

Fügen Sie den Server zu Ihrer MCP-Konfiguration hinzu. Fügen Sie für den Cursor Folgendes zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "aem-guides": {
      "url": "https://mcp.adobeaemcloud.com/adobe/mcp/guides"
    }
  }
}

Für Clients, die nur lokale (stdio) Server unterstützen, verbinden Sie den Remote-Endpunkt mit mcp-remote:

{
  "mcpServers": {
    "aem-guides": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.adobeaemcloud.com/adobe/mcp/guides"]
    }
  }
}

Sie können unterstützte KI-Clients mithilfe des Model Context Protocol (MCP) mit einer lokalen Experience Manager Guides-Instanz verbinden. Nachdem Sie die Verbindung hergestellt haben, kann der Client auf die Experience Manager Guides-Vorgänge zugreifen, die für Ihr AEM-Benutzerkonto verfügbar sind.

Alle Vorgänge werden mit "AEM-Identität und -Berechtigungen ausgeführt. Der verbundene Client kann nur die Inhalte und Ressourcen anzeigen oder ändern, auf die Ihr AEM-Konto zugreifen darf.

Bei der Authentifizierung wird der OAuth 2.0-Autorisierungs-Code-Fluss mit dem Proof Key for Code Exchange (PKCE) verwendet. Sie authentifizieren sich bei AEM, wenn Sie zum ersten Mal eine Verbindung zu einem Client herstellen. Nach erfolgreicher Authentifizierung aktualisiert die Verbindung automatisch Zugriffstoken.

Sie können die folgenden Clients verbinden:

Voraussetzungen

Wenden Sie sich an Ihren AEM-Administrator, um die folgende Konfiguration zu überprüfen, bevor Sie einen Client verbinden:

1. Stellen Sie sicher, dass die MCP-Funktion bereitgestellt ist.: Stellen Sie sicher, dass die MCP-Funktion auf Ihrer Experience Manager Guides-Instanz bereitgestellt und ausgeführt wird.

2. Konfigurieren der Granite-Basis-URL.: Suchen Sie im Konfigurations-Manager der AEM-Web-Konsole (/system/console/configMgr) die Konfiguration Experience Manager Guides OAuth PKCE Token Wrapper und überprüfen Sie, ob die Granite-Basis-URL konfiguriert ist. Wenn die Granite-Basis-URL nicht korrekt konfiguriert ist, kann der Client die Verbindung nicht herstellen.

3. Konfigurieren Sie den Day CQ Link Externalizer.: Suchen Sie im Konfigurations-Manager der AEM-Web-Konsole die Konfiguration Day CQ Link Externalizer und stellen Sie sicher, dass die externe Autoren-URL auf die richtige AEM-Autoreninstanz verweist. Die externe Autoren-URL wird während der OAuth-Erkennung verwendet. Eine falsche URL kann verhindern, dass der Client die Verbindung herstellt.

   Weitere Informationen finden Sie unter Konfigurieren der MCP-Verbindungseinstellungen für AEM Guides On-Premise

4. Abrufen der MCP-Server-URL.: Die MCP-Server-URL verwendet das folgende Format:

   code language-none
   http(s)://<AEM-HOST>/bin/guides/v1/mcp/sse

   note
   NOTE
   Verwenden Sie den vollständigen SSE-Endpunkt beim Konfigurieren eines Clients. Fügen Sie der URL keinen Schrägstrich hinzu.

   Beispiel:

   Interne AEM-Autoreninstanz:

   code language-none
   http://10.42.42.20:4502/bin/guides/v1/mcp/sse

   Öffentliche AEM-Autoreninstanz:

   code language-none
   https://author.example.com/bin/guides/v1/mcp/sse

5. Überprüfen Sie Ihre AEM-Anmeldeinformationen und -Berechtigungen.: Sie müssen über ein gültiges Konto für die AEM-Instanz verfügen. Verwenden Sie dieselben Anmeldeinformationen wie für die Anmeldung bei der Benutzeroberfläche von AEM. Die über MCP verfügbaren Vorgänge werden durch die diesem Konto zugewiesenen Berechtigungen bestimmt.

Claude Desktop verbinden

Claude Desktop unterstützt Desktop-Erweiterungen (.mcpb). Die Experience Manager Guides MCP-Erweiterung packt die Verbindungskonfiguration, sodass Sie eine MCP-JSON-Konfiguration nicht manuell bearbeiten müssen.

1. Rufen Sie die aem-guides-mcp.mcpb Erweiterungsdatei ab.

2. Öffnen Sie Claude Desktop und navigieren Sie zu Einstellungen > Erweiterungen.

3. Installieren Sie aem-guides-mcp.mcpb, indem Sie auf die Datei doppelklicken oder sie in das Fenster „Erweiterungen“ ziehen.

   Adobe Experience Manager Guides MCP wird im Installationsdialogfeld angezeigt.

4. Wählen Sie Installieren aus.

5. Geben Sie im Feld Experience Manager Guides MCP Server URL den vollständigen SSE-Endpunkt für Ihre AEM-Instanz ein.

   Beispiel:

   code language-none
   http://<AEM-HOST>:4502/bin/guides/v1/mcp/sse

6. Wählen Speichern und stellen Sie sicher, dass die Erweiterung aktiviert ist.

ChatGPT verbinden

Sie können den Experience Manager Guides MCP-Server als benutzerdefinierten Connector in ChatGPT konfigurieren.

1. Stellen Sie sicher, dass Ihr MCP-Server unter einer öffentlichen HTTPS-URL im folgenden Format verfügbar ist:

   code language-none
   https://<PUBLIC-AEM-HOST>/bin/guides/v1/mcp/sse

   Öffnen Sie den Endpunkt in einem Browser und stellen Sie sicher, dass Sie den Host ohne Zertifikatwarnung oder Verbindungsfehler erreichen können.

2. Öffnen Sie in ChatGPT Einstellungen > Plug-ins.

   note
   NOTE
   Die Verfügbarkeit des Connectors hängt von Ihrem ChatGPT-Plan und der Arbeitsbereichskonfiguration ab. Möglicherweise muss die bzw. der Workspace-Admin benutzerdefinierte oder Entwickler-Connectoren aktivieren.

3. Wählen Sie die Option zum Hinzufügen oder Erstellen eines Plug-ins aus.

4. Angeben der Connector-Details:

   • Name: Geben Sie Experience Manager Guides oder einen anderen beschreibenden Namen ein.
   • MCP-Server-URL: Geben Sie den öffentlichen HTTPS-SSE-Endpunkt ein.
   • Authentifizierung: Wählen Sie OAuth aus.

   Sie müssen keine OAuth-Client-ID oder keinen geheimen Client-Schlüssel angeben. Der MCP-Server unterstützt die automatische Clientregistrierung.

5. Erstellen Sie den Connector.

Cursor verbinden

Konfigurieren Sie den Experience Manager Guides-MCP-Server in Cursor, indem Sie die Serverdetails zur MCP-Konfiguration hinzufügen.

1. Navigieren Sie in Cursor zu Anpassen > MCPs > Neu.

   Der Cursor öffnet die ~/.cursor/mcp.json Konfigurationsdatei.

2. Fügen Sie die Experience Manager Guides MCP-Server-Konfiguration hinzu.

   Beispiel:

   code language-json
   { "mcpServers": { "aem-guides": { "url": "http://10.42.34.176:4502/bin/guides/v1/mcp/sse", "type": "http" } } }

3. Ersetzen Sie die Beispiel-URL durch den MCP SSE-Endpunkt für Ihre AEM-Instanz.

4. Speichern Sie die Konfiguration.

5. Aktivieren Sie den konfigurierten MCP-Server.