Connecter Adhook à des assistants IA (MCP)

Découvre comment connecter ton compte Adhook à Claude, Claude Code ou d'autres assistants IA via le serveur MCP. Tu apprendras aussi à utiliser dans tes posts des images et vidéos stockées sur ton ordinateur.

Qu'est-ce que le MCP Adhook ?

Le serveur MCP Adhook connecte des assistants IA comme Claude ou ChatGPT directement à ton compte Adhook. Dans le chat, tu peux ensuite notamment :

créer, planifier et modifier des posts sur les réseaux sociaux
configurer et piloter des boosts de posts et des campagnes publicitaires
gérer des thèmes, des tâches et des entrées de calendrier
répondre aux commentaires, messages et avis et les modérer
analyser le social listening et les posts d'influenceurs
consulter, créer et analyser des rapports
créer des rapports ad hoc (plus de 10 sources de données, plus de 100 segments, plus de 250 indicateurs)

Tu n'as pas besoin d'ouvrir l'interface Adhook pour cela.

MCP signifie Model Context Protocol. Il s'agit d'un standard ouvert qui permet aux assistants IA de communiquer avec des services externes.

Pour les administrateurs d'agence, il existe en plus le MCP Adhook Management pour l'onboarding de nouveaux clients. Il est décrit à la fin de cet article. Pour le travail quotidien, seul le MCP Adhook est nécessaire.

Prérequis

Un compte Adhook disposant des autorisations nécessaires
Un client qui prend en charge les connecteurs MCP distants, par exemple :
- Claude dans le navigateur
- Claude Desktop
- Claude Code
- ChatGPT
- un autre assistant IA compatible MCP

Installation et connexion

URL du serveur :

https://mcp.adhook.io/mcp

Lors de la première connexion, tu te connectes via OAuth avec tes identifiants Adhook. L'accès est limité à tes autorisations Adhook personnelles.

Ton mot de passe n'est pas transmis à l'assistant IA. Tu peux révoquer la connexion à tout moment dans Adhook ou dans l'assistant concerné.

Claude dans le navigateur ou Claude Desktop

Ouvre Paramètres → Connecteurs.
Choisis Ajouter un connecteur personnalisé.
Saisis l'URL suivante : https://mcp.adhook.io/mcp
Enregistre le connecteur.
Clique sur Connecter et connecte-toi avec ton compte Adhook.

Le connecteur Adhook apparaît ensuite avec les outils disponibles.

Claude Code dans le terminal

claude mcp add --transport http adhook https://mcp.adhook.io/mcp

Lors de la première utilisation, la page de connexion Adhook s'ouvre dans le navigateur.

Avec --scope user, tu peux rendre le connecteur disponible pour tous les projets de l'utilisateur :

claude mcp add --transport http --scope user adhook https://mcp.adhook.io/mcp

ChatGPT dans le navigateur

Ouvre Paramètres → Plugins → Avancé.
Active le mode développeur.
Choisis Créer un plugin.
Saisis l'URL suivante : https://mcp.adhook.io/mcp
Enregistre le plugin.
Clique sur Connecter et connecte-toi avec ton compte Adhook.

Le plugin Adhook est ensuite disponible dans ChatGPT avec les outils disponibles.

Autres assistants IA

Tout client prenant en charge les connecteurs MCP distants peut ajouter l'URL suivante comme connecteur personnalisé :

https://mcp.adhook.io/mcp

C'est par exemple aussi possible avec ChatGPT en mode développeur ou connecteur. Les étapes exactes varient selon le client.

Outils disponibles dans le MCP Adhook

L'assistant choisit lui-même les outils adaptés. Tu n'as pas besoin de connaître le nom des outils : décris simplement ce que tu veux obtenir. L'aperçu montre ce qui est possible.

Compte, marques et équipe

Outil	Fonction
`get_current_user`	Affiche l'utilisateur Adhook actuellement connecté.
`get_subtenants`	Liste tes marques.
`find_subtenant_by_name`	Trouve une marque à partir de son nom.
`get_users`	Liste les utilisateurs de ton compte avec leur nom et leur adresse e-mail.
`get_teams`	Liste les équipes, par exemple pour attribuer des messages ou des tâches à une équipe.
`get_tags`	Liste les tags disponibles, éventuellement filtrés par nom.

Posts

