Configuración del servidor MCP de Experience Manager Guides

Extremo del servidor MCP

Experience Manager Guides expone sus capacidades de MCP a través de un único extremo HTTP.

Para descubrir la lista de herramientas actual para su entorno, pregunte a su asistente:

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

Solicite acceso para su organización

El acceso al servidor MCP de Experience Manager Guides es de inclusión por organización. Antes de que cualquier persona de su organización pueda conectarse:

• Experience Manager Guides debe estar habilitado en el entorno de AEM as a Cloud Service.
• El equipo de guías de Adobe debe permitir el ID de organización de IMS de su organización (ID de organización).

Para solicitar acceso, póngase en contacto con el equipo de éxito del cliente de Adobe.

Configuración

No instale nada localmente. El cliente se dirige a la dirección URL del servidor y se autentica mediante el flujo de inicio de sesión de IMS de Adobe.

Claude antrópico

Siga el tutorial oficial: Configurar Claude para AEM MCP. Al añadir el conector personalizado, utilice el punto final de Experience Manager Guides:

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

Cursor / código de Visual Studio

Añada el servidor a la configuración de MCP. Para el cursor, agréguelo a .cursor/mcp.json:

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

Para los clientes que solo admiten servidores locales (stdio), vincule al extremo remoto con mcp-remote:

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

Puede conectar clientes de IA admitidos a una instancia local de Experience Manager Guides mediante el protocolo de contexto de modelo (MCP). Una vez establecida la conexión, el cliente puede acceder a las operaciones de Experience Manager Guides disponibles en su cuenta de usuario de AEM.

Todas las operaciones se realizan con su identidad y permisos de AEM. El cliente conectado solo puede ver o modificar el contenido y los recursos a los que su cuenta de AEM tiene autorización para acceder.

La autenticación utiliza el flujo del código de autorización de OAuth 2.0 con clave de prueba para intercambio de código (PKCE). La autenticación con AEM se realiza al conectar un cliente por primera vez. Después de la autenticación correcta, la conexión actualiza los tokens de acceso automáticamente.

Puede conectar los siguientes clientes:

Requisitos previos

Antes de conectar un cliente, trabaje con su administrador de AEM para comprobar la siguiente configuración:

1. Compruebe que la característica MCP esté implementada.: Asegúrese de que la característica MCP esté implementada y se esté ejecutando en la instancia de Experience Manager Guides.

2. Configure la URL de base de Granite.: En el Administrador de configuración de la consola web de AEM (/system/console/configMgr), busque la configuración Envolvente de token OAuth PKCE de Experience Manager Guides y compruebe que la URL de base de Granite esté configurada. Si la dirección URL base de Granite no está configurada correctamente, el cliente no puede establecer la conexión.

3. Configure el Day CQ Link Externalizer.: En el Administrador de configuración de la consola web de AEM, busque la configuración de Day CQ Link Externalizer y compruebe que la dirección URL del autor externo apunte a la instancia de autor de AEM correcta. La dirección URL del autor externo se utiliza durante la detección de OAuth. Una dirección URL incorrecta puede impedir que el cliente complete la conexión.

   Para obtener más información, vea Configurar las opciones de conexión de MCP para AEM Guides local

4. Obtener la URL del servidor MCP.: La URL del servidor MCP utiliza el siguiente formato:

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

   note
   NOTE
   Utilice el punto de conexión SSE completo al configurar un cliente. No agregue una barra diagonal a la dirección URL.

   Por ejemplo:

   Instancia de autor interna de AEM:

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

   Instancia de autor de AEM pública:

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

5. Compruebe sus credenciales y permisos de AEM.: Debe tener una cuenta válida para la instancia de AEM. Utilice las mismas credenciales que utiliza para iniciar sesión en la interfaz de usuario de AEM. Las operaciones disponibles a través de MCP están determinadas por los permisos asignados a esta cuenta.

Conectar Claude Desktop

Claude Desktop admite extensiones de escritorio (.mcpb). La extensión MCP de Experience Manager Guides empaqueta la configuración de conexión para que no necesite editar manualmente una configuración JSON de MCP.

1. Obtener el archivo de extensión aem-guides-mcp.mcpb.

2. Abra Claude Desktop y vaya a Configuración > Extensiones.

3. Instale aem-guides-mcp.mcpb haciendo doble clic en el archivo o arrastrándolo a la ventana Extensiones.

   Adobe Experience Manager Guides MCP se muestra en el cuadro de diálogo Instalación.

4. Seleccione Instalar.

5. En el campo URL del servidor MCP de Experience Manager Guides, introduzca el punto final SSE completo para la instancia de AEM.

   Por ejemplo:

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

6. Seleccione Guardar y asegúrese de que la extensión esté habilitada.

Conectar ChatGPT

Puede configurar el servidor MCP de Experience Manager Guides como un conector personalizado en ChatGPT.

1. Compruebe que el servidor MCP esté disponible en una URL HTTPS pública con el siguiente formato:

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

   Abra el extremo en un explorador y compruebe que puede llegar al host sin una advertencia de certificado o un error de conexión.

2. En ChatGPT, abra Configuración > Complementos.

   note
   NOTE
   La disponibilidad del conector depende de su plan de ChatGPT y de la configuración del espacio de trabajo. Es posible que el administrador del espacio de trabajo tenga que habilitar conectores personalizados o de desarrollador.

3. Seleccione la opción para añadir o crear un complemento.

4. Especifique los detalles del conector:

   • Nombre: Escriba Experience Manager Guides u otro nombre descriptivo.
   • URL del servidor MCP: Escriba el extremo público HTTPS SSE.
   • Autenticación: Seleccione OAuth.

   No es necesario que proporcione un ID de cliente o un secreto de cliente de OAuth. El servidor MCP admite el registro automático de clientes.

5. Cree el conector.

Cursor de conexión

Configure el servidor MCP de Experience Manager Guides en Cursor añadiendo los detalles del servidor a la configuración de MCP.

1. En el cursor, vaya a Personalizar > MCP > Nuevo.

   El cursor abre el archivo de configuración ~/.cursor/mcp.json.

2. Añada la configuración del servidor MCP de Experience Manager Guides.

   Por ejemplo:

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

3. Reemplace la URL de ejemplo con el punto final MCP SSE para la instancia de AEM.

4. Guarde la configuración.

5. Habilite el servidor MCP configurado.