Passer au contenu principal

Model Context Protocol (MCP), intégration expliquée

Découvrez comment la plateforme MCP d'Agorapulse vous permet de d'intégrer des outils d'IA.

Le Connecteur Agorapulse Model Context Protocol (MCP) vous permet d'intégrer Agorapulse à des assistants conversationnels d'IA comme Claude et ChatGPT, vous permettant ainsi de gérer vos réseaux sociaux directement depuis ces outils d'IA.

Cette intégration vous permet d'accéder à vos données de médias sociaux, d'analyser vos performances, de créer du contenu et de gérer votre calendrier à l'aide de commandes en langage naturel au sein de l'interface d'IA.

Dans cet article, nous aborderons les points suivants :

Admissibilité et exigences

Le connecteur MCP est disponible pour tous les utilisateurs d'Agorapulse à l'exclusion des utilisateurs des plans Legacy.

Veuillez noter: Le connecteur MCP est actuellement en version bêta et son prix est susceptible de changer.

Pour utiliser le connecteur, vous devez disposer d'un abonnement actif à l'un des services d'IA suivants :

  • Claude : Pro, Max, Team ou Enterprise.

  • ChatGPT : Go, Plus, Pro ou Équipe.

  • Copilot: Copilot Studio

Vous aurez également besoin d'un rôle d'administrateur sur vos comptes Claude ou ChatGPT.

Connexion d'Agorapulse aux assistants IA

Le processus de connexion utilise Authentification OAuth pour accéder à votre compte Agorapulse, vous devez vérifier les autorisations avant d'autoriser la connexion.

Connexion à ChatGPT

Vous devez être le Propriétaire du compte ChatGPT pour le connecter. En tant que propriétaire du compte, vous devrez :

  1. Allez sur chatgpt.com et connectez-vous à votre compte

  2. Accédez à la section connecteurs:

    • Pour ChatGPT Business: Allez à Espace de travail puis Applications

    • Pour ChatGPT Plus ou Pro: Allez à Paramètres puis Applications

  3. Sous Paramètres avancés, activer Mode développeur

  4. De retour sur la page de connecteurs, sélectionnez Connecteurs personnalisés et ajoutez les détails suivants :

  5. Vous serez invité à autoriser la connexion en vous connectant à votre compte. Agorapulse

  6. Vérifiez les autorisations et autorisez ChatGPT à accéder à vos données Agorapulse.

Votre compte Agorapulse sera désormais connecté à ChatGPT, et vous pourrez utiliser votre connecteur MCP personnalisé dans vos conversations.

Connection avec Claude

Vous devez être le Propriétaire du compte Claude pour vous connecter. En tant que propriétaire du compte, vous pouvez connecter le MCP d'Agorapulse en recherchant Agorapulse dans l'annuaire de Claude, sous Connecteurs, ou en l'ajoutant en tant que connecteur personnalisé.

Pour ajouter Agorapulse depuis l'annuaire de Claude, vous devez :

  1. Vous rendre sur claude.ai et vous connecter à votre compte

  2. Cliquer sur votre photo de profil en bas à gauche

  3. Sélectionner Paramètres, puis cliquer sur Connecteurs

  4. En haut de la fenêtre, cliquer sur Découvrir

  5. Dans la barre de recherche, saisir Agorapulse

  6. Cliquer sur Connecter

  7. Si vous n'êtes pas connecté à Agorapulse, vous serez invité à vous connecter. Une fois connecté, cliquer sur Autoriser

Après avoir autorisé la connexion, vous serez redirigé vers Claude, où Agorapulse apparaîtra désormais dans votre liste de connecteurs.

Pour ajouter Agorapulse en tant que connecteur personnalisé, vous devez :

  1. Vous rendre sur claude.ai et vous connecter à votre compte

  2. Cliquer sur votre photo de profil en bas à gauche

  3. Sélectionner Paramètres

  4. Cliquer sur Connecteurs, puis sélectionner Ajouter un connecteur

  5. Vous devrez renseigner :

  6. Ensuite, vous devrez définir qui peut utiliser ce connecteur :

    • Tous les membres

    • Des équipes spécifiques

    • Approbation manuelle

  7. Une fois la configuration terminée, assurez-vous que :

    • Le serveur MCP répond correctement

    • L’authentification (si nécessaire) fonctionne correctement

    • Le connecteur renvoie les données attendues

Une fois la connexion établie, vous pouvez commencer à utiliser les commandes Agorapulse directement dans vos conversations avec Claude.

