[Disponibilité limitée]{class="badge informative" title="Cette fonctionnalité est actuellement en version bêta limitée"}

Marketo Engage MCP Server

AVAILABILITY
Cette fonctionnalité est en disponibilité limitée. Pour demander l’accès, remplissez ce formulaire. Assurez-vous que l’identifiant Munchkin de votre abonnement est prêt.

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.

IMPORTANT
Le protocole MCP (Model Context Protocol) est une norme open source émergente qui peut présenter des risques pour la sécurité ou la fiabilité. Les intégrations de serveurs Adobe MCP et la documentation associée sont fournies « en l’état », sans garantie d’aucune sorte.
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

  1. Accédez à Admin > LaunchPoint.
  2. 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).
  3. Sélectionnez Afficher les détails et copiez les valeurs ID client et Secret client.

ID de compte Munchkin

  1. Accédez à Admin > Munchkin.
  2. Copiez l’ID de compte . Le format est XXX-XXX-XXX et 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.

TIP
Pour vous connecter à plusieurs instances Marketo, ajoutez des entrées distinctes dans votre configuration MCP avec des noms uniques : 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
  1. Ouvrez Claude Desktop.
  2. Accédez à Paramètres > Développeur > Modifier la configuration.
  3. 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>"
      }
    }
  }
}
  1. 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 :

Jeton IMS
code language-json
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
Informations d’identification du client
code language-json
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}

Redémarrez le curseur.

Claude Code (CLI) claude-code

Exécutez la commande suivante dans votre terminal en remplaçant vos informations d’identification :

Jeton IMS
code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "Authorization: Bearer YOUR-IMS-TOKEN" \
  --header "x-gw-ims-org-id: YOUR-IMS-ORG-ID"
Informations d’identification du client
code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "X-Marketo-Client-Id: YOUR-CLIENT-ID" \
  --header "X-Marketo-Client-Secret: YOUR-CLIENT-SECRET" \
  --header "X-Marketo-Munchkin-Id: YOUR-MUNCHKIN-ID"

Codex OpenAI codex

  1. Accédez à Paramètres > Serveurs MCP > Ajouter un serveur .
  2. Ajoutez l’URL du serveur : https://marketo-mcp.adobe.io/mcp.
  3. Ajoutez les en-têtes pour votre méthode d’authentification :
Jeton IMS
  • Autorisation : « Porteur DE VOTRE JETON IMS »
  • x-gw-ims-org-id : « YOUR-IMS-ORG-ID »
Informations d’identification du client
  • X-Marketo-Client-Id : « YOUR-CLIENT-ID »
  • X-Marketo-Client-Secret : « YOUR-CLIENT-SECRET »
  • X-Marketo-Munchkin-Id : « YOUR-MUNCHKIN-ID »
  1. 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 :

Jeton IMS
code language-json
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
Informations d’identification du client
code language-json
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}
NOTE
Pour des raisons de sécurité, utilisez l’interpolation des variables d’environnement dans les fichiers de configuration au lieu de coller directement les informations d’identification. Vous pouvez référencer des variables à l’aide d’une syntaxe telle que ${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.

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

Autres 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 :

Paramètre
Valeur
Transport
HTTP (flux HTTP)
URL du serveur
https://marketo-mcp.adobe.io/mcp

En-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.

Jeton IMS
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
Informations d’identification du client
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

Erreur
Cause
Corriger
« Informations d’identification Marketo non fournies »
Un ou plusieurs parmi X-Marketo-Client-Id, X-Marketo-Client-Secret ou X-Marketo-Munchkin-Id sont manquants.
Vérifiez que tous les en-têtes d’informations d’identification du client Marketo sont présents dans votre configuration.
« 401 Non Autorisé »
Vos informations d’identification sont manquantes, non valides ou expirées. Avec les informations d’identification du client Marketo, l’ID client ou le secret client est incorrect. Avec un jeton IMS, le jeton n’est pas valide ou a expiré.
Vérifiez les informations d’identification de votre méthode d’authentification. Pour les informations d’identification du client, revérifiez les ID client et Secret client dans Admin > LaunchPoint. Pour un jeton IMS, générez un nouveau jeton et mettez à jour l’en-tête Authorization.
« 403 Interdit »
Vos informations d’identification sont valides, mais votre instance Marketo n’est pas activée pour l’accès au MCP.
Contactez votre administrateur MCP Marketo pour activer l’accès MCP à votre ID de compte Munchkin.
« Trop de requêtes » (limite de taux)
Vous avez envoyé trop de requêtes en une courte période, ou trop de requêtes au même moment, et atteint les limites d’API de votre instance Marketo.
Réduisez la fréquence et le nombre de requêtes que vous envoyez à la fois, et patientez quelques instants avant de réessayer. Utilisez un utilisateur d’API dédié pour suivre et gérer votre quota.
Timeout ou refus de la connexion
Le serveur MCP est inaccessible depuis votre réseau.
Vérifiez que vous pouvez accéder à l’URL du serveur à partir de votre environnement. Vérifiez les exigences VPN, le cas échéant.
Les appels d’outils renvoient des résultats vides
L’utilisateur de l’API ne dispose pas des autorisations pour le type de ressource demandé.
Demandez à votre administrateur Marketo de passer en revue le rôle et les autorisations de l’utilisateur API.

Considérations relatives à la sécurité

IMPORTANT
Utilisez un utilisateur d’API dédié dans Marketo avec uniquement les autorisations requises pour votre travail. Ne réutilisez pas les informations d’identification d’administrateur pour l’accès à l’API.
  • 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.
recommendation-more-help
marketo-developer-help