[Beta]{class="badge informative"}

Utilizzo dei client MCP (Beta) rtcdp-mcp

È possibile utilizzare l’integrazione MCP di Adobe Real-Time CDP per eseguire query su tipi di pubblico, destinazioni e stato di attivazione utilizzando prompt in linguaggio semplice, senza scrivere chiamate API o navigare tra le schermate dei prodotti. Questa integrazione è utile sia per i clienti Adobe Real-Time CDP che per i clienti Adobe Real-Time CDP B2B edition e offre un modo conversazionale per ispezionare i dati e i flussi di lavoro Real-Time CDP supportati da client compatibili con MCP. Leggi questa guida per scoprire come funziona l’integrazione, cosa puoi farci e come iniziare.

Beta, sicurezza e note legali mcp-notices

Avviso di documentazione di Beta: questa documentazione riguarda una funzionalità di Beta e non costituisce documentazione finale. Il contenuto qui descritto si riferisce a una versione di Beta ed è soggetto a modifiche prima della disponibilità generale. Adobe non fornisce alcuna dichiarazione sulla completezza o sull’accuratezza di questa documentazione.

Utilizzando il server Adobe Real-Time CDP MCP (Beta) (“Beta”), l’utente riconosce che il Beta è fornito “così com’è” senza alcuna garanzia. Adobe non ha alcun obbligo di mantenere, correggere, aggiornare, modificare, modificare o supportare in altro modo Beta. Si consiglia di usare cautela e di non fare affidamento in alcun modo sul corretto funzionamento o sulle prestazioni di tale Beta e/o dei materiali di accompagnamento. Beta è considerata un’informazione riservata di Adobe. Qualsiasi “Feedback” (informazioni relative a Beta, compresi, a titolo esemplificativo e non esaustivo, problemi o difetti riscontrati durante l’utilizzo di Beta, suggerimenti, miglioramenti e raccomandazioni) fornito dall’Utente a Adobe viene assegnato ad Adobe, inclusi tutti i diritti, i titoli e gli interessi relativi a tale Feedback.

Qual è il protocollo di contesto del modello? mcp-overview

I team di marketing, dati e customer-experience si affidano sempre di più ad applicazioni basate su chat e a strumenti per sviluppatori, come Anthropic Claude, OpenAI ChatGPT, Cursor e Microsoft Copilot Studio, per semplificare il loro lavoro quotidiano. Queste applicazioni supportano Model Context Protocol (MCP), uno standard aperto che consente alle applicazioni di esporre gli strumenti back-end a modelli LLM (Large Language Model) in modo uniforme.

Real-Time CDP ora fornisce un server MCP che mette in evidenza le operazioni di pubblico, destinazione e attivazione direttamente all’interno di qualsiasi applicazione compatibile con MCP. Con l’integrazione MCP di Real-Time CDP, utenti tipo diversi possono collaborare intorno agli stessi dati di segmentazione e attivazione, senza scrivere query sulle API REST di Adobe Experience Platform o navigare su più schermate dell’interfaccia utente. I clienti possono descrivere il proprio intento conversazionalmente e consentire al LLM di richiamare gli strumenti MCP appropriati.

Funzionalità principali mcp-capabilities

Il server MCP di Real-Time CDP è una superficie di monitoraggio e valutazione di sola lettura. Espone le API di recupero per tipi di pubblico, destinazioni, origini, identità e risoluzione dei profili come risposte in linguaggio semplice all’interno dell’assistente AI, senza scrivere query o navigare tra le schermate dei prodotti. Non è possibile creare, modificare o eliminare dati tramite il server MCP.

Il rilascio di Beta include i seguenti 18 strumenti:

Casi d’uso mcp-use-cases

Il server MCP di Real-Time CDP è progettato per il monitoraggio e la valutazione 1}. Poiché il server funziona con gli ID piuttosto che con i nomi, un flusso di lavoro tipico inizia con un elenco: chiedi a Claude di mostrarti cosa è disponibile, scegli l’elemento desiderato, quindi fai domande di follow-up utilizzando l’ID che restituisce.

Accesso e abilitazione mcp-access

Per richiedere l’accesso:

Prerequisiti mcp-prerequisites