Outil	Fonction
`get_posts`	Liste ou recherche des posts. Il est notamment possible de filtrer par texte, statut, marque, période et canaux.
`get_post_by_id`	Récupère tous les détails d'un post.
`create_post`	Crée un post avec texte, canaux, images ou vidéos, date de publication, thèmes, tags et responsables. Des textes, médias et liens différents par canal sont possibles. Un boost peut être configuré directement en option.
`update_post`	Modifie un post existant, par exemple le texte, les canaux, la date, les médias ou le boost.
`update_post_tags`	Ajoute ou supprime des tags sur un ou plusieurs posts sans modifier les autres tags.
`submit_post`	Soumet un post pour validation ou l'active.
`delete_post`	Supprime un post. Uniquement possible pour les posts créés via le MCP.

Les canaux pris en charge sont notamment Facebook, Instagram, LinkedIn, TikTok, X, Pinterest, YouTube et Google Business Profile. Les canaux sans compte connecté pour la marque sont automatiquement désélectionnés.

Médias

Outil	Fonction
`upload_media`	Importe dans Adhook une image ou une vidéo accessible publiquement à partir de son URL.
`create_media_upload_url`	Crée une URL d'upload temporaire pour un fichier local. Utilisé par l'extension Local Media (voir ci-dessous).
`get_pinterest_boards`	Liste les tableaux Pinterest d'une marque. Nécessaire pour créer des posts Pinterest.

Campagnes publicitaires et boosts

Outil	Fonction
`get_campaigns`	Liste ou recherche des campagnes publicitaires.
`get_campaign_by_id`	Récupère tous les détails d'une campagne, y compris les groupes d'annonces, le budget, les placements et les créations.
`create_campaign`	Crée une campagne publicitaire avec créations, ciblage, budget, durée et canaux, par exemple Meta, LinkedIn, Google Ads, TikTok et Pinterest. Un budget global est réparti entre les canaux choisis.
`update_campaign`	Modifie une campagne existante, par exemple le nom, la durée, les créations, le ciblage, le budget, les canaux ou les thèmes.
`submit_campaign`	Vérifie une campagne et la soumet pour validation ou l'active, selon le processus de validation configuré.
`change_campaign_status`	Met en pause, réactive ou termine une campagne.
`update_campaign_tags`	Ajoute ou supprime des tags sur une ou plusieurs campagnes.
`delete_campaign`	Supprime une campagne dans Adhook. Elle n'est supprimée également sur les plateformes publicitaires que sur demande explicite.
`get_targeting_templates`	Liste les modèles de ciblage actifs d'une marque. Le modèle est utilisé pour les boosts via `create_post` ou `update_post`.

Un boost se configure directement lors de la création ou de la mise à jour d'un post. Tu peux notamment définir le budget, le canal, la durée, les placements et le modèle de ciblage.

Thèmes, tâches et calendrier

Outil	Fonction
`get_topics`, `get_topic_by_id`	Liste les thèmes ou récupère les détails d'un thème.
`create_topic`, `update_topic`	Crée ou modifie un thème pour la planification éditoriale.
`delete_topic`	Supprime un thème. Le lien avec les posts, campagnes et entrées de calendrier est supprimé et les tâches liées sont supprimées.
`get_tasks`, `get_task_by_id`	Recherche des tâches par texte, thème, responsable, statut, marque ou échéance, ou récupère une tâche.
`create_task`, `update_task`	Crée une tâche ou la modifie, la reporte, l'attribue ou la termine.
`delete_task`	Supprime une tâche.
`get_custom_events`, `get_custom_event_by_id`	Liste tes propres entrées de calendrier comme les newsletters, campagnes print, communiqués de presse ou événements, ou récupère une entrée.
`create_custom_event`, `update_custom_event`	Crée ou modifie une entrée de calendrier avec date, type, description, thèmes, budget et responsable. Rien n'est envoyé ni publié.
`delete_custom_event`	Supprime une entrée de calendrier.

Community management

Outil	Fonction
`get_threads`, `get_thread_by_id`	Liste les conversations de la boîte de réception ou récupère une conversation.
`update_thread`, `assign_thread`	Modifie le statut, les tags ou le marquage d'une conversation, ou l'attribue à une personne ou à une équipe.
`get_messages`, `get_message_by_id`	Liste les commentaires, messages, mentions et avis, ou récupère un message.
`get_message_post_details`	Affiche le post d'origine auquel appartient un commentaire.
`get_moderation_activity`	Affiche l'historique et les notes internes d'une conversation ou d'un message.
`update_message_status`, `assign_message`	Définit le statut d'un message (ouvert, en cours, terminé) ou l'attribue.
`update_message`, `update_message_tags`	Modifie les tags, le marquage ou la tonalité d'un ou de plusieurs messages.
`reply_message`	Répond directement sur la plateforme à un commentaire, un message ou une mention.
`add_discussion_note`	Ajoute une note interne, avec notification facultative des membres de l'équipe ou par e-mail.
`moderate_message_action`	Aime, masque, affiche à nouveau ou supprime un commentaire sur la plateforme. Les actions possibles dépendent du réseau. Par exemple, les commentaires de tiers ne peuvent pas être supprimés sur TikTok.

