Configurare il server Experience Manager Guides MCP

Endpoint server MCP

Experience Manager Guides espone le sue funzionalità MCP tramite un singolo endpoint HTTP.

Per scoprire l’elenco di strumenti corrente per il tuo ambiente, chiedi all’assistente:

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

Richiedi l’accesso per la tua organizzazione

L’accesso al server Experience Manager Guides MCP è opt-in per organizzazione. Prima che chiunque nell’organizzazione possa connettersi:

• Experience Manager Guides deve essere abilitato nell’ambiente AEM as a Cloud Service.
• L’ID organizzazione IMS (ID organizzazione) della tua organizzazione deve essere inserito nell’elenco Consentiti dal team Adobe Guides.

Per richiedere l’accesso, contatta il team Customer Success di Adobe.

Configurazione

Non si installa nulla localmente. Puntare il client all’URL del server e autenticarsi tramite il flusso di accesso di Adobe IMS.

Claude antropico

Segui la procedura dettagliata ufficiale: Configura Claude per AEM MCP. Quando aggiungi il connettore personalizzato, utilizza l’endpoint Experience Manager Guides:

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

Cursore / Codice di Visual Studio

Aggiungi il server alla configurazione MCP. Per il cursore, aggiungerlo a .cursor/mcp.json:

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

Per i client che supportano solo server locali (stadio), eseguire il bridge all’endpoint remoto con mcp-remote:

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

Puoi collegare i client di intelligenza artificiale supportati a un’istanza Experience Manager Guides on-premise utilizzando il protocollo MCP (Model Context Protocol). Dopo aver stabilito la connessione, il client può accedere alle operazioni Experience Manager Guides disponibili per il tuo account utente AEM.

Tutte le operazioni vengono eseguite utilizzando l’identità e le autorizzazioni AEM. Il client connesso può visualizzare o modificare solo il contenuto e le risorse a cui il tuo account AEM è autorizzato ad accedere.

L’autenticazione utilizza il flusso del codice di autorizzazione OAuth 2.0 con Proof Key for Code Exchange (PKCE). Effettua l’autenticazione con AEM quando connetti un client per la prima volta. Dopo l’autenticazione, la connessione aggiorna automaticamente i token di accesso.

È possibile connettere i seguenti client:

Prerequisiti

Prima di connettere un client, rivolgiti al tuo amministratore AEM per verificare la seguente configurazione:

1. Verificare che la funzionalità MCP sia distribuita.: verificare che la funzionalità MCP sia distribuita e in esecuzione nell’istanza di Experience Manager Guides.

2. Configura l’URL di base Granite.: in Gestione configurazione console Web AEM (/system/console/configMgr), individuare la configurazione Wrapper token PKCE OAuth Experience Manager Guides e verificare che l’URL di base Granite sia configurato. Se l’URL di base di Granite non è configurato correttamente, il client non può stabilire la connessione.

3. Configura Day CQ Link Externalizer.: in AEM Web Console Configuration Manager, individua la configurazione Day CQ Link Externalizer e verifica che l’URL dell’autore esterno punti all’istanza di authoring AEM corretta. Durante l’individuazione OAuth viene utilizzato l’URL dell’autore esterno. Un URL errato può impedire al client di completare la connessione.

   Per ulteriori dettagli, visualizza Configurare le impostazioni di connessione MCP per AEM Guides On-Premise

4. Ottenere l’URL del server MCP.: l’URL del server MCP utilizza il seguente formato:

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

   note
   NOTE
   Utilizza l’endpoint SSE completo durante la configurazione di un client. Non aggiungere una barra finale all’URL.

   Ad esempio:

   Istanza di authoring interna di AEM:

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

   Istanza autore AEM pubblica:

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

5. Verifica le credenziali e le autorizzazioni di AEM.: è necessario disporre di un account valido per l’istanza di AEM. Utilizza le stesse credenziali utilizzate per accedere all’interfaccia utente di AEM. Le operazioni disponibili tramite MCP sono determinate dalle autorizzazioni assegnate a questo account.

Connetti Claude Desktop

Claude Desktop supporta le estensioni desktop (.mcpb). L’estensione MCP di Experience Manager Guides crea pacchetti per la configurazione della connessione in modo che non sia necessario modificare manualmente una configurazione JSON MCP.

1. Ottenere il file di estensione aem-guides-mcp.mcpb.

2. Apri Claude Desktop e passa a Impostazioni > Estensioni.

3. Installare aem-guides-mcp.mcpb facendo doppio clic sul file o trascinandolo nella finestra Estensioni.

   Adobe Experience Manager Guides MCP viene visualizzato nella finestra di dialogo di installazione.

4. Selezionare Installa.

5. Nel campo URL server MCP Experience Manager Guides, immetti l’endpoint SSE completo per l’istanza AEM.

   Ad esempio:

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

6. Seleziona Salva e assicurati che l’estensione sia abilitata.

Connetti ChatGPT

Puoi configurare il server Experience Manager Guides MCP come connettore personalizzato in ChatGPT.

1. Verifica che il server MCP sia disponibile a un URL HTTPS pubblico nel seguente formato:

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

   Apri l’endpoint in un browser e verifica di poter raggiungere l’host senza un avviso di certificato o un errore di connessione.

2. In ChatGPT, apri Impostazioni > Plugin.

   note
   NOTE
   La disponibilità del connettore dipende dal piano ChatGPT e dalla configurazione dell’area di lavoro. L’amministratore dell’area di lavoro potrebbe dover abilitare connettori personalizzati o per sviluppatori.

3. Seleziona l’opzione per aggiungere o creare un plug-in.

4. Specifica i dettagli del connettore:

   • Nome: Immettere Experience Manager Guides o un altro nome descrittivo.
   • URL server MCP: Immettere l’endpoint SSE HTTPS pubblico.
   • Autenticazione: Seleziona OAuth.

   Non è necessario fornire un ID client OAuth o un segreto client. Il server MCP supporta la registrazione client automatica.

5. Crea il connettore.

Connetti cursore

Configura il server MCP di Experience Manager Guides in Cursor aggiungendo i dettagli del server alla configurazione MCP.

1. In Cursore, passa a Personalizza > MCP > Nuovo.

   Il cursore apre il file di configurazione ~/.cursor/mcp.json.

2. Aggiungi la configurazione del server Experience Manager Guides MCP.

   Ad esempio:

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

3. Sostituisci l’URL di esempio con l’endpoint SSE MCP per l’istanza di AEM.

4. Salva la configurazione.

5. Abilita il server MCP configurato.