Connexion à Copilot

  1. Connectez-vous à Microsoft Copilot Studio sur copilotstudio.microsoft.com

  2. Accédez à votre Agent et sélectionnez l’onglet Tools

  3. Cliquez sur Add a tool, puis sélectionnez New tool

  4. Choisissez Model Context Protocol parmi les options

  5. Renseignez les informations requises :

- Nom du serveur : Agorapulse (ou le nom de votre choix)
- Description du serveur : Accéder aux fonctionnalités de gestion des

réseaux sociaux d’Agorapulse
- URL du serveur : https://api.openmcp.agorapulse.com/mcp
6. Sélectionnez le type d’authentification :

  • Authentification OAuth : choisissez OAuth 2.0 et suivez les étapes de découverte dynamique ou de configuration manuelle

7. Cliquez sur Create pour ajouter le serveur
8. Lorsque cela vous est demandé, autorisez la connexion en vous connectant à votre compte Agorapulse
9. Vérifiez les autorisations et autorisez Copilot Studio à accéder à vos données Agorapulse

Une fois connecté, le serveur MCP d’Agorapulse apparaîtra comme un outil dans l’onglet Tools de votre agent. Tous les outils et ressources MCP d’Agorapulse seront automatiquement disponibles pour être utilisés par votre agent.

Gérer votre connexion

Chaque membre de l'équipe peut se connecter indépendamment à Agorapulse via son propre compte utilisateur. Chaque connexion est personnelle et sécurisée. Vous pouvez déconnecter le connecteur à tout moment depuis les paramètres de Claude ou de ChatGPT.

Dans ChatGPT

Pour gérer ou déconnecter votre connecteur Agorapulse dans ChatGPT :

  1. Accédez à la section Connecteurs :

    • Pour ChatGPT Business: Allez sur Espace de travail et puis Applications

    • Pour ChatGPT Plus ou Pro: Allez sur Paramètres et puis Applications

  2. Cliquez sur Agorapulse dans votre liste de connecteurs.

  3. Enfin, cliquez sur Déconnecter

Pour Claude

Pour gérer ou déconnecter votre connecteyr Agorapulse de Claude :

  1. Cliquez sur votre image de profil dans le coin inférieur gauche

  2. Sélectionner Paramètres

  3. Cliquez sur Connecteurs

  4. Cliquez sur les trois points à côté de Agorapulse.

  5. Sélectionner Déconnecter​

Dans Copilot

Pour gérer votre connecteur Agorapulse dans Copilot :

  1. Allez dans l’onglet Outils de votre agent

  2. Sélectionnez le serveur Agorapulse MCP dans la liste

  3. Désactivez Tout autoriser pour afficher les contrôles individuels des outils

  4. Utilisez les interrupteurs individuels pour activer uniquement les outils dont vous avez besoin

Pour supprimer le connecteur de Copilot :

  1. Allez dans l’onglet Outils de votre agent

  2. Sélectionnez le serveur Agorapulse MCP dans la liste

  3. Repérez l’outil dans la liste, survolez son nom et cliquez sur les trois points (…)

  4. Sélectionnez Supprimer. Une fenêtre de confirmation s’affiche

  5. Cliquez sur Supprimer pour retirer le connecteur

Utilisation du connecteur

Une fois connecté, vous pouvez interagir avec Agorapulse en utilisant le langage naturel. L'assistant IA appellera automatiquement le service approprié Agorapulse pour répondre à votre demande et vous présenter les résultats dans un format clair et conversationnel.

Veuillez noter: Le connecteur MCP fonctionne avec les applications mobiles Claude et ChatGPT, à condition de disposer d'un abonnement compatible. Le connecteur fonctionne également avec Claude Desktop, web et mobile.

Capacités du connecteur MCP

Le connecteur Agorapulse MCP vous permet d'effectuer plusieurs actions clés réparties en cinq grandes catégories :

Boîte de réception

  • Lire les éléments de la boîte de réception d’un ou plusieurs profils sociaux, du plus récent au plus ancien : commentaires organiques, commentaires publicitaires, commentaires sur les Reels, conversations privées, mentions, mentions dans les stories et avis pour Facebook, Instagram, LinkedIn, TikTok, X (Twitter) et Threads.
    ​Remarque : les éléments récupérés affichent l’historique de modération et, pour les commentaires, le post auquel ils sont associés.

  • Filtrer les éléments selon leur état dans la boîte de réception, par exemple les éléments restant à examiner

  • Filtrer les éléments qui sont toujours en attente d’approbation.

  • Lire une conversation privée message par message, avec la possibilité de filtrer par date.

  • Répondre publiquement à un élément ou répondre en privé à un élément public (Facebook, Instagram ou X), avec la possibilité de contrôler les personnes mentionnées sur X.