Social listening

Outil	Fonction
`get_social_listening_items`	Récupère les contenus de social listening avec leurs indicateurs d'engagement : posts de profils suivis (par exemple des concurrents), résultats de hashtags et de mots-clés, actualités, sites web, mentions, commentaires et avis. Utile aussi pour trouver des idées de contenu en comparaison avec tes propres posts.

Influenceurs

Outil	Fonction
`get_influencers`, `get_influencer_by_id`	Liste les influenceurs ou récupère un profil avec comptes de réseaux sociaux, nombre d'abonnés, marques et tags.
`get_influencer_posts`	Liste les posts d'influenceurs enregistrés.
`get_influencer_results`	Affiche les résultats cumulés d'un influenceur sur une période, par exemple posts, engagement, vues et portée.
`log_influencer_post_by_url`	Enregistre un post ou un reel Instagram à partir de son URL. La date, la légende et les indicateurs publics sont chargés automatiquement. Un compte professionnel ou créateur public est nécessaire.
`create_influencer_post`	Enregistre manuellement un post d'influenceur avec date, canal et indicateurs, par exemple pour d'autres canaux qu'Instagram.

Reporting

Outil	Fonction
`get_reports`, `get_report_by_id`	Liste les rapports existants ou récupère les paramètres d'un rapport.
`create_report`, `update_report`	Crée un nouveau rapport ou modifie le nom, la période, le périmètre des données, les filtres et la mise en forme.
`delete_report`	Supprime un rapport.
`get_report_widgets`	Liste les widgets et indicateurs d'un rapport.
`get_report_widget_data`	Récupère les données d'un widget.
`create_report_widget`, `update_report_widget`	Ajoute à un rapport des graphiques, tableaux, synthèses de KPI, textes, images ou sauts de page, ou les modifie, y compris source de données, indicateurs, segments, filtres et tri.
`delete_report_widget`	Retire un widget d'un rapport.
`run_headless_report`	Exécute une analyse ad hoc sur une période sans enregistrer de rapport. Accède à plus de 10 sources de données, plus de 100 segments et plus de 250 indicateurs, par exemple publicités payantes, posts organiques, web analytics, community management, newsletters et SEO.

Exemples de demandes

« Montre-moi tous les posts planifiés de la marque Exemple SA pour la semaine prochaine. »
« Crée pour Exemple SA un post LinkedIn et Instagram pour vendredi prochain à 10h00. »
« Utilise pour le post le texte suivant et les images produit-1.jpg et produit-2.jpg. »
« Booste ce post avec 150 CHF sur sept jours. Utilise l'objectif Engagement et le modèle de ciblage DACH Large. »
« Quels commentaires d'hier sont encore sans réponse ? Propose-moi des réponses. »
« Quels rapports existent pour Exemple SA ? »
« Comment la portée de la marque a-t-elle évolué le mois dernier ? »
« Montre-moi le trafic du site web provenant de l'e-mail, ventilé par campagne. »

Utiliser des images et vidéos locales

Un connecteur distant comme le MCP Adhook ne peut pas accéder directement aux fichiers de ton ordinateur. Une image glissée dans le chat n'est pas non plus transmise au MCP Adhook par l'assistant IA.

Pour les fichiers disponibles uniquement en local, une extension supplémentaire est donc disponible. Elle s'exécute sur ton ordinateur et charge le fichier choisi dans Adhook.

Important : cette fonction est disponible uniquement avec Claude Desktop et Claude Code. Elle ne fonctionne pas dans claude.ai dans le navigateur ni dans d'autres clients purement web. Dans ce cas, utilise des URL accessibles publiquement pour les médias de tes posts, ou charge d'abord les fichiers dans la Media Library d'Adhook et utilise les URL des médias.

1. Actualiser le connecteur Adhook

Pour que l'outil create_media_upload_url soit disponible pour l'assistant, déconnecte le connecteur Adhook une fois, puis reconnecte-le.

Tu peux aussi redémarrer Claude Desktop.

2. Créer un dossier média

Crée un dossier dans lequel l'assistant est autorisé à utiliser des fichiers.

Exemples :

macOS : ~/AdhookMedia
Windows : C:\Users\<Nom>\AdhookMedia

3. Installer l'extension

Claude Desktop

