DocumentazioneAEMGuida utente

Utilizzo di MCP con AEM as a Cloud Service using-mcp-with-aem-as-a-cloud-service

Ultimo aggiornamento: 11 maggio 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • User
  • Admin
  • Developer

Introduzione introduction

Molti team di Adobe Experience Manager (AEM) ora lavorano in ambienti di sviluppo integrato (IDE) e applicazioni basate su chat come Cursor, OpenAI ChatGPT, Anthropic Claude e Microsoft Copilot Studio. Queste applicazioni supportano il protocollo MCP (Model Context Protocol), che consente alle applicazioni di esporre gli strumenti back-end a modelli LLM (Large Language Model) in modo standardizzato.

Con l’integrazione MCP di AEM, utenti tipo diversi possono collaborare intorno allo stesso contenuto:

  • Gli sviluppatori possono orchestrare le operazioni e i flussi di lavoro relativi ai contenuti dalla loro applicazione IDE o chat.
  • I professionisti e gli architetti di contenuti possono gestire siti e frammenti di contenuto e importare risorse con l’assistenza dell’intelligenza artificiale, pur mantenendo il modello di autorizzazione esistente di AEM.
IMPORTANT
Per gli scenari che modificano o eliminano il contenuto, i professionisti devono utilizzare l’interfaccia di AI Assistant anziché richiamare direttamente gli strumenti MCP. Gli agenti AEM gestiti dall’Assistente AI includono protezioni integrate.

Questo articolo spiega cosa fornisce la funzionalità MCP di AEM, quali applicazioni MCP sono supportate, come configurarla e come utilizzarla nella pratica.

Perché MCP è utile per i clienti AEM why-mcp-is-useful-for-aem-customers

Le moderne applicazioni IDE e chat utilizzano MCP come metodo per consentire a un LLM di richiamare gli strumenti esposti dietro i server MCP. I clienti possono descrivere il proprio intento nel linguaggio naturale anziché scrivere codice in base a specifiche API di basso livello. Ad esempio, un prompt come “aggiorna il banner principale per questa campagna in tutte le pagine” consente al LLM di richiamare gli strumenti MCP appropriati, che quindi interagiscono con le API di AEM.

I vantaggi principali includono:

  • Interazione con linguaggio naturale anziché API plumbing - Gli strumenti MCP descrivono le operazioni disponibili e come chiamarle. LLM utilizza questi schemi per decidere quali strumenti richiamare e con quali parametri.
  • Esperienza coerente nelle applicazioni - Gli stessi strumenti MCP di AEM possono essere utilizzati da più applicazioni compatibili con MCP, consentendo ai team di lavorare dove sono più produttivi e richiamando le stesse funzionalità AEM sottostanti.
  • Sicurezza e governance mantenute: le richieste agli strumenti AEM MCP vengono eseguite con l’identità dell’utente autenticato e ogni strumento applica le autorizzazioni AEM esistenti dell’utente. Le operazioni basate sull’intelligenza artificiale seguono le stesse regole di accesso del lavoro manuale in AEM.

Server AEM MCP aem-mcp-server

Con la versione di AEM di luglio 2026, Adobe offre un server MCP unificato di AEM consigliato al posto dei server MCP specifici del dominio. Configura un singolo URL nell’applicazione di chat o nell’agente di codifica per accedere a un set di strumenti in continua crescita, che copre la maggior parte delle offerte dei server MCP precedenti specifici del dominio.

Tieni presente che il server MCP di AEM al momento non include le funzionalità dei server MCP di Cloud Manager e Cloud Migration. Se ne hai bisogno, aggiungili separatamente nel client MCP.

L’endpoint è https://mcp.adobeaemcloud.com/adobe/mcp/aem

