Skip to content

MCP Epinium

Accès : Configuration → MCP

Le MCP Epinium permet à un assistant IA de consulter vos données Epinium directement, sans export ni développement. Vous pouvez lui demander en langage naturel quelles campagnes ont le pire ACOS ou sur quelles recherches part votre budget, et il répond avec vos chiffres réels.

Il repose sur le Model Context Protocol, un standard ouvert pour connecter des assistants à des sources de données. En interne il utilise l'API Epinium, il voit donc exactement les mêmes données et respecte les mêmes permissions.

Lecture seule

L'assistant peut consulter vos données, jamais les modifier. Il ne peut pas changer d'enchères, mettre en pause des campagnes ni éditer des produits.

L'adresse du serveur

https://mcp.epinium.com/mcp

Vous la trouverez aussi dans Configuration → MCP, avec un bouton pour la copier.

Comment le connecter

Il y a deux façons de donner accès à l'assistant, et celle qui s'applique dépend du client que vous utilisez :

  • Autorisation par navigateur : vous collez l'adresse du serveur, l'assistant vous amène sur Epinium, vous approuvez et c'est tout. Il n'y a aucune clé à copier, et vous pouvez retirer l'accès quand vous le souhaitez depuis Configuration → MCP.
  • API key : vous créez une clé dans Configuration → API Keys et vous la collez dans la configuration du client. C'est la voie pour Claude Code et pour vos propres intégrations.

Claude (web et application de bureau)

  1. Ouvrez les réglages de connecteurs de Claude et ajoutez un connecteur personnalisé
  2. Collez https://mcp.epinium.com/mcp comme adresse du serveur
  3. Claude vous amènera sur Epinium pour autoriser l'accès : vérifiez les permissions demandées et approuvez-les
  4. Vérifiez que cela fonctionne en lui demandant d'utiliser l'outil epinium_whoami

Les connecteurs personnalisés nécessitent un abonnement payant à Claude.

Claude Code

Claude Code se configure en ligne de commande et utilise une API key au lieu de l'autorisation par navigateur :

bash
claude mcp add --transport http epinium https://mcp.epinium.com/mcp \
  --header "Authorization: Bearer TU_API_KEY"

Remplacez TU_API_KEY par une clé créée dans Configuration → API Keys, avec les permissions que vous voulez accorder à l'assistant.

ChatGPT

Les connecteurs MCP de ChatGPT se trouvent dans le mode développeur (Réglages → Sécurité et connexion), et ils ne sont disponibles que sur les abonnements payants et depuis la version web.

  1. Activez le mode développeur dans Réglages → Sécurité et connexion
  2. Dans les réglages des connecteurs, ajoutez un nouveau connecteur
  3. Collez https://mcp.epinium.com/mcp comme adresse du serveur et laissez la méthode d'enregistrement telle quelle : le connecteur s'inscrit tout seul
  4. ChatGPT vous amènera sur Epinium pour autoriser l'accès : vérifiez les permissions demandées et approuvez-les
  5. Vérifiez que cela fonctionne en lui demandant d'utiliser l'outil epinium_whoami

Ce que vous avez connecté

Configuration → MCP liste les assistants que vous avez autorisés, avec quelles permissions, qui les a approuvés et quand. Vous pouvez y retirer l'accès à n'importe lequel : il ne peut plus consulter vos données immédiatement, et vous pourrez l'autoriser à nouveau plus tard si vous le voulez.

Les API keys se gèrent séparément, dans Configuration → API Keys.

Quels outils il inclut

L'assistant voit un outil par ressource atteinte par votre token. Les noms sont explicites, il suffit donc de demander ce que vous voulez en langage naturel.

GroupeOutilsPermission
CatalogueProduits, leurs vues Seller, Vendor et Advertising, marques, pays et clusterscatalog:read
Performance catalogueMétriques produit Seller et Vendorcatalog:read
Structure publicitaireCampagnes, ad groups, targets, product ads et termes de recherchecampaigns:read
Performance publicitaireMétriques des cinq niveaux ci-dessuscampaigns:read
AutomatisationVos workflows, leur configuration, les campagnes qu'ils atteignent et la performance de ces campagnesworkflows:read
Changements de l'automatisationCe qu'un workflow a changé sur une campagne, avec l'effet net par entitécampaigns:read
ConnexionsVos connexions Amazonconnections:read
TâchesTâches Epinium et leurs itemstasks:read
SkillsLe CMO Brain : les 101 skills marketing d’Epiniumskills:read
Compteepinium_whoami et la liste des comptes accessiblestoujours

Seuls apparaissent les outils que votre token peut utiliser. Si vous créez une clé avec uniquement campaigns:read, l'assistant ne verra ni les outils de catalogue ni ceux de tâches : ils n'échouent pas, ils n'existent simplement pas pour cette clé.

CMO Brain : le cerveau marketing d'Epinium