Télécharge l'extension : https://media.adhook.io/adhook-local-media-0.1.0.mcpb
Ouvre le fichier téléchargé par double-clic. Claude Desktop affiche ensuite la boîte de dialogue d'installation.
Si rien ne se passe, ouvre dans Claude Desktop Settings → Extensions → Install Extension et sélectionne le fichier téléchargé.
Dans le champ Media folder, sélectionne le dossier créé à l'étape 2.
Confirme si nécessaire l'avertissement indiquant que l'extension n'est pas vérifiée.
Termine l'installation. Adhook Local Media Upload apparaît ensuite comme extension active sous Settings → Extensions.

Il n'est pas nécessaire d'installer séparément Node.js ou un environnement d'exécution similaire. Tous les éléments nécessaires sont inclus dans le paquet.

Claude Code

Exécute la commande suivante dans le terminal :

claude mcp add adhook-media --scope user \   --env ADHOOK_MEDIA_DIR="$HOME/AdhookMedia" \   -- npx -y @adhookio/local-media-mcp

Node.js 18 ou une version plus récente est nécessaire.

4. Utiliser des médias locaux

Place l'image ou la vidéo directement dans le dossier média configuré.

Demande par exemple à l'assistant :

« Quelles images se trouvent dans le dossier média ? »

Crée ensuite le post :

« Crée un post Adhook avec produit.jpg et le texte suivant : … »

L'assistant charge automatiquement le fichier et l'ajoute au post.

Bon à savoir

Le fichier doit se trouver directement dans le dossier média partagé.
Les fichiers situés dans des sous-dossiers ne sont pas pris en compte.
Indique le nom exact du fichier dans ta demande.
Une image glissée dans la fenêtre de chat n'est pas automatiquement utilisée via l'extension.
La taille maximale des fichiers est de 100 Mo.
Pour mettre à jour l'extension, installe la nouvelle version .mcpb de la même manière. Elle remplace la version précédente.

Dépannage

Problème	Solution
L'assistant ne trouve aucun outil Adhook	Vérifie la connexion du connecteur et reconnecte le connecteur Adhook. Redémarre Claude Desktop si nécessaire.
`create_media_upload_url` est absent	Déconnecte le connecteur Adhook et reconnecte-le.
L'extension Local Media affiche « not running »	Redémarre Claude Desktop.
L'upload échoue	Vérifie dans les paramètres de l'extension que le chemin du dossier média est correct.
Les images ou vidéos sont introuvables	Vérifie que les fichiers se trouvent directement dans le dossier média et non dans un sous-dossier.
Un post ne peut pas être supprimé	Via le MCP, seuls les posts créés auparavant via le MCP peuvent être supprimés.

Sécurité et protection des données

La connexion s'effectue via OAuth avec tes identifiants Adhook. Ton mot de passe n'est pas transmis à l'assistant.
L'assistant ne peut accéder qu'aux données et actions pour lesquelles ton utilisateur Adhook dispose d'autorisations.
L'extension Local Media s'exécute exclusivement en local.
L'extension ne peut accéder qu'aux fichiers du dossier que tu as choisi.
Tu peux révoquer la connexion à tout moment dans l'assistant ou dans tes paramètres Adhook.

Pour les administrateurs d'agence : MCP Adhook Management

Cette section ne concerne que les personnes qui configurent de nouveaux clients et comptes publicitaires pour leur agence. Pour le travail quotidien avec les posts, campagnes et rapports, le MCP Adhook suffit.

Le MCP Management est un serveur distinct que tu connectes comme second connecteur. Il te permet de réaliser l'onboarding d'un nouveau client dans le chat : créer la marque, créer un compte publicitaire, demander l'accès à la page Facebook du client, définir les autorisations des utilisateurs dans le Meta Business Manager et tout attribuer à la marque.

Certaines actions, comme la création de marques et de comptes publicitaires, sont réservées aux administrateurs. Les comptes publicitaires ne peuvent pas être supprimés via l'API. L'assistant te demande donc une confirmation avant ces étapes, par exemple pour le nom, la devise et le fuseau horaire d'un nouveau compte publicitaire.

Connexion

Ajoute un second connecteur comme décrit plus haut sous Installation et connexion, mais avec cette URL :

https://mcp.adhook.io/mcp/management

Donne au connecteur un nom distinct, par exemple Adhook Management. Dans Claude Code :

claude mcp add --transport http --scope user adhook-management https://mcp.adhook.io/mcp/management

Déroulement type de l'onboarding Meta