Categoria
Descrizione
Attivato per impostazione predefinita
Supporta la lettura/scrittura
Supporta sola lettura
Contenuto
Operazioni sui contenuti, tra cui creazione, lettura, aggiornamento ed eliminazione (CRUD) per pagine e frammenti di contenuto, importazione di risorse e ricerca di risorse (versione minima richiesta di AEM: 26309). Sono inoltre supportati il caricamento, il download, lo spostamento, la copia o l’eliminazione e la pubblicazione o l’annullamento della pubblicazione delle risorse, nonché la modifica dei metadati, l’analisi dei riferimenti e l’identificazione delle risorse non utilizzate.
Sì
Sì (impostazione predefinita)
Sì
Governance delle esperienze
Valuta i contenuti (testo, immagini, pagine) in base alle regole di governance del brand ed elenca configurazioni e controlli del brand.
Se sei interessato, devi iscriverti alla versione di prova di agenti o disporre di una licenza a pagamento per accedere a Experience Governance MCP.
Sì, ma vedi nota
–
Sì (impostazione predefinita)

Il server AEM MCP è utilizzato da AEM Claude Connector e AEM ChatGPT Plugin.

NOTE
È disponibile anche un server MCP per AEM Guides as a Cloud Service, per operazioni specifiche delle guide come la gestione di argomenti, mappe e linee di base. Per ulteriori informazioni, vedere Configurazione del server AEM Guides MCP.

Elenco delle funzionalità del server AEM MCP

Per visualizzare le funzionalità utilizzabili da LLM, chiedere all’applicazione abilitata per MCP di individuare le funzionalità del server AEM MCP con un messaggio di richiesta del tipo:

List AEM capabilities with the AEM MCP Server

Questo elenco di funzionalità di alto livello è diverso dall’elenco di strumenti non elaborati esposto dal server MCP di AEM.

Server MCP specifici del dominio mcp-servers-provided-by-aem

AEM espone anche server MCP specifici del dominio, ma si consiglia di utilizzare al loro posto AEM MCP Server. Tieni presente che, se necessario, poiché al momento non supporta Cloud Migration o i server MCP di Cloud Manager, puoi configurarli separatamente. Gli endpoint seguenti sono relativi a https://mcp.adobeaemcloud.com/adobe/mcp; ad esempio, configurare https://mcp.adobeaemcloud.com/adobe/mcp/content per il server Content MCP.

Server MCP mcp-servers

Server MCP
Endpoint
Descrizione
Attivato per impostazione predefinita
Contenuto
/content
Operazioni sui contenuti, tra cui creazione, lettura, aggiornamento ed eliminazione (CRUD) per pagine e frammenti di contenuto, importazione di risorse e ricerca di risorse (versione minima richiesta di AEM: 26309).
Sì
Contenuto (sola lettura)
/content-readonly
Operazioni per contenuti di sola lettura (recupero, elenco/ricerca) per pagine e frammenti di contenuto, più ricerca di risorse (la versione minima richiesta di AEM è 26309). Con AEM Claude Connector e il plug-in AEM ChatGPT, è inoltre disponibile il supporto per il download delle risorse, l’analisi dei riferimenti e l’identificazione delle risorse inutilizzate.
Sì
Cloud Manager
/cloudmanager
Gestisci le entità Cloud Manager, inclusi programmi, ambienti, archivi e pipeline, che possono anche essere attivati.
Sì
Governance delle esperienze
/experience-governance
Valuta i contenuti (testo, immagini, pagine) in base alle regole di governance del brand ed elenca configurazioni e controlli del brand.
Se sei interessato, devi iscriverti alla versione di prova di agenti o disporre di una licenza a pagamento per accedere a Experience Governance MCP.
Sì, ma vedi nota
Migrazione cloud
/cloud-migration
Recupera i risultati di Best Practices Analyzer (BPA) da Cloud Acceleration Manager (CAM) in base al modello di migrazione o al livello di gravità, consentendo agli agenti di intelligenza artificiale di promuovere la migrazione del codice da AEM 6.x ad AEM as a Cloud Service. Vedi Utilizzo di Cloud Migration MCP.
Sì

