[Beta]{class="badge informative"}
Utiliser des clients MCP (Beta) rtcdp-mcp
Vous pouvez utiliser l’intégration Adobe Real-Time CDP MCP pour interroger les audiences, les destinations et l’intégrité de l’activation à l’aide d’invites en langage clair, sans écrire d’appels API ni parcourir les écrans du produit. Cette intégration est destinée aux clients Adobe Real-Time CDP et Adobe Real-Time CDP B2B edition et permet d’examiner, par la conversation, les données et les workflows Real-Time CDP pris en charge à partir de clients compatibles avec MCP. Lisez ce guide pour découvrir comment fonctionne l’intégration, ce que vous pouvez en faire et comment commencer.
Beta, sécurité et mentions légales mcp-notices
Remarque sur la documentation de Beta : cette documentation couvre une fonctionnalité de Beta et ne constitue pas la documentation finale. Le contenu décrit ici se rapporte à une version Beta et peut être modifié avant sa disponibilité générale. Adobe ne fait aucune déclaration quant à l’exhaustivité ou l’exactitude de cette documentation.
En utilisant le serveur Adobe Real-Time CDP MCP (Beta) (« Beta »), vous reconnaissez que le Beta est fourni « tel quel », sans garantie d’aucune sorte. Adobe n’a aucune obligation de tenir à jour, corriger, mettre à jour, modifier, remplacer ou prendre en charge cette version Beta. Il est recommandé de faire preuve de prudence et de ne pas se fier, de quelque manière que ce soit, au bon fonctionnement ou aux performances de cette version Beta et/ou des éléments qui l’accompagnent. La version Beta est considérée comme étant une information confidentielle dʼAdobe. Tout « commentaire » (informations relatives à la version Beta, y compris, mais sans s’y limiter, les problèmes ou défauts rencontrés lors de son utilisation, les suggestions, les améliorations et les recommandations) que vous fournissez à Adobe est par la présente cédé à Adobe. Cela inclut tous les droits, titres et intérêts relatifs à ces commentaires.
Qu’est-ce que le protocole MCP ? mcp-overview
Les équipes de marketing, de données et d’expérience client s’appuient de plus en plus sur des applications de chat et des outils de développement tels qu’Anthropic Claude, OpenAI ChatGPT, Cursor et Microsoft Copilot Studio pour rationaliser leur travail quotidien. Ces applications prennent en charge le protocole MCP (Model Context Protocol), une norme ouverte qui permet aux applications d’exposer de manière uniforme les outils back-end à des grands modèles de langage (LLM).
Real-Time CDP fournit désormais un serveur MCP qui surface les opérations d’audience, de destination et d’activation directement dans toute application compatible MCP. Grâce à l’intégration de Real-Time CDP MCP, différentes personnes peuvent collaborer autour des mêmes données de segmentation et d’activation, sans avoir à écrire de requêtes sur les API REST de Adobe Experience Platform ni à parcourir plusieurs écrans d’interface utilisateur. Les clientes et clients peuvent décrire leur intention par la conversation et laisser LLM appeler les outils MCP appropriés.
Fonctionnalités principales mcp-capabilities
Le serveur MCP Real-Time CDP est une surface de surveillance et de triage lecture seule. Il expose les API de récupération sur les audiences, les destinations, les sources, les identités et la résolution de profil comme des réponses en langage clair dans votre assistant d’IA, sans écrire de requêtes ni parcourir les écrans de produits. Aucune donnée ne peut être créée, modifiée ou supprimée via le serveur MCP.
La version de Beta comprend les 18 outils suivants :
search_audiencespreview_audience_membershipinspect_audience_evaluation_jobsinspect_audience_export_jobssearch_destination_connectorssearch_destination_accountssearch_destination_input_connectionssearch_destination_output_connectionssearch_destination_flowsinspect_flow_runssearch_source_connectorssearch_source_accountssearch_source_input_connectionssearch_source_output_connectionssearch_source_flowssearch_identity_namespacessearch_merge_policiessearch_organizationsCas d’utilisation mcp-use-cases
Le serveur Real-Time CDP MCP est conçu pour la surveillance et le tri. Étant donné que le serveur fonctionne avec des identifiants plutôt que des noms, un workflow type commence par une liste : demandez à Claude de vous montrer les éléments disponibles, choisissez l’élément souhaité, puis posez des questions de suivi à l’aide de l’identifiant qu’il renvoie.
prod. »abc123. »homeAddress.country = 'US'. »xyz789. »xyz789 et résumez les erreurs. »src456 - Qu’ingère-t-il et où se trouve-t-il ? »src456 d’identifiant de flux source et d’indicateur. »Accès et activation mcp-access
Pour demander l’accès :
- Contactez votre représentant de compte Adobe (responsable du succès client, gestionnaire de compte technique ou gestionnaire de compte) et exprimez votre intérêt pour le programme Real-Time CDP MCP Beta.
- Votre représentant Adobe se coordonnera avec l’équipe produit pour évaluer l’éligibilité et activer votre identifiant d’organisation.
- Une fois activé, votre représentant Adobe confirmera l’accès et fournira tout matériel d’intégration supplémentaire.
Conditions préalables mcp-prerequisites
Avant de connecter le serveur Real-Time CDP MCP à votre client MCP, vérifiez les points suivants :
- Vous disposez d’une licence Real-Time CDP active.
- Votre organisation Adobe a été activée pour le programme Beta par votre représentant Adobe (voir Accès et activation).
- Vous avez accès à un client MCP pris en charge, tel que Claude, ChatGPT, Claude Code, Codex, Cursor ou VS Code.
- Vous disposez de votre identifiant d’organisation et du nom du sandbox sur lequel vous souhaitez effectuer une requête.
- Vous disposez des autorisations nécessaires dans Adobe Experience Platform pour afficher les audiences, les destinations et les entités de service de flux.
Connexion au serveur MCP Real-Time CDP mcp-connect
Le point d’entrée du serveur MCP Real-Time CDP est le suivant :
https://rtcdp-mcp.adobe.io/mcp
Le serveur utilise un transport HTTP distant (HTTP diffusable) avec un flux de connexion Adobe basé sur le navigateur. Pour chaque client, le modèle de configuration est le même :
- Ajoutez l’URL du serveur :
https://rtcdp-mcp.adobe.io/mcp - Enregistrez ou activez la connexion.
- Effectuez la connexion à Adobe à partir d’un navigateur la première fois que le client appelle un outil.
- Fournissez des
imsOrgIdet dessandboxNameau début de chaque session.
Configuration JSON générale mcp-connect-json
Pour les clients qui acceptent une configuration de serveur MCP basée sur JSON, comme Claude Desktop (claude_desktop_config.json), VS Code ou tout client qui lit un fichier mcp.json, utilisez l’un des formats suivants selon que votre client prend en charge le protocole HTTP distant natif ou nécessite un pont local :
Via mcp-remote pont (Claude Desktop et autres clients qui nécessitent un pont local)
{
"mcpServers": {
"rtcdp": {
"command": "npx",
"args": [
"mcp-remote",
"https://rtcdp-mcp.adobe.io/mcp"
]
}
}
}
HTTP distant natif (clients qui le prennent directement en charge)
{
"mcpServers": {
"rtcdp": {
"url": "https://rtcdp-mcp.adobe.io/mcp",
"transport": "http"
}
}
}
Installation sur des clients basés sur l’interface utilisateur mcp-connect-ui
Claude
Pour claude.ai et Claude Desktop, ajoutez le serveur Real-Time CDP MCP en tant que connecteur personnalisé à l’aide du https://rtcdp-mcp.adobe.io/mcp d’URL du serveur.
- Plans individuels — Dans Claude, accédez à Personnaliser → connecteurs, sélectionnez Ajouter un connecteur et saisissez l’URL du serveur.
- Plans d’équipe et d’entreprise — Un espace de travail Propriétaire ou Propriétaire de Principal ajoute le connecteur sous Paramètres de l’organisation → Connecteurs. Une fois ajouté, chaque utilisateur l’active dans ses propres paramètres Claude.
Une fois le connecteur ajouté, activez-le dans une conversation et terminez la connexion au navigateur Adobe lors de la première utilisation. Claude découvre automatiquement le serveur d’autorisation d’Adobe ; aucun identifiant ou secret client n’est requis.
ChatGPT
Dans ChatGPT, ajoutez le serveur Real-Time CDP MCP en tant que connecteur personnalisé :
- Accédez à Paramètres → connecteurs (ou Paramètres → applications et connecteurs, en fonction de votre formule).
- Sélectionnez Ajouter un connecteur et saisissez
https://rtcdp-mcp.adobe.io/mcpcomme URL du serveur. - Enregistrez le connecteur. Selon votre plan de ChatGPT, cette étape peut nécessiter l’approbation de l’administrateur de l’espace de travail ou du mode Développeur.
- Une fois le connecteur activé, authentifiez-vous via la connexion au navigateur Adobe lorsque vous y êtes invité lors de la première utilisation.
Curseur
Dans Cursor, ajoutez le serveur MCP Real-Time CDP en tant que serveur MCP distant :
- Ouvrez Settings → MCP.
- Sélectionnez Ajouter un nouveau serveur et saisissez
https://rtcdp-mcp.adobe.io/mcpcomme URL du serveur. - Sélectionnez se connecter pour déclencher la connexion à Adobe à partir du navigateur et l’authentifier.
Une fois connectés, les outils Real-Time CDP sont disponibles dans les modes Compositeur et Agent du curseur.
Autres clients basés sur l’interface utilisateur
Pour les clients tels que VS Code ou d’autres applications de bureau et web avec prise en charge de MCP à distance, ajoutez le serveur MCP Real-Time CDP en tant que serveur HTTP à distance à l’aide de https://rtcdp-mcp.adobe.io/mcp. Si le client prend en charge des en-têtes ou des jetons du porteur facultatifs, laissez-les vides ; l’authentification est gérée via le flux de connexion Adobe basé sur le navigateur lors de la première utilisation.
Installation dans les clients techniques mcp-connect-technical
Claude Code
Ajoutez le serveur à partir du terminal :
claude mcp add --transport http rtcdp https://rtcdp-mcp.adobe.io/mcp
Démarrez ensuite Claude Code et exécutez :
/mcp
Sélectionnez le serveur rtcdp et terminez le flux de connexion Adobe dans votre navigateur. Si vous avez déjà ajouté le serveur dans claude.ai, il peut apparaître automatiquement dans le code Claude lorsque les deux sont connectés au même compte.
Codex
Ajoutez le serveur à partir du terminal :
codex mcp add rtcdp --url https://rtcdp-mcp.adobe.io/mcp
Authentifiez le serveur :
codex mcp login rtcdp
Vérifiez la configuration :
codex mcp list
Vous pouvez également ajouter directement le serveur à ~/.codex/config.toml :
[mcp_servers.rtcdp]
url = "https://rtcdp-mcp.adobe.io/mcp"
Paramètres de requête requis mcp-connect-params
Chaque appel d’outil nécessite deux paramètres qui définissent la portée de la requête à votre client Adobe Experience Platform :
imsOrgId: votre identifiant d’organisation, mappé à l’en-têtex-gw-ims-org-idsur les appels API Experience Platform en aval.sandboxName: nom du sandbox Experience Platform, mappé à l’en-têtex-sandbox-name.
Fournissez-les au début de chaque session. Par exemple :
« Utilisez les
1234ABCD@AdobeOrgd’organisation et lesprodde sandbox pour cette session. »
Si vous ne connaissez pas votre identifiant d’organisation, demandez à votre assistant d’IA d’appeler search_organizations . Il affichera chaque organisation à laquelle vos informations d’identification Adobe peuvent accéder.
Limites connues (Beta) mcp-limitations
Les restrictions suivantes s’appliquent à la version Beta actuelle du serveur MCP Adobe Real-Time CDP :
Preview Audience Membership nécessite une expression PQL ou SDD valide en entrée ; le serveur MCP ne compose pas la requête pour vous.continuationToken.Inspect Activation Runs prend en charge le filtrage par statut et date et heure d’achèvement (epoch ms UTC), mais pas directement par type d’erreur ou plateforme de destination.flowId (obtenu à partir de List Configured Destinations) vers la portée s’exécute vers une destination spécifique.search_organizations) nécessite imsOrgId et sandboxName comme paramètres explicites. Si elles ne sont pas fournies, les appels d’outils échouent.<YOUR_ORG_ID> d’organisation et les <SANDBOX_NAME> de sandbox pour cette session ». Si vous ne connaissez pas votre identifiant d’organisation, appelez-search_organizations d’abord. Il renverra les organisations auxquelles vos informations d’identification peuvent accéder.