Identifier la page Facebook du client à partir de son URL.
Vérifier si ton Business Manager a déjà accès à la page et, si ce n'est pas le cas, demander l'accès au client.
Attendre que le client ait accepté la demande, puis attribuer la page à des personnes de ton Business Manager.
Créer la marque dans Adhook.
Créer un compte publicitaire Meta et l'attribuer à la marque. La page du client est enregistrée comme annonceur.
Attribuer d'autres personnes au compte publicitaire.
Attribuer la page Facebook et le compte Instagram à la marque et vérifier le résultat.

Tu peux aussi simplement demander à l'assistant : « Configure le nouveau client Exemple SA avec la page Facebook facebook.com/exemplesa. » Il te guidera alors à travers ces étapes.

Marques

Outil	Fonction
`get_subtenants`, `find_subtenant_by_name`	Liste tes marques ou trouve une marque à partir de son nom.
`get_subtenant_by_id`	Affiche tous les paramètres d'une marque, y compris les comptes de canaux attribués.
`create_subtenant`	Crée une nouvelle marque, filiale ou un nouveau client. Réservé aux administrateurs.
`update_subtenant`	Modifie les paramètres généraux d'une marque, par exemple le nom, la marque parente, le site web, les langues, le responsable, le statut, les autorisations pour les posts et la publicité ainsi que le bénéficiaire et le payeur des publicités Meta.
`assign_meta_assets_to_subtenant`	Attribue un compte publicitaire Meta, une page Facebook et un compte Instagram à une marque.

Meta (Facebook et Instagram)

Outil	Fonction
`get_meta_ad_accounts`	Liste les comptes publicitaires Meta connectés dans Adhook.
`sync_meta_ad_accounts`	Importe les comptes publicitaires auxquels tu as obtenu l'accès depuis la connexion de Facebook, par exemple des comptes créés manuellement dans le Business Manager.
`create_meta_ad_account`	Crée un nouveau compte publicitaire Meta dans le Business Manager de ton agence et l'attribue éventuellement à une marque. Réservé aux administrateurs.
`get_facebook_pages`	Liste les pages Facebook auxquelles l'utilisateur Facebook connecté a accès.
`resolve_facebook_page`	Identifie l'ID et le nom d'une page Facebook à partir de son URL, de son nom d'utilisateur ou de son ID.
`get_facebook_page_access_status`	Indique si ton Business Manager a accès à une page et où en sont les demandes d'accès en cours.
`request_facebook_page_access`	Demande au client un accès agence à sa page Facebook afin de pouvoir diffuser des publicités en son nom.
`get_meta_business_users`	Liste les personnes et utilisateurs système du Business Manager de ton agence.
`assign_user_to_facebook_page`, `remove_user_from_facebook_page`	Attribue une page Facebook à une personne de ton Business Manager avec des tâches précises (par exemple diffuser des publicités et consulter les statistiques), modifie les tâches ou retire la personne.
`get_meta_ad_account_users`	Liste les personnes attribuées à un compte publicitaire, avec leurs tâches.
`assign_user_to_meta_ad_account`, `remove_user_from_meta_ad_account`	Attribue un compte publicitaire à une personne avec un rôle, modifie le rôle ou retire la personne.

Outil	Fonction
`get_linkedin_ad_accounts`	Liste les comptes publicitaires LinkedIn connectés dans Adhook.
`get_linkedin_pages`	Liste les pages entreprise LinkedIn gérées par le compte LinkedIn connecté.
`create_linkedin_ad_account`	Crée un nouveau compte publicitaire LinkedIn pour une page entreprise. La devise ne peut plus être modifiée ensuite et tu dois ajouter un moyen de paiement dans LinkedIn. Réservé aux administrateurs.
`sync_linkedin_ad_accounts`	Importe les comptes publicitaires LinkedIn auxquels tu as obtenu l'accès depuis la connexion de LinkedIn.

Utilisateurs

Outil	Fonction
`get_current_user`	Affiche l'utilisateur Adhook actuellement connecté.
`get_users`	Liste les utilisateurs de ton compte, par exemple pour définir le responsable d'une marque.

Exemples de demandes

« Crée la marque Exemple SA et un compte publicitaire Meta en CHF. »
« Demande l'accès à la page Facebook facebook.com/exemplesa. »
« Qui dans notre Business Manager a accès au compte publicitaire d'Exemple SA ? »

Bon à savoir

Si des outils comme create_subtenant sont absents, le connecteur Management n'est pas connecté.
Seuls les administrateurs peuvent créer des marques et des comptes publicitaires.
Si un compte publicitaire existant est introuvable, demande à l'assistant de synchroniser les comptes publicitaires Meta ou LinkedIn.
L'assistant n'exécute les actions ayant une portée importante, comme la création de comptes publicitaires ou la modification des autorisations, qu'après ta confirmation.