Per ulteriori informazioni sulle funzionalità e su come utilizzarle, fare riferimento all’esercitazione sul server MCP di contenuti e al video sul server MCP di Cloud Manager.

Applicazioni MCP supportate supported-mcp-applications

I server MCP sono progettati per funzionare con un set definito di applicazioni compatibili con MCP. Ogni applicazione fornisce la propria esperienza di configurazione, ma i passaggi di alto livello sono simili.

Applicazioni chat (Web e desktop) chat-applications

  • Claude antropico
  • OpenAI ChatGPT

Strumenti per sviluppatori (estensioni IDE, app desktop, CLI) developer-tools

  • Codice Claude antropico (CLI, JetBrains, codice VS, cursore)
  • Codice incremento (CLI, JetBrains, codice VS, cursore)
  • App desktop con rientro aggiuntivo
  • Cline (JetBrains, codice VS, cursore)
  • Cursore
  • Copilota GitHub (JetBrains, codice VS)
  • Kiro (app desktop, CLI)
  • Codice OpenAI (app desktop)
  • OpenAI Codex CLI
  • Windsurf

Piattaforme aziendali enterprise-platforms

  • Amazon Quick
  • Microsoft Copilot Studio

Panoramica dell’installazione setup-overview

La configurazione di MCP prevede due parti principali:

  1. Configura ogni applicazione client MCP in modo che l’applicazione sappia come connettersi ai server MCP di AEM ed eseguire l’accesso OAuth.
  2. Selezionare il server MCP prima di avviare la richiesta, in modo che il client MCP possa utilizzarlo.

Sono disponibili guide dettagliate relative a entrambi i passaggi per:

Configurazione AEM aem-configuration

Per impostazione predefinita, le autorizzazioni di cui dispongono i singoli utenti all’interno di AEM regolano l’accesso ai server MCP. Quando un utente si autentica tramite un’applicazione client MCP, gli strumenti MCP applicano le stesse regole di accesso delle operazioni manuali in AEM. Un utente può eseguire solo azioni che è già autorizzato a eseguire.

Applicazioni client MCP consentite permitted-mcp-client-applications

Tutte le applicazioni elencate in Applicazioni MCP supportate sono consentite per impostazione predefinita.

Limitazione dei server MCP restricting-mcp-servers

Per un controllo granulare sulle funzionalità MCP disponibili, invia un’e-mail al supporto Adobe all’indirizzo aemcs-mcp-feedback@adobe.com con la tua richiesta.

Puoi richiedere le seguenti restrizioni:

  • AEM MCP Server - disabilitarlo completamente, disabilitare categorie specifiche o modificare il comportamento predefinito di sola lettura e lettura per categoria (se supportato, in base alla tabella AEM MCP Server).
  • Server MCP specifici del dominio. Disabilitare un server specifico.

Per impostazione predefinita, le restrizioni si applicano a livello organizzativo. Se hai bisogno di restrizioni definite in modo più restrittivo, scegli uno dei seguenti livelli e fornisci i comportamenti desiderati per ogni istanza a quel livello:

  • ID programma - elenca i comportamenti desiderati separatamente per ogni programma.
  • ID ambiente - elenca i comportamenti desiderati separatamente per ogni ambiente.
  • Tipo di ambiente (RDE, dev, stage, prod): elenca i comportamenti desiderati separatamente per ciascun tipo di ambiente utilizzato.
NOTE
Il server MCP di AEM eredita tutte le restrizioni configurate sui server MCP specifici del dominio.

Gestione dell’accesso client MCP managing-mcp-client-access

Gli amministratori possono inoltre disabilitare l’accesso per specifiche applicazioni client MCP a livello di organizzazione, se richiesto dai criteri aziendali. Se desideri che Adobe abiliti il supporto per altri prodotti client MCP, invia un collegamento al sito web del prodotto. Se hai bisogno di inserire nell’elenco Consentiti un client MCP personalizzato, contatta anche tu.