En plus de vos données, le MCP sert le CMO Brain : 101 skills avec les méthodes qu'appliquerait un CMO, écrites pour qu'un assistant puisse les lire et les suivre. Elles couvrent de la publicité et du SEO au pricing, à la rétention, au contenu ou aux marketplaces, et l'assistant les consulte avant de vous conseiller.

La différence se voit : sans elles, un assistant répond avec ce qu'il a pu lire sur Internet ; avec elles, il suit les mêmes critères que nous et les applique à vos chiffres. Demandez-lui d'examiner une campagne au mauvais ACOS et il n'improvise pas un conseil générique : il charge la skill qui convient et la suit.

Elles nécessitent la permission skills:read, cochée par défaut à la création d'une clé.

Lui demander ce qu'a fait votre automatisation

Avec la permission workflows:read, l'assistant peut auditer vos workflows, et c'est l'une des choses qu'il fait le mieux : ce sont des questions de croisement de données, celles qui prennent un après-midi à la main.

Vous pouvez lui demander trois choses différentes :

  • Comment un workflow est configuré — sa planification, son diagramme et chaque variable avec la valeur qu'elle porte réellement, en signalant celles que vous avez modifiées face à celles qui gardent la valeur du modèle. C'est la façon rapide de vérifier un réglage sans ouvrir l'éditeur.
  • Quelles campagnes il atteint réellement — ce qui n'est pas la même chose que les campagnes qui lui sont liées. Un workflow peut être planifié chaque nuit et n'en traiter aucune ; c'est la question qui le révèle, et quand l'ensemble revient vide l'assistant vous en donne la raison.
  • Ce qu'il a changé sur une campagne — l'enchère de départ de chaque target face à celle qu'il a maintenant, le nombre de fois où elle a bougé en chemin, et le motif du dernier changement.

Ce qui vaut vraiment le coup, c'est de le combiner avec les métriques de la même période : « qu'est-ce que le workflow a changé sur cette campagne ce mois-ci et comment a évolué l'ACOS ? » est une seule question, et l'assistant possède les deux moitiés. C'est là qu'il peut vous dire si les changements servent à quelque chose ou ne font que déplacer des enchères.

Deux choses à garder en tête en lisant sa réponse :

  • Les changements arrivent en net, pas en liste. Un target monté puis redescendu la même nuit apparaît comme aucun changement net, deux mouvements. C'est volontaire : une liste de décisions brute masque précisément cela.
  • Il ne voit jamais les simulations. Uniquement les changements qui ont réellement atteint Amazon, et seulement des 90 derniers jours, durée de leur conservation.

Tableaux interactifs

Quand vous lui demandez une liste — produits, campagnes, termes de recherche… — l'assistant peut l'afficher sous forme de tableau dans la conversation, au lieu de texte.

Avec ce tableau, vous pouvez :

  • Charger plus de lignes sans consommer de tours de l'assistant. Le tableau demande les pages suivantes tout seul : parcourir un catalogue long ne consomme pas de conversation.
  • Ouvrir une ligne pour voir son détail complet, y compris les champs qui ne tiennent pas dans le tableau.
  • Sélectionner plusieurs lignes et les transmettre à l'assistant avec le bouton Use N in chat. Ensuite il ne raisonne que sur celles-là : vous choisissez six produits sur deux cents et vous l'interrogez dessus, sans copier un seul ASIN.

Quelles données il atteint

Les mêmes que l'API, ressource par ressource. La liste complète des endpoints, avec ce que chacun renvoie, se trouve dans la section API.

Quatre choses à savoir quand vous lui demandez des données :

  • Les métriques ont besoin d'une plage de dates. Indiquez la période qui vous intéresse ; sinon l'assistant vous la demandera.
  • Vous pouvez demander l'évolution jour par jour, pas seulement le total de la période. Utile pour repérer des tendances plutôt qu'un seul chiffre agrégé.
  • Le plafond de la plage dépend de la granularité. Avec le total de la période, 366 jours ; jour par jour, 93. Sur les targets et les termes de recherche, les ressources les plus lourdes, cela descend à 93 et 31. Demander plus renvoie une erreur qui indique la limite exacte.
  • Une donnée vide n'est pas un zéro. Si l'assistant dit qu'une métrique est indisponible, c'est qu'Amazon ne la remonte pas pour ce format d'annonce, pas qu'elle vaut zéro.

Questions auxquelles il répond bien

  • Quelles campagnes ont le pire ACOS ce mois-ci ?
  • Sur quelles recherches je dépense sans aucune vente ?
  • Quels mots-clés fonctionnent le mieux et mériteraient de passer en correspondance exacte ?
  • Quels produits annoncés ne reçoivent pas une seule impression ?
  • Lesquels de mes produits ont du trafic mais ne convertissent pas ?
  • Qu'est-ce que le workflow a changé sur cette campagne le mois dernier, et est-ce que ça a servi à quelque chose ?
  • Quelles campagnes mon workflow atteint-il, et y en a-t-il une que je crois optimisée alors qu'il ne la touche jamais ?

Epinium Documentation