Ortto MCP Server
officielLe nouveau serveur MCP d'Ortto vous permet de connecter votre assistant IA préféré à Ortto. Une fois connecté, votre assistant peut accéder en toute sécurité aux données clients, aux audiences et aux informations sur les campagnes depuis la plateforme CDP et d'automatisation marketing d'Ortto.
Que pouvez-vous faire avec Ortto MCP ?
- Vérifications des performances de campagne — Demandez des métriques de performance pour les e-mails, SMS, push ou parcours, comme les taux d'ouverture et de conversion, via
get_email_report,get_sms_report,get_push_reportouget_journey_report. - Découverte des contacts et des audiences — Trouvez des contacts par nom ou par taille d'audience, et récupérez les inscriptions récentes avec des champs spécifiques à l'aide de
get_contactsetget_audiences. - Gestion des campagnes et des ressources — Listez ou recherchez des campagnes, créez des ressources HTML pour e-mails et mettez à jour leurs métadonnées avec
get_campaigns,create_assetetupdate_asset_meta. - Organisation de la base de connaissances — Créez ou restructurez le contenu d'aide en créant des catégories, en générant des articles à partir de HTML et en les déplaçant avec
create_category,create_article_from_htmletmove_article. - Schéma de compte et informations sur la marque — Récupérez votre schéma de données, vos champs personnalisés et les couleurs/polices du guide de marque via
get_schemaetget_brand_book.
Documentation
Qu'est-ce que MCP ?
Le Model Context Protocol (MCP) est une norme ouverte qui permet aux agents IA (comme Claude ou ChatGPT) d'interagir de manière sécurisée avec des outils et des sources de données externes.
Vous connectez votre agent IA (le client MCP) directement au serveur MCP d'Ortto. Cela permet à votre agent de comprendre et d'agir sur vos données Ortto.
Votre agent peut ensuite vous aider dans diverses tâches à l'aide de requêtes en langage naturel. Par exemple :
- « Montre-moi les performances de mes campagnes e-mail des 30 derniers jours. »
- « Quels parcours performent le mieux en termes de conversions ? »
- « Donne-moi une liste de mes contacts les plus engagés de ce mois-ci. »
Configuration de la source de données MCP
Pour commencer avec notre fonctionnalité MCP, vous devrez créer MCP comme source de données dans votre compte Ortto. Suivez ces étapes pour le configurer :
- Dans votre compte Ortto, accédez à CDP > Sources de données.
- Cliquez sur Nouvelle source de données et recherchez MCP.

- Saisissez un nom pour votre source de données MCP et cliquez sur Connecter.

4. Une fois la source de données créée, vous aurez accès à une clé limitée (Scoped key). Vous devrez utiliser cette clé pour connecter Ortto à l'agent IA de votre choix (Claude, ChatGPT, etc.).

Vous êtes maintenant prêt à connecter Ortto à votre agent IA. Selon l'agent IA que vous utilisez, consultez l'article approprié ci-dessous :
ASTUCE : Vous pouvez connecter Ortto MCP à toute application prenant en charge les connecteurs personnalisés. Si l'application que vous utilisez n'est pas listée ci-dessus, utilisez simplement l'URL du serveur MCP distant appropriée en fonction de l'hébergement de votre compte Ortto.
- États-Unis :
https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key - Europe :
https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key - Australie :
https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key
Si vous ne savez pas où votre compte est hébergé, vous pouvez le trouver dans l'application en accédant à Paramètres > Confidentialité, Sécurité et RGPD > Hébergement des données.