Per tutte le richieste relative al server MCP, contatta Adobe all’indirizzo aemcs-mcp-feedback@adobe.com

Configurazione applicazione client MCP mcp-client-application-configuration

Ogni utente esegue questo passaggio oppure un amministratore dell’applicazione client MCP può eseguirlo laddove supportato. I dettagli di configurazione variano leggermente da un’applicazione all’altra. I client MCP si stanno evolvendo rapidamente e il supporto per i server MCP remoti è in fase di sviluppo attivo. Potrebbe essere necessario abilitare la modalità Sviluppatore per accedere alle funzionalità per l’aggiunta di server remoti, ma il processo generale è il seguente:

  1. Aggiungi uno o più URL del server MCP.
    • Configura uno o più endpoint MCP. Esempio:https://mcp.adobeaemcloud.com/adobe/mcp/aem
  2. Attiva la connessione.
    • Salva o attiva la configurazione in modo che l’applicazione client MCP tenti di connettersi al server MCP
  3. Accedi con Adobe ID.
    • Quando richiesto, completa il flusso di accesso di Adobe in modo che l’applicazione possa ottenere token OAuth associati al tuo Adobe ID
  4. Verificare gli strumenti individuati.
    • Una volta autenticata, l’applicazione rileva gli strumenti MCP dal server. È quindi possibile iniziare a richiedere al LLM di eseguire le operazioni di AEM.

Per l’elenco completo delle applicazioni supportate, vedere Applicazioni MCP supportate.

Autenticazione authentication

I server MCP ospitati da Adobe implementano OAuth e sono integrati con il sistema di identità di Adobe.

  • Quando un’applicazione client MCP si connette a un server MCP, gli utenti visualizzano una finestra di dialogo di accesso di Adobe e si autenticano con il proprio Adobe ID
  • Dopo aver effettuato correttamente l’accesso, il sistema verifica che l’applicazione client MCP sia consentita nell’organizzazione e che il server MCP richiesto sia consentito. Se uno dei due controlli non riesce, viene visualizzato un messaggio di errore.

Errore client MCP non consentito

  • Una volta verificata, il server MCP rilascia i token utilizzati dall’applicazione per le successive chiamate dello strumento.
  • Gli strumenti MCP rispettano le autorizzazioni AEM dell’utente. Ad esempio, solo gli utenti che dispongono dell’autorizzazione per modificare un frammento di contenuto in AEM possono modificarlo tramite MCP.

Questo approccio garantisce che le operazioni assistite da IA siano conformi al modello di sicurezza e governance di AEM esistente.

Utilizzo dei server MCP using-mcp-with-aem

Una volta configurata l’applicazione client MCP, è possibile richiedere al LLM di eseguire le operazioni di AEM. LLM conosce le funzionalità dei server MCP configurati, sceglie gli strumenti da chiamare e li sequenzia in base alle esigenze per soddisfare la richiesta.

IMPORTANT
I prompt contenenti più passaggi o destinati a diversi tipi di contenuto, ad esempio immagini e testo, funzionano al meglio con un modello pensante. Abilita un modello di pensiero o seleziona l’opzione Pensiero nel client MCP invece di fare affidamento sulla modalità Automatica.

Casi d’uso di esempio example-use-cases

Alcuni scenari rappresentativi includono:

  • Individuazione dell’ambiente

    • Elencare ambienti e licenze per decidere dove eseguire un flusso di lavoro.

  • Gestione dei siti

    • Elenca siti
    • Crea, leggi, aggiorna ed elimina pagine e contenuto della pagina.

  • Gestione dei frammenti di contenuto

    • Cercare frammenti di contenuto
    • Creare nuovi frammenti
    • Aggiorna i frammenti esistenti quando cambia la messaggistica della campagna.

  • Importazione risorse

    • Importa risorse con controllo stato

  • Ricerca risorse

    note
    NOTE
    La versione minima richiesta di AEM per accedere a Assets Search tramite l'endpoint MCP è 26309.