Remarque : les réponses sont soumises aux workflows d'approbation de l'Inbox. Si un workflow actif s'applique au profil et à votre utilisateur, la réponse est mise en attente d'approbation par un manager au lieu d'être publiée immédiatement. Vous ne pouvez pas répondre à un élément dont la réponse est déjà en attente d'approbation. Votre agent IA vous demandera de confirmer une réponse avant de l'envoyer.

Veille

  • Lire les éléments récupérés par une recherche Listening, du plus récent au plus ancien : publications et commentaires sur les réseaux sociaux, ainsi que les articles d’actualité, articles de blog et publications de forums.

  • Filtrer par recherche, période de publication, source (Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Reddit, actualités web, blogs et forums) et sentiment.
    ​Remarque : si aucune période n’est définie, les éléments des sept derniers jours sont récupérés.

  • Consulter les métriques Listening : volume, engagement, sentiment et nuages de mots, pour les recherches Standard et Competitive.

Publication et gestion de contenu

  • Créez des brouillons de publications pour vos profils sociaux. Les images et vidéos ajoutées à vos publications doivent être partagées sous forme d’URL publiques
    Remarque : chaque brouillon est créé pour un seul profil. Pour publier sur trois réseaux, votre agent IA crée trois brouillons

  • Recherchez et créez des notes de calendrier

Veuillez noter : les options propres à chaque réseau (premier commentaire, fils de discussion, tableau Pinterest, événements Google Business) ne sont pas prises en charge via le MCP.

Analyses et perspectives

  • Obtenez des données démographiques et des informations sur vos abonnés pour vos profils

  • Analysez les indicateurs de performance du contenu, notamment l'engagement, la portée et les impressions.

  • Suivre les performances de la marque sur plusieurs comptes de réseaux sociaux

  • Identifiez vos contenus les plus performants grâce à des indicateurs spécifiques.

  • Surveillez les indicateurs de gestion de la communauté, notamment les réponses, les messages et les temps de réponse.

  • Analysez les performances des publications avec des labels spécifiques.

  • Créez n’importe quel rapport disponible dans les Rapports Agorapulse : votre agent IA identifie les métriques disponibles pour vos profils et calcule celle dont vous avez besoin

  • Obtenez les données démographiques des spectateurs de vos vidéos (âge, genre, pays, région, ville), lorsque le réseau les fournit

  • Comparez les performances payantes et organiques des publications associées à des labels spécifiques

  • Analysez le sentiment des messages que vous avez reçus (positif, négatif, neutre)

Gestion organisationnelle

  • Dressez la liste de toutes vos organisations et de vos espaces de travail.

  • Accédez à vos profils sociaux connectés.

  • Afficher les paramètres de l'espace de travail et de l'organisation.

  • Dressez la liste de vos groupes de profils, c’est-à-dire les dossiers utilisés pour organiser vos profils, par exemple par client ou par marque.

Veuillez noter: Le nombre d'outils MCP disponibles augmentera au fil du temps.

Exemples de messages

Une fois l'assistant IA connecté, vous pouvez interagir avec Agorapulse en langage naturel. L'assistant IA appellera automatiquement les outils Agorapulse appropriés pour répondre à votre demande et vous présentera les résultats de manière claire et conversationnelle.

Le tableau ci-dessous présente quelques exemples de prompt que vous pouvez utiliser :

Catégorie

Exemple d'invite

Édition et calendrier

"Créez un brouillon de publication pour ma page Facebook concernant le lancement de notre nouveau produit."

Édition et calendrier

"Montre-moi toutes les notes du calendrier pour la semaine prochaine."

Analyse et reporting

« Quels sont mes cinq publications les plus performantes ce mois-ci en termes d'engagement ? »

Analyse et reporting

"Affichez-moi les données démographiques de l'audience de mon profil Instagram."

Analyse et reporting

« Comment se porte l’équipe en matière de temps de réponse cette semaine ? »

Gestion organisationnelle

"Liste de toutes mes organisations Agorapulse."

Boîte de réception

« Montre-moi les commentaires qu’aucun membre de l’équipe n’a encore examinés. »

Boîte de réception

Rédigez une réponse à cet avis, en remerciant le client et en lui proposant de l’aide.

Veille

« Que disent les gens à notre sujet dans le cadre des recherches portant sur notre marque ? »

Veille

« Quel est notre score de sentiment par rapport à ce concurrent ? »

