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 ?
- Récupérer et filtrer les campagnes — Demandez des campagnes par type, état ou nom en utilisant
get_campaigns. - Rechercher des contacts et des audiences — Trouvez des contacts par nom ou champ et listez les audiences avec
get_contactsetget_audiences. - Extraire les rapports de performance des campagnes — Obtenez les analyses des e-mails, parcours, SMS ou notifications push via
get_email_report,get_journey_report,get_sms_reportetget_push_report. - Accéder aux rapports personnalisés — Listez les rapports créés par l'utilisateur et récupérez leurs données avec
list_reportsetget_report. - Gérer le contenu de la base de connaissances — Créez des catégories, publiez des articles HTML et réorganisez l'index en utilisant
create_category,create_article_from_htmletmodify_index. - Inspecter le schéma du compte et le guide de marque — Récupérez les champs personnalisés et les paramètres de marque via
get_schemaetget_brand_book.
Documentation
Aller sur ortto.com
Accueil Ortto MCP Ortto MCP
Ortto MCP
Qu’est-ce que MCP ?
Le Model Context Protocol (MCP) est un standard ouvert 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 alors vous assister dans diverses tâches en utilisant des invites en langage naturel. Par exemple :
- « Affiche-moi les performances de mes campagnes email des 30 derniers jours. »
- « Quels parcours sont les plus performants en termes de conversions ? »
- « Donne-moi une liste de mes contacts les plus engagés ce mois-ci. »
Configuration de la source de données MCP
Pour commencer à utiliser notre fonctionnalité MCP, vous devez créer MCP en tant que source de données dans votre compte Ortto. Suivez ces étapes pour la 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é délimitée. 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 :
- Utiliser Ortto MCP avec Claude
- Utiliser Ortto MCP avec ChatGPT
ASTUCE : Vous pouvez connecter Ortto MCP à toute application prenant en charge les connecteurs personnalisés. Si l’application que vous utilisez n’est pas répertoriée ci-dessus, utilisez simplement l’URL du serveur MCP distant appropriée en fonction de l’emplacement d’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 nommage utilisée par notre fonctionnalité MCP. Vous n’avez pas à 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 :
- « Affiche toutes mes campagnes email du mois dernier »
- « 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 incluant 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 ayant 'smith' dans leur nom »
- « Trouve les audiences qui ont moins de 1 000 membres »
- « Affiche les adresses email 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 de performance des campagnes email, incluant les taux d’ouverture, de clic et les métriques d’engagement. |
| get_journey_report | Obtient des analyses complètes de performance des parcours avec des périodes personnalisables. |
| get_journey_shape_report | Analyse des formes de parcours spécifiques et leurs métriques. |
| 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 métriques de délivrabilité. |
Exemples :
- « Génère un rapport email 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 les données d’un rapport spécifique avec des périodes personnalisables et des options d’actualisation. |
Exemples :
- « Liste tous les rapports de type graphique circulaire dans 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 graphique, y compris les couleurs, les polices et les éléments de marque. |
Exemples :
- « Quelles sont les couleurs primaires et secondaires de la marque définies dans notre charte graphique ? »
- « Récupère tous les champs personnalisés de mon compte qui contiennent 'exemple' dans leur nom »
Gestion des ressources
| Outil/Action | Description |
|---|---|
| create_asset | Crée de nouvelles ressources, principalement des emails HTML, avec un contenu et des métadonnées personnalisables. |
| get_asset_html | Récupère le contenu HTML des ressources existantes pour examen ou modification. |
| update_asset_meta | Met à jour les métadonnées des ressources, y compris les noms, les lignes d’objet et les informations sur l’expéditeur. |
Exemples :
- « Crée une nouvelle ressource d’email promotionnel intitulée 'Économies à ne pas manquer' avec un contenu expliquant pourquoi les utilisateurs ne devraient pas manquer la vente à venir »
- « Récupère le contenu HTML de la ressource nommée 'Email 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 dans la base de connaissances avec des relations parent-enfant optionnelles. |
| create_article_from_html | Crée des articles de la base de connaissances à partir de contenu HTML avec catégorisation. |
| move_article | Déplace les 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 la base de connaissances à partir de ce HTML et intitule-le 'Aperçu de MCP' »
- « Crée une nouvelle catégorie appelée 'Dépannage' »
- « Affiche 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) appliquent 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 de débit API Ortto standard. 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.