Esempio di flussi di lavoro example-workflows

Gli esempi seguenti illustrano il modo in cui un LLM potrebbe concatenare gli strumenti MCP.

  1. Utilizzo di un frammento di contenuto a cui fa riferimento una pagina

    • Ottieni contenuto pagina. Chiamare uno strumento come get-aem-page-content per recuperare la pagina e individuare la proprietà fragmentPath.
    • Risolvere il percorso del frammento. Utilizzare resolve_fragment_path per convertire il percorso in un UUID.
    • Recupera i dati del frammento. Chiamare get_fragment per recuperare i campi correnti.
    • Aggiorna il frammento. Chiamare patch_fragment per applicare le modifiche al contenuto del frammento.

  2. Creazione di nuovi contenuti basati su un modello

    • Rileva modelli. Utilizzare list_models per vedere quali modelli per frammenti di contenuto sono disponibili.
    • Ispeziona un modello. Utilizzare get_model per comprendere lo schema di campi del modello.
    • Crea contenuto. Utilizzare create_fragment per creare un nuovo frammento con valori derivati dalla richiesta.

  3. Aggiornamento sicuro del contenuto esistente

    • Leggi dati correnti - Utilizza get_fragment per recuperare i dati esistenti e un ETag.
    • Applica una patch JSON. Utilizzare patch_fragment con il documento ETag e una patch JSON per aggiornare il frammento, supportando la concorrenza ottimistica.

Dal punto di vista dell’utente, questi flussi di lavoro possono essere avviati con prompt quali:

"Create a new content fragment for the spring campaign based on our hero banner model and fill in its fields from this brief."

Il LLM sceglie e coordina automaticamente gli strumenti MCP necessari.

Gestione delle aspettative expectation-management

Quando si lavora con LLM tramite MCP, tenere presente quanto segue:

  • Funzionalità elevata ma non infallibile - I moduli LLM possono eseguire attività complesse ma sono soggetti a errori occasionali. Lo stesso prompt può produrre risultati o presentazioni leggermente diversi senza un motivo evidente. Esamina sempre gli output prima di applicare modifiche al contenuto di produzione.
  • Funzionalità in evoluzione - I modelli LLM sono in continuo miglioramento. Nel tempo, diventano più intelligenti nel scoprire nuovi modi per combinare gli strumenti MCP per raggiungere i tuoi obiettivi. Un’attività che richiedeva l’invio di più richieste oggi può funzionare senza problemi con un singolo prompt domani.
  • La supervisione umana è essenziale. Considerare LLM come un assistente competente che necessita di supervisione. Possiede un’ampia conoscenza e può ideare soluzioni creative, ma trae vantaggio dalla tua guida e revisione. Verifica i risultati, in particolare per le operazioni critiche, e fornisci un feedback quando l’output non corrisponde alle tue aspettative.
  • Prestare attenzione alle esecuzioni dello strumento di riconoscimento automatico - Alcune applicazioni client MCP, come Claude, offrono la possibilità di riconoscere automaticamente le esecuzioni dello strumento richieste da LLM. Anche se questa opzione può essere utile per operazioni di sola lettura, come la ricerca o il recupero del contenuto, occorre prestare attenzione con gli strumenti che aggiornano o eliminano il contenuto. Rivedi ogni richiesta di esecuzione dello strumento prima di confermare le azioni che modificano il tuo ambiente AEM.

Limitazioni limitations

AEM attualmente supporta la configurazione dei server MCP nelle applicazioni elencate in Applicazioni MCP supportate.

Se desideri utilizzare un’applicazione client MCP diversa, contatta il numero aemcs-mcp-feedback@adobe.com per richiedere supporto per client aggiuntivi o per inserire nell’elenco Consentiti uno personalizzato.

recommendation-more-help
experience-manager-cloud-service-help-main-toc