Limites

Le connecteur MCP vous permet de créer des brouillons de publications, mais il ne publie pas automatiquement le contenu sur vos réseaux sociaux. Vous devrez donc programmer et publier ces brouillons depuis Agorapulse.

Sécurité et confidentialité

La connexion utilise OAuth : vous vous connectez avec votre propre compte Agorapulse et ne partagez jamais de clé API. Votre agent IA voit exactement ce que votre utilisateur peut voir dans Agorapulse, selon votre rôle et vos permissions. Vous pouvez déconnecter votre agent IA à tout moment depuis ses paramètres.

Aucune donnée n’est stockée de manière permanente par le connecteur MCP ; il récupère uniquement les données lorsque vous effectuez une demande. La manière dont votre fournisseur d’IA (Anthropic, OpenAI ou Microsoft) traite les données partagées dans vos conversations dépend de vos paramètres et de votre accord avec ce fournisseur.

Connecteur MCP - Foire aux questions

Dans cette section, nous abordons les questions qui vous aideront à dépanner le connecteur MCP.

Puis-je voir quels agents IA peuvent être connectés dans Agorapulse ?

Les agents IA actuellement pris en charge peuvent être consultés dans Agorapulse en suivant ces étapes :

  1. Cliquez sur votre avatar et sélectionnez Paramètres personnels

  2. Choisissez le sous-menu Connecteurs

  3. Dans la section Agents IA pouvant agir sur votre compte, vous verrez les agents IA actuellement pris en charge par Agorapulse

  4. Cliquez sur Connecter sous l'agent IA concerné

  5. Sur la page suivante, vous verrez deux sections :

    • Configurez votre client MCP : dans cette section, vous pourrez copier l'URL du serveur MCP permettant de connecter votre agent IA au MCP d'Agorapulse

    • Essayez quelques prompts : copiez-collez ces prompts pour démarrer avec notre MCP

Pourquoi le connecteur n'affiche-t-il pas mes données ?

Si le connecteur MCP n'affiche pas vos données, assurez-vous que les conditions suivantes sont remplies :

  • Vous êtes connecté au bon compte Agorapulse.

  • Vous disposez des autorisations nécessaires dans Agorapulse pour accéder aux données que vous demandez.

  • Votre abonnement Agorapulse est actif

Pourquoi la connexion échoue-t-elle lors de l'autorisation ?

Si la connexion échoue lors de l'autorisation, essayez les étapes suivantes :

  • Videz le cache et les cookies de votre navigateur.

  • Assurez-vous d'utiliser un navigateur compatible (Chrome, Firefox, Safari ou Edge).

  • Vérifiez que les pop-ups ne sont pas bloqués pour claude.ai ou chatgpt.com.

  • Essayez de déconnecter puis de reconnecter l'intégration.

Que sont les erreurs « Permission refusée » ?

Si vous voyez des erreurs « Permission refusée », cela indique généralement que vous ne disposez pas du rôle approprié. Vérifiez auprès de votre Propriétaire ou gestionnaire de l'organisation Agorapulse pour vous assurer que vous disposez des autorisations appropriées.

Pourquoi est-ce que je reçois une erreur 502 lorsque j’utilise « get_labeled_post_performance » ?

Le point de terminaison get_labeled_post_performance nécessite le nom exact du label, et la période doit être clairement spécifiée sous la forme « Depuis → Jusqu'à ».
​
Exemple :
​Utilisez Agorapulse, get_labeled_post_performance pour :

Organisation : (nom de l'organisation)
Profil : numéro du profil de réseau social (le numéro du profil se trouve dans l'URL Agorapulse lorsque vous consultez vos rapports ou le nom du profil). Exemple : facebook_644340
Label : nom du label
Période : depuis **** jusqu'à ***** (ex. : depuis 2026-01-01 jusqu'au 2026-06-26)

Pourquoi mon agent IA me demande-t-il l’autorisation avant de lister mes organisations ou mes profils ?

Certains agents IA demandent une confirmation avant d’utiliser certains outils. Les outils qui listent vos organisations, espaces de travail, profils et groupes se contentent de lire les données et ne modifient jamais rien dans votre compte. Vous pouvez les approuver au cas par cas, ou les autoriser de façon permanente dans les paramètres de votre agent IA.

Existe-t-il une limite d’utilisation ?

Oui : jusqu’à 1 000 requêtes toutes les 30 minutes. Si vous atteignez cette limite d’utilisation, patientez quelques minutes avant de réessayer.

Avez-vous trouvé la réponse à votre question ?