Configurar o servidor MCP do Experience Manager Guides

Ponto de acesso do servidor MCP

O Experience Manager Guides expõe seus recursos de MCP por meio de um único endpoint HTTP.

Para descobrir a lista de ferramentas atual para seu ambiente, pergunte ao assistente:

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

Solicitar acesso para sua organização

O acesso ao servidor MCP do Experience Manager Guides é de aceitação por organização. Antes que qualquer pessoa em sua organização possa se conectar:

• O Experience Manager Guides deve ser ativado no ambiente AEM as a Cloud Service.
• A IMS Organization ID (ID da organização) de sua organização deve estar na lista de permissões da equipe do Adobe Guides.

Para solicitar acesso, entre em contato com a equipe de Sucesso do cliente da Adobe.

Configurar

Você não instala nada localmente. Você aponta seu cliente para o URL do servidor e autentica por meio do fluxo de entrada do Adobe IMS.

Claude Antrópico

Siga a apresentação oficial: Configurar Claude para o AEM MCP. Ao adicionar o conector personalizado, use o endpoint do Experience Manager Guides:

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

Cursor/Código do Visual Studio

Adicione o servidor à configuração MCP. Para Cursor, adicione-o a .cursor/mcp.json:

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

Para clientes que oferecem suporte apenas a servidores locais (stdio), conecte-se ao ponto de extremidade remoto com mcp-remote:

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

Você pode conectar clientes de IA compatíveis a uma instância local do Experience Manager Guides usando o Protocolo de Contexto de Modelo (MCP). Após estabelecer a conexão, o cliente poderá acessar as operações do Experience Manager Guides disponíveis para sua conta de usuário do AEM.

Todas as operações são executadas usando sua identidade e permissões do AEM. O cliente conectado pode visualizar ou modificar somente o conteúdo e os recursos que sua conta do AEM está autorizada a acessar.

A autenticação usa o fluxo de código de autorização OAuth 2.0 com a chave de prova para troca de código (PKCE). Você se autentica com o AEM quando se conecta a um cliente pela primeira vez. Após a autenticação bem-sucedida, a conexão atualiza os tokens de acesso automaticamente.

Você pode conectar os seguintes clientes:

Pré-requisitos

Antes de conectar um cliente, entre em contato com o administrador do AEM para verificar a seguinte configuração:

1. Verifique se o recurso MCP está implantado.: certifique-se de que o recurso MCP esteja implantado e em execução em sua instância do Experience Manager Guides.

2. Configurar a URL de base do Granite.: no Gerenciador de configuração do console da Web do AEM (/system/console/configMgr), localize a configuração do Experience Manager Guides OAuth PKCE Token Wrapper e verifique se a URL de base do Granite está configurada. Se o URL de base do Granite não estiver configurado corretamente, o cliente não poderá estabelecer a conexão.

3. Configure o Day CQ Link Externalizer.: no Gerenciador de Configuração do Console da Web do AEM, localize a configuração do Day CQ Link Externalizer e verifique se a URL do autor externo aponta para a instância correta do autor do AEM. O URL do autor externo é usado durante a descoberta do OAuth. Um URL incorreto pode impedir que o cliente conclua a conexão.

   Para obter mais detalhes, consulte Definir configurações de conexão MCP para o AEM Guides no Local

4. Obter a URL do servidor MCP.: a URL do servidor MCP usa o seguinte formato:

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

   note
   NOTE
   Use o endpoint SSE completo ao configurar um cliente. Não adicione uma barra à direita ao URL.

   Por exemplo:

   Instância interna do autor do AEM:

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

   Instância de autor de AEM público:

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

5. Verifique suas credenciais e permissões do AEM.: você deve ter uma conta válida para a instância do AEM. Use as mesmas credenciais usadas para fazer logon na interface do usuário do AEM. As operações disponíveis por meio do MCP são determinadas pelas permissões atribuídas a essa conta.

Conectar o Claude Desktop

O Claude Desktop oferece suporte às Extensões de Desktop (.mcpb). A extensão MCP do Experience Manager Guides empacota a configuração da conexão para que você não precise editar manualmente uma configuração JSON de MCP.

1. Obtenha o arquivo de extensão aem-guides-mcp.mcpb.

2. Abra o Claude Desktop e navegue até Configurações > Extensões.

3. Instale o aem-guides-mcp.mcpb clicando duas vezes no arquivo ou arrastando-o para a janela Extensões.

   O Adobe Experience Manager Guides MCP é exibido na caixa de diálogo Instalação.

4. Selecione Instalar.

5. No campo URL do Servidor MCP do Experience Manager Guides, digite o ponto de extremidade SSE completo para sua instância do AEM.

   Por exemplo:

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

6. Selecione Salvar e verifique se a extensão está habilitada.

Conectar o ChatGPT

Você pode configurar o servidor MCP do Experience Manager Guides como um conector personalizado no ChatGPT.

1. Verifique se o servidor MCP está disponível em um URL HTTPS público no seguinte formato:

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

   Abra o endpoint em um navegador e verifique se você pode acessar o host sem um aviso de certificado ou erro de conexão.

2. No ChatGPT, abra Configurações > Plug-ins.

   note
   NOTE
   A disponibilidade do conector depende do plano do ChatGPT e da configuração do espaço de trabalho. Talvez o administrador do espaço de trabalho precise habilitar conectores personalizados ou de desenvolvedor.

3. Selecione a opção para adicionar ou criar um plugin.

4. Especifique os detalhes do conector:

   • Nome: Insira Experience Manager Guides ou outro nome descritivo.
   • URL do Servidor MCP: Insira o ponto de extremidade HTTPS SSE público.
   • Autenticação: Selecione OAuth.

   Não é necessário fornecer uma ID de cliente OAuth ou um segredo de cliente. O servidor MCP suporta registro automático de cliente.

5. Crie o conector.

Conectar cursor

Configure o servidor Experience Manager Guides MCP no Cursor, adicionando os detalhes do servidor à configuração do MCP.

1. No Cursor, navegue até Personalizar > MCPs > Novo.

   O cursor abre o arquivo de configuração ~/.cursor/mcp.json.

2. Adicione a configuração do servidor Experience Manager Guides MCP.

   Por exemplo:

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

3. Substitua o URL de exemplo pelo endpoint MCP SSE da sua instância do AEM.

4. Salve a configuração.

5. Ative o servidor MCP configurado.