Configuration du serveur MCP Experience Manager Guides

Point d’entrée du serveur MCP

Experience Manager Guides expose ses fonctionnalités MCP par le biais d’un point d’entrée HTTP unique.

Pour découvrir la liste d’outils actuelle pour votre environnement, demandez à votre assistant :

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

Demander l’accès pour votre organisation

L’accès au serveur MCP Experience Manager Guides est opt-in par organisation. Avant qu’un membre de votre organisation puisse se connecter :

• Experience Manager Guides doit être activé dans votre environnement AEM as a Cloud Service.
• L’ID d’organisation IMS de votre organisation (ID d’organisation) doit être placé sur la liste autorisée par l’équipe Adobe Guides.

Pour demander l’accès, contactez votre équipe du succès client Adobe.

Configuration

Vous n’installez rien localement. Vous pointez votre client vers l’URL du serveur et vous l’authentifiez par le biais du flux de connexion Adobe IMS.

Claude Anthropique

Suivez la présentation officielle : Configurer Claude pour AEM MCP. Lors de l’ajout du connecteur personnalisé, utilisez le point d’entrée Experience Manager Guides :

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

Curseur/Visual Studio Code

Ajoutez le serveur à votre configuration MCP. Pour Cursor, ajoutez-le à .cursor/mcp.json :

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

Pour les clients qui prennent uniquement en charge les serveurs locaux (stdio), faites le pont vers le point d’entrée distant avec mcp-remote :

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

Vous pouvez connecter les clients d’IA pris en charge à une instance locale de Experience Manager Guides à l’aide du protocole MCP (Model Context Protocol). Une fois la connexion établie, le client peut accéder aux opérations Experience Manager Guides disponibles pour votre compte utilisateur AEM.

Toutes les opérations sont effectuées à l’aide de votre identité AEM et vos autorisations. Le client connecté peut uniquement afficher ou modifier le contenu et les ressources auxquels votre compte AEM est autorisé à accéder.

L’authentification utilise le flux de code d’autorisation OAuth 2.0 avec PKCE (Proof Key for Code Exchange). Vous vous authentifiez avec AEM lorsque vous connectez un client pour la première fois. Une fois l’authentification réussie, la connexion actualise automatiquement les jetons d’accès.

Vous pouvez connecter les clients suivants :

Conditions préalables

Avant de connecter un client, contactez votre administrateur AEM pour vérifier la configuration suivante :

1. Vérifiez que la fonctionnalité MCP est déployée. : assurez-vous que la fonctionnalité MCP est déployée et en cours d’exécution sur votre instance Experience Manager Guides.

2. Configurez l’URL de base Granite. : dans le gestionnaire de configuration de la console web AEM (/system/console/configMgr), recherchez la configuration Wrapper de jeton PKCE OAuth Experience Manager Guides et vérifiez que l’URL de base Granite est configurée. Si l’URL de base Granite n’est pas configurée correctement, le client ne peut pas établir la connexion.

3. Configurez l’externaliseur de liens Day CQ. : dans le gestionnaire de configuration de la console web d’AEM, recherchez la configuration Externaliseur de liens Day CQ et vérifiez que l’URL de l’auteur externe pointe vers l’instance d’auteur AEM appropriée. L’URL de création externe est utilisée lors de la découverte OAuth. Une URL incorrecte peut empêcher le client d’établir la connexion.

   Pour plus d’informations, consultez Configuration des paramètres de connexion MCP pour AEM Guides On-Premise

4. Obtenir l’URL du serveur MCP. : l’URL du serveur MCP utilise le format suivant :

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

   note
   NOTE
   Utilisez le point d’entrée SSE complet lors de la configuration d’un client. N’ajoutez pas de barre oblique de fin à l’URL.

   Par exemple :

   Instance d’auteur AEM interne :

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

   Instance d’auteur AEM publique :

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

5. Vérifiez vos identifiants AEM et vos autorisations. : vous devez disposer d’un compte valide pour l’instance AEM. Utilisez les mêmes informations d’identification que celles que vous utilisez pour vous connecter à l’interface utilisateur d’AEM. Les opérations disponibles via MCP sont déterminées par les autorisations attribuées à ce compte.

Connecter Claude Desktop

Claude Desktop prend en charge les extensions Desktop (.mcpb). L’extension Experience Manager Guides MCP regroupe la configuration de connexion de sorte que vous n’ayez pas besoin de modifier manuellement une configuration JSON MCP.

1. Procurez-vous le fichier d’extension aem-guides-mcp.mcpb.

2. Ouvrez Claude Desktop et accédez à Paramètres > Extensions.

3. Installez aem-guides-mcp.mcpb en double-cliquant sur le fichier ou en le faisant glisser dans la fenêtre Extensions .

   Adobe Experience Manager Guides MCP s’affiche dans la boîte de dialogue Installation.

4. Sélectionnez Installer.

5. Dans le champ URL du serveur Experience Manager Guides MCP, saisissez le point d’entrée SSE complet de votre instance AEM.

   Par exemple :

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

6. Sélectionnez Enregistrer et assurez-vous que l’extension est activée.

Connexion à ChatGPT

Vous pouvez configurer le serveur Experience Manager Guides MCP en tant que connecteur personnalisé dans ChatGPT.

1. Vérifiez que votre serveur MCP est disponible à une URL HTTPS publique au format suivant :

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

   Ouvrez le point d’entrée dans un navigateur et vérifiez que vous pouvez atteindre l’hôte sans avertissement de certificat ni erreur de connexion.

2. Dans ChatGPT, ouvrez Paramètres > Plug-ins.

   note
   NOTE
   La disponibilité du connecteur dépend de votre plan ChatGPT et de la configuration de votre espace de travail. L’administrateur de votre espace de travail devra peut-être activer les connecteurs personnalisés ou les connecteurs développeur.

3. Sélectionnez l’option pour ajouter ou créer un module externe.

4. Spécifiez les détails du connecteur :

   • Nom : saisissez Experience Manager Guides ou un autre nom explicite.
   • URL du serveur MCP : saisissez le point d’entrée HTTPS SSE public.
   • Authentification : sélectionnez OAuth.

   Vous n’avez pas besoin de fournir d’ID client OAuth ou de secret client. Le serveur MCP prend en charge l’enregistrement client automatique.

5. Créez le connecteur.

Connecter le curseur

Configurez le serveur MCP Experience Manager Guides dans le curseur en ajoutant les détails du serveur à la configuration MCP.

1. Dans le curseur, accédez à Personnaliser > MCP > Nouveau.

   Le curseur ouvre le fichier de configuration ~/.cursor/mcp.json.

2. Ajoutez la configuration du serveur Experience Manager Guides MCP.

   Par exemple :

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

3. Remplacez l’exemple d’URL par le point d’entrée MCP SSE pour votre instance AEM.

4. Enregistrez la configuration.

5. Activez le serveur MCP configuré.