[Disponibilité limitée]{class="badge informative" title="Cette fonctionnalité est actuellement en version bêta limitée"}
Marketo Engage MCP Server
Le protocole MCP (Model Context Protocol) est une norme ouverte qui connecte les outils d’IA aux services externes. Le serveur MCP Marketo connecte votre assistant AI à Marketo. Il fournit plus de 100 opérations pour des formulaires, des programmes, des campagnes intelligentes, des prospects, des e-mails, des fragments de code, des listes et des dossiers.
Lorsque votre outil d’IA appelle le serveur MCP, le serveur utilise les informations d’identification contenues dans cette requête pour exécuter l’appel API REST correspondant. Vous n’avez pas besoin d’installer, de déployer ou d’exécuter un logiciel côté serveur.
Pour plus d’informations sur la manière dont les données sont gérées avec l’IA dédiée au Marketo et le serveur MCP de Marketo Engage, consultez la page Informations sur les données.
La connexion des clients ou serveurs MCP aux produits Adobe est une configuration choisie par le client. Ce dernier est chargé d’évaluer la sécurité et l’adéquation de toute intégration MCP. Adobe n’est pas responsable des problèmes résultant d’une mauvaise configuration, d’une utilisation abusive du MCP, de vulnérabilités dans les implémentations tierces ou d’actions involontaires effectuées par le biais de workflows prenant en charge MCP.
Pour réduire les risques, Adobe encourage à tester les intégrations dans un environnement sandbox avant une utilisation productive et à examiner et valider soigneusement toutes les actions et réponses initiées par MCP avant de les confirmer ou de s’y fier.
Principes de base de MCP
Imaginez MCP comme un port USB-C pour les applications d’IA. USB-C fournit un moyen normalisé de connecter vos appareils à divers périphériques et accessoires, et MCP fournit un moyen normalisé de connecter les modèles d’IA aux sources de données et aux outils. — Modèle de protocole contextuel
MCP permet à un outil d’IA de se connecter à plusieurs services externes simultanément. Par exemple, un assistant d’IA peut :
- Connexion à un traitement de texte pour la génération de documents assistée par l’IA
- Connectez-vous aux outils d’animation, tels que Blender, pour créer des visualisations
- Connexion à Adobe After Effects pour le montage vidéo
Toute application peut implémenter MCP pour exposer les données et les actions aux outils d’IA.
Ce que Marketo Engage MCP fait et ne fait pas
Comprendre la portée de MCP permet de définir les attentes avant de connecter votre outil d’IA.
MCP effectue les opérations suivantes :
- Fournir un accès aux données et fonctionnalités Marketo via les API REST standard
- Exécutez les appels API en votre nom à l’aide des informations d’identification fournies avec chaque requête
- Prise en charge de plusieurs utilisateurs simultanés, chacun connecté avec ses propres informations d’identification
- Gérer automatiquement l’actualisation du jeton OAuth. Vous n’avez pas besoin de gérer l’expiration des jetons
- Fonctionnent dans des environnements isolés du client afin que vos données n’interagissent jamais avec la session d’un autre utilisateur
MCP ne :
- Utilisez, hébergez ou exécutez des modèles d’IA ou de machine learning. Tout le traitement de l’IA s’effectue dans votre outil d’IA, et non dans le MCP
- Apprenez-en plus sur les données, y compris les données de vos clients, ou tirez des leçons de ces données.
- générer des prédictions, des recommandations ou des décisions ; La prise de décision est de la responsabilité de l’outil d’IA ou de l’utilisateur en aval
- Stocker ou conserver les informations d’identification, les données de requête ou l’état de session entre les requêtes
- Nécessite l’installation, le déploiement ou la gestion de tout logiciel côté serveur
MCP peut transmettre des données, y compris des champs potentiellement sensibles, en fonction de l’utilisation de l’API, mais les données B2B impliquent des données commerciales du client et n’impliquent pas de données PII.
Conditions préalables
- Une instance Marketo avec l’accès API REST activé
- Accès administrateur à la création d’informations d’identification d’API dans Marketo LaunchPoint
- L’un des outils d’IA suivants : Claude Desktop, Cursor, Codex, Claude Code (CLI) ou VS Code avec Copilote GitHub
- Accès réseau à l’URL du serveur MCP :
https://marketo-mcp.adobe.io/mcp
Obtention des informations d’identification Marketo
Vous avez besoin des valeurs suivantes de votre instance Marketo :
- Identifiant du client
- Secret du client
- Identifiant de compte
Si vous les avez déjà, passez à Configurer votre outil d’IA.
ID client et secret client
- Accédez à Admin > LaunchPoint.
- Sélectionnez votre service d’API. Si vous n’en avez pas, sélectionnez Nouveau > Nouveau service, choisissez Personnalisé comme type de service et affectez un utilisateur ou une utilisatrice d’API dédié(e).
- Sélectionnez Afficher les détails et copiez les valeurs ID client et Secret client.
ID de compte Munchkin
- Accédez à Admin > Munchkin.
- Copiez l’ID de compte . Le format est
XXX-XXX-XXXet correspond au préfixe de l’URL de votre instance.
Configuration de votre outil d’IA
La configuration diffère selon l’outil d’IA. Les sections suivantes fournissent des exemples de connexion pour les outils courants.
marketo-prod et marketo-staging, chacun avec les informations d’identification correspondantes.Claude Desktop claude-desktop
Pour vous connecter à Claude Desktop, téléchargez marketo-mcp-bridge.zip et décompressez-le. Placez le marketo-mcp-bridge.mjs à un emplacement connu pour vous y référer à l’étape suivante.
Tu auras également besoin de :
- Node.js v18 et ultérieure
- npm
- Ouvrez Claude Desktop.
- Accédez à Paramètres > Développeur > Modifier la configuration.
- Ajoutez le code suivant à
claude_desktop_config.json:
{
"preferences": {
...
},
"mcpServers": {
"marketo-mcp": {
"command": "node",
"args": ["/path/to/marketo-bridge/bridge.mjs"],
"env": {
"MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
"MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
"MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
}
}
}
}
- Redémarrez Claude Desktop.
Curseur cursor
Si votre configuration MCP de curseur contient déjà d’autres serveurs, ajoutez l’entrée marketo sous mcpServers.
L’exemple suivant montre le bloc de mcpServers complet dans Paramètres > MCP ou .cursor/mcp.json dans le répertoire du projet :
| code language-json |
|---|
|
| code language-json |
|---|
|
Redémarrez le curseur.
Claude Code (CLI) claude-code
Exécutez la commande suivante dans votre terminal en remplaçant vos informations d’identification :
| code language-bash |
|---|
|
| code language-bash |
|---|
|
Codex OpenAI codex
- Accédez à Paramètres > Serveurs MCP > Ajouter un serveur .
- Ajoutez l’URL du serveur :
https://marketo-mcp.adobe.io/mcp. - Ajoutez les en-têtes pour votre méthode d’authentification :
- Autorisation : « Porteur DE VOTRE JETON IMS »
- x-gw-ims-org-id : « YOUR-IMS-ORG-ID »
- X-Marketo-Client-Id : « YOUR-CLIENT-ID »
- X-Marketo-Client-Secret : « YOUR-CLIENT-SECRET »
- X-Marketo-Munchkin-Id : « YOUR-MUNCHKIN-ID »
- Sélectionnez Enregistrer pour terminer le processus.
VS Code avec pilote GitHub vscode
Appuyez sur Ctrl+Maj+P (ou Cmd+Maj+P sur macOS), saisissez MCP: Open User Configuration, puis appuyez sur Entrée. Cette action ouvre mcp.json. Ajoutez l’entrée marketo dans l’objet servers :
| code language-json |
|---|
|
| code language-json |
|---|
|
${MARKETO_CLIENT_SECRET} et les définir dans votre environnement. Cela empêche de stocker les informations d’identification en texte brut dans des fichiers dont la version est contrôlée.Glaner glean
Pour connecter Glean au serveur MCP Marketo Engage, l’équipe d’assistance Glean doit configurer les en-têtes personnalisés suivants.
X-Marketo-Client-IdX-Marketo-Client-SecretX-Marketo-Munchkin-IdAutres outils other-tools
Adobe héberge le serveur MCP Marketo et l’expose à une URL publique. Tout client MCP prenant en charge des serveurs distants via un transport HTTP en flux continu peut s’y connecter.
Vous n’avez pas besoin d’un pont spécifique à un outil ni d’un logiciel installé localement. Si votre outil n’est pas répertorié ci-dessus, utilisez les détails de connexion ci-dessous pour le configurer manuellement.
Détails de la connexion :
https://marketo-mcp.adobe.io/mcpEn-têtes d’authentification :
Envoyez les en-têtes pour l’une des méthodes d’authentification suivantes avec chaque requête. L’emplacement où vous saisissez l’URL du serveur et les en-têtes dépend de votre outil. Consultez donc sa documentation MCP.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Header | Valeur |
Authorization |
Bearer YOUR-IMS-TOKEN |
x-gw-ims-org-id |
Votre identifiant de l’organisation IMS |
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Header | Valeur |
X-Marketo-Client-Id |
Votre identifiant client |
X-Marketo-Client-Secret |
Votre Secret Client |
X-Marketo-Munchkin-Id |
Identifiant de votre compte Munchkin |
Si votre outil accepte une configuration JSON, commencez par les exemples Cursor ou VS Code, puis ajustez les touches (mcpServers, servers) pour qu’elles correspondent au schéma de votre outil.
Opérations disponibles
Une fois connecté, vous pouvez demander à votre assistant d’IA d’effectuer des opérations dans les catégories suivantes. Pour obtenir la liste complète des opérations prises en charge avec les références d’API, voir Opérations MCP prises en charge.
Formulaires
Parcourir, créer, cloner et approuver des formulaires. Ajouter ou supprimer des champs, configurer des règles de visibilité des champs et identifier l’emplacement d’incorporation des formulaires.
Exemples d’invites :
- « Afficher tous les formulaires approuvés »
- « Clonez le formulaire Nous contacter dans le dossier Campagne du 2e trimestre »
- « Ajouter un champ Société au formulaire de demande de démonstration »
Campagnes intelligentes
Créez des campagnes intelligentes, configurez des filtres de liste dynamique, ajoutez des étapes de flux et activez ou désactivez des campagnes.
Exemples d’invites :
- « Quelles campagnes intelligentes sont actives en ce moment ? »
- « Créez une campagne intelligente appelée Mise à jour de la notation du lead dans le dossier Opérations »
- « Afficher les étapes de flux dans la campagne E-mail de bienvenue »
Leads et listes
Rechercher des prospects par adresse e-mail, créer ou mettre à jour des enregistrements de prospect et gérer l’appartenance à une liste statique.
Exemples d’invites :
- « Trouver le prospect avec un e-mail jane@example.com »
- « Ajouter l’ID de lead 12345 à la liste MQL du 2e trimestre »
- « Création d’une liste statique appelée Participants à l’événement d’été »
Programmes
Créer, cloner et baliser des programmes. Parcourir les programmes par type, canal ou période.
Exemples d’invites :
- « Clonez le programme de webinaire du 4e trimestre dans le dossier Événements 2026 »
- « Créez un programme de messagerie appelé Vente d’été dans le dossier Campagnes »
- « Afficher tous les programmes identifiés comme des webinaires »
E-mails et fragments de code
Parcourez les e-mails, créez des e-mails à partir de modèles, mettez à jour les sections de contenu et gérez les fragments de code réutilisables.
Exemples d’invites :
- « Afficher tous les brouillons d’e-mails »
- « Mettre à jour la section d’en-tête de l’e-mail de bienvenue »
- « Quels éléments utilisent le fragment de code de promotion Holiday ? »
Structure de l’instance
Pour comprendre la configuration de votre Marketo, parcourez les dossiers, les canaux, les types de balises et les types d’activités.
Exemples d’invites :
- « Répertorier tous les dossiers dans Marketo »
- « Afficher tous les canaux disponibles »
- « Quels types de balises sont configurés ? »
Opérations en masse
Exporter les données de prospect en bloc et vérifier l’état de la tâche d’importation ou d’exportation.
Exemples d’invites :
- « Créer une exportation en bloc de prospects créés au cours des 30 derniers jours »
- « Vérifier le statut de la tâche d’exportation xx »
Dépannage
X-Marketo-Client-Id, X-Marketo-Client-Secret ou X-Marketo-Munchkin-Id sont manquants.Authorization.Considérations relatives à la sécurité
- Informations d’identification par demande. L’ID client, le secret client, l’ID Munchkin et le point d’entrée de l’API REST sont transmis dans des en-têtes HTTP avec chaque requête. Le serveur ne les stocke pas et ne les met pas en cache.
- Isolement à plusieurs clients. Chaque requête utilise son propre jeu d’informations d’identification. Vos données n’interagissent avec aucune session d’un autre utilisateur.
- Munchkin ID Le serveur accepte uniquement les demandes d’instances Marketo approuvées. Les requêtes utilisant un ID Munchkin non autorisé sont rejetées avec une erreur 403.
- Limites de débit d’API. Le serveur MCP hérite des limites de débit d’API de votre instance Marketo. Utilisez un utilisateur d’API dédié pour suivre et gérer la consommation des quotas.
- Gardez les informations d’identification hors du contrôle de version. Utilisez l’interpolation de variable d’environnement (
${MARKETO_CLIENT_SECRET}) si votre outil d’IA le prend en charge, de sorte que les informations d’identification ne soient pas stockées en texte brut dans les fichiers de référentiel.
Gouvernance et conservation des données
Gestion des informations d’identification
- Les informations d’identification du client ne sont pas conservées côté serveur et sont fournies par le client par demande, ce qui permet de limiter l’exposition des informations d’identification dans le service.
Modèle d’interaction API
- Utilisation des agents : les agents peuvent utiliser le serveur MCP pour appeler les API Marketo prises en charge.
- Alignement du modèle d’authentification : le service utilise le même modèle d’authentification API externe documenté pour les API Marketo.
Authentification et autorisation
- Privilèges de moindre importance : les autorisations effectives sont héritées de l’utilisateur de l’API Marketo uniquement affecté au service LaunchPoint du client, ce qui permet l’administration avec les privilèges de moindre importance dans la configuration Marketo du client.
- Aucune persistance des jetons côté serveur : le service continue d’éviter le stockage côté serveur des informations d’identification du client ou des jetons.
Journalisation et surveillance
- Journalisation de sécurité : les journaux JSON structurés sont acheminés par le biais de Fluent Bit vers Splunk, avec le masquage des données sensibles et un filtrage supplémentaire pour prendre en charge les exigences de conformité.
- Support d’audit : ces contrôles prennent en charge la surveillance continue de la disponibilité du service, des événements liés à la sécurité et de la qualité opérationnelle.
- Aucun stockage secret côté serveur : les informations d’identification des clients ne sont pas stockées par le déploiement MCP et doivent être fournies par les clients par requête.
- Gestion des jetons : les jetons d’accès sont de courte durée, les réponses des jetons sont marquées comme étant hors magasin et les jetons sont acceptés par le biais de mécanismes d’autorisation standard plutôt que par la transmission de chaînes de requête.
- Accès opérationnel basé sur les rôles : l’accès au déploiement administratif est régi par les rôles de l’infrastructure Adobe et les contrôles basés sur les groupes, tandis que les autorisations relatives aux plans de données sont héritées de la configuration utilisateur de l’API Marketo du client.
- Audit et observabilité : la journalisation de la sécurité, le masquage, la surveillance et les alertes sont activés pour prendre en charge les enquêtes, le suivi de l’intégrité des services et la supervision opérationnelle.