Prima di collegare il server Real-Time CDP MCP al client MCP, verificare quanto segue:

Collegare il server Real-Time CDP MCP mcp-connect

L’endpoint del server MCP di Real-Time CDP è:

https://rtcdp-mcp.adobe.io/mcp

Il server utilizza un trasporto HTTP remoto (Streamable HTTP) con un flusso di accesso Adobe basato su browser. In ogni client, il modello di configurazione è lo stesso:

Configurazione JSON generale mcp-connect-json

Per i client che accettano una configurazione del server MCP basata su JSON, ad esempio Claude Desktop (claude_desktop_config.json), VS Code o qualsiasi client che legge un file mcp.json, utilizzare uno dei seguenti formati a seconda che il client supporti HTTP remoto nativo o richieda un bridge locale:

Tramite bridge mcp-remote (Claude Desktop e altri client che richiedono un bridge locale)

{
  "mcpServers": {
    "rtcdp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://rtcdp-mcp.adobe.io/mcp"
      ]
    }
  }
}

HTTP remoto nativo (client che lo supportano direttamente)

{
  "mcpServers": {
    "rtcdp": {
      "url": "https://rtcdp-mcp.adobe.io/mcp",
      "transport": "http"
    }
  }
}

Eseguire l’installazione in client basati sull’interfaccia utente mcp-connect-ui

Claude

Per claude.ai e Claude Desktop, aggiungere il server Real-Time CDP MCP come connettore personalizzato utilizzando l’URL del server https://rtcdp-mcp.adobe.io/mcp.

Dopo aver aggiunto il connettore, attivalo in una conversazione e completa l’accesso al browser Adobe al primo utilizzo. Claude individua automaticamente il server di autorizzazione di Adobe. Non è richiesto alcun ID client o segreto client.

ChatGPT

In ChatGPT, aggiungi il server Real-Time CDP MCP come connettore personalizzato:

Cursore

In Cursore, aggiungi il server MCP di Real-Time CDP come server MCP remoto:

Una volta connessi, gli strumenti Real-Time CDP sono disponibili nelle modalità Compositore cursore e Agente.

Altri client basati su interfaccia utente

Per client quali VS Code o altre applicazioni desktop e Web con supporto MCP remoto, aggiungere il server MCP Real-Time CDP come server HTTP remoto utilizzando https://rtcdp-mcp.adobe.io/mcp. Se il client supporta intestazioni o token Bearer opzionali, lasciali vuoti: al primo utilizzo l’autenticazione viene gestita tramite il flusso di accesso di Adobe basato su browser.

Installazione in client tecnici mcp-connect-technical

Claude Code

Aggiungere il server dal terminale:

claude mcp add --transport http rtcdp https://rtcdp-mcp.adobe.io/mcp

Quindi avvia Claude Code ed esegui:

/mcp

Seleziona il server rtcdp e completa il flusso di accesso di Adobe nel browser. Se il server è già stato aggiunto in claude.ai, potrebbe essere visualizzato automaticamente in Claude Code quando entrambi sono connessi allo stesso account.

Codice

Aggiungere il server dal terminale:

codex mcp add rtcdp --url https://rtcdp-mcp.adobe.io/mcp

Autentica il server:

codex mcp login rtcdp

Verifica la configurazione:

codex mcp list

È inoltre possibile aggiungere il server direttamente a ~/.codex/config.toml:

[mcp_servers.rtcdp]
url = "https://rtcdp-mcp.adobe.io/mcp"

Parametri di richiesta richiesti mcp-connect-params

Ogni chiamata allo strumento richiede due parametri che definiscono l’ambito della richiesta al tenant Adobe Experience Platform:

Forniscili all’inizio di ogni sessione. Ad esempio:

“Usa organizzazione 1234ABCD@AdobeOrg e sandbox prod per questa sessione.”

Se non conosci il tuo ID organizzazione, chiedi all’assistente AI di chiamare search_organizations, in modo che restituisca tutte le organizzazioni a cui le tue credenziali Adobe possono accedere.

Limitazioni note (Beta) mcp-limitations

Le seguenti limitazioni si applicano alla versione corrente di Beta del server MCP Adobe Real-Time CDP:

Domande frequenti mcp-faq