Outils/actions pris en charge
Le serveur MCP d'Ortto permet aux agents IA d'interagir avec vos données Ortto via des outils/actions spécifiques. Les tableaux suivants sont organisés par catégorie de données et détaillent les outils/actions pris en charge ainsi que leurs définitions.
ASTUCE : Les outils/actions décrits dans les tableaux ci-dessous ne sont que la convention de dénomination utilisée par notre fonctionnalité MCP. Vous n'avez pas besoin d'utiliser explicitement ces noms dans votre outil d'agent IA. Votre agent sélectionnera et utilisera automatiquement l'outil/action approprié en fonction de votre demande en langage naturel.
Gestion des campagnes
| Outil/Action | Description |
|---|---|
| get_campaigns | Récupère une liste de vos campagnes avec des options de filtrage et de pagination. Prend en charge le filtrage par type de campagne, état et requêtes de recherche. |
Exemples :
- « Montre-moi toutes mes campagnes e-mail du dernier mois »
- « Récupère les campagnes actuellement en cours »
- « Trouve les campagnes contenant "été" dans le nom »
Contacts et audiences
Outil/Action | Description |
|---|---|
get_contacts | Récupère les contacts avec des options de filtrage complètes, notamment l'ID d'audience, la sélection de champs et les capacités de recherche. |
get_audiences | Liste toutes les audiences de votre compte avec prise en charge de la recherche et de la pagination. |
Exemples :
- « Récupère tous les contacts contenant "smith" dans leur nom »
- « Trouve les audiences de moins de 1 000 membres »
- « Montre-moi les adresses e-mail et les noms des 10 derniers contacts inscrits »
Rapports de campagne
Outil/Action | Description |
|---|---|
get_email_report | Génère des rapports détaillés sur les performances des campagnes e-mail, notamment les taux d'ouverture, les taux de clic et les indicateurs d'engagement. |
get_journey_report | Obtient des analyses complètes des performances des parcours avec des périodes personnalisables. |
get_journey_shape_report | Analyse des formes de parcours spécifiques et leurs indicateurs. |
get_sms_report | Récupère les données de performance des campagnes SMS et les statistiques d'engagement. |
get_push_report | Accède aux analyses des campagnes de notifications push et aux indicateurs de livraison. |
Exemples :
- « Génère un rapport e-mail pour la campagne "Soldes de Noël" »
- « Quelle est la performance globale du parcours "Panier abandonné" ? »
Rapports personnalisés
| Outil/Action | Description |
|---|---|
| list_reports | Accède aux rapports créés par l'utilisateur dans votre compte Ortto avec filtrage par type de graphique et capacités de recherche. |
| get_report | Récupère des données de rapport spécifiques avec des périodes personnalisables et des options d'actualisation. |
Exemples :
- « Liste tous les rapports en camembert de mon compte »
- « Récupère les données du rapport "Revenus T3" »
Compte et configuration
| Outil/Action | Description |
|---|---|
| get_schema | Récupère le schéma de données complet de votre instance Ortto, y compris les champs personnalisés et la structure des données. |
| get_brand_book | Accède aux paramètres de votre charte de marque, notamment les couleurs, les polices et les éléments de marque. |
Exemples :
- « Quelles sont les couleurs de marque principales et secondaires définies dans notre charte de marque ? »
- « Récupère tous les champs personnalisés de mon compte contenant "exemple" dans leur nom »
Gestion des ressources
Outil/Action | Description |
|---|---|
create_asset | Crée de nouvelles ressources, principalement des e-mails HTML, avec un contenu et des métadonnées personnalisables. |
get_asset_html | Récupère le contenu HTML des ressources existantes pour révision ou modification. |
update_asset_meta | Met à jour les métadonnées des ressources, notamment les noms, les lignes d'objet et les informations sur l'expéditeur. |
Exemples :
- « Crée une nouvelle ressource d'e-mail promotionnel intitulée "Des économies à ne pas manquer" avec un contenu expliquant pourquoi les utilisateurs ne devraient pas manquer la prochaine vente »
- « Récupère le contenu HTML de la ressource nommée "E-mail de bienvenue v2" »
Base de connaissances
| Outil/Action | Description |
|---|---|
| get_index | Récupère la structure de la base de connaissances, y compris les catégories et la hiérarchie des articles. |
| create_category | Crée de nouvelles catégories de base de connaissances avec des relations parent-enfant facultatives. |
| create_article_from_html | Crée des articles de base de connaissances à partir de contenu HTML avec catégorisation. |
| move_article | Déplace des articles entre les catégories de votre base de connaissances. |
| modify_index | Met à jour la structure et l'organisation de l'index de la base de connaissances. |
Exemples :
- « Génère un article de base de connaissances à partir de ce HTML et intitule-le "Aperçu MCP" »
- « Crée une nouvelle catégorie appelée "Dépannage" »
- « Montre-moi la structure actuelle de la base de connaissances »
Limites de requêtes
Lorsque vous utilisez un agent IA via la fonctionnalité MCP d'Ortto, vous rencontrerez deux ensembles de limites différents. Bien que les agents IA (tels que Claude ou ChatGPT) imposent leurs propres limites concernant la longueur des requêtes et la taille des réponses, tous les appels API acheminés via le serveur MCP d'Ortto sont soumis à nos limites standard de débit API Ortto. Ces limites de débit s'appliquent en fonction de votre formule d'abonnement et sont mises en œuvre pour garantir la stabilité du système et une utilisation équitable.
En savoir plus sur nos limites de débit API.