Connectez votre compte vendeur Amazon à votre IA : Guide complet MCP

> ✨ **Rédaction assistée par IA, relecture éditoriale humaine par Avanta Global EOOD.** [En savoir plus](/disclosure)

![Connectez votre compte vendeur Amazon à votre assistant IA personnel](/blog/images/connect-amazon-seller-account-ai-assistant-mcp/hero.png)

La plupart des "outils IA" pour Amazon sont un chatbot greffé à un tableau de bord. Vous devez toujours vous connecter à leur application, lire leurs graphiques, et l'IA devine des chiffres qu'elle ne peut pas voir.

AgentXray fonctionne à l'inverse. Vous connectez votre compte vendeur Amazon une fois, et votre assistant IA **personnel** — Claude, ChatGPT, Cursor, celui que vous utilisez déjà — obtient un accès direct et authentifié à vos données Amazon mesurées. Vous posez vos questions avec vos propres mots, dans votre langue, depuis l'application que vous avez déjà ouverte. Et quand l'assistant veut modifier quelque chose dans votre compte, il ne peut pas : il peut seulement rédiger un brouillon, et c'est vous qui approuvez.

Ce guide détaille l'ensemble du processus, étape par étape : connecter le compte, connecter l'assistant, poser des questions, agir sur les réponses, et évaluer si l'action en valait la peine.

## Qu'est-ce que le MCP, en trente secondes

Le MCP (Model Context Protocol) est un standard ouvert pour connecter un assistant IA à un système externe — un ensemble d'outils que le modèle peut appeler, avec un schéma défini pour chacun. C'est le même mécanisme qui permet à Claude de lire un dépôt GitHub ou un dossier Google Drive.

AgentXray héberge un serveur MCP distant à l'adresse `https://agentxray.ai/api/mcp`. Il expose **19 outils** : 13 qui lisent vos données Amazon mesurées, et 6 qui rédigent des modifications pour votre approbation. Votre assistant les découvre automatiquement dès que la connexion est établie.

Pour un vendeur, voici ce que cela supprime :

- **Plus de copier-coller.** Vous n'exportez plus de rapport à coller dans une fenêtre de chat, où le modèle fait ensuite des calculs sur une feuille de calcul obsolète.
- **Plus de second tableau de bord.** La réponse arrive là où vous êtes déjà — y compris dans l'application mobile Claude, à voix haute.
- **Plus de chiffres inventés.** Chaque résultat indique sa provenance. Plus de détails ci-dessous, car c'est la partie qui a demandé le plus de travail.

## Étape 1 — Connectez votre compte vendeur Amazon

C'est la seule étape qui passe par Seller Central, et elle prend environ une minute.

1. Ouvrez AgentXray → **Paramètres → Connexion Amazon**.
2. **Choisissez votre marketplace principal.** Le sélecteur est organisé par région — Amérique du Nord, Europe, Extrême-Orient — car la région d'autorisation dépend de l'emplacement de votre compte, pas de votre marché principal.
3. Cliquez sur **Connecter un compte Amazon**. Vous êtes redirigé vers Amazon Seller Central pour autoriser AgentXray. Il s'agit de l'écran OAuth d'Amazon ; vos identifiants ne sont jamais saisis dans AgentXray.
4. Approuvez, et vous revenez à la page de connexion.

Ensuite, le compte commence à se remplir. AgentXray récupère six flux de données en arrière-plan et vous montre la progression de chacun : **commandes, règlements, inventaire, expéditions entrantes, fiches produits, santé du compte**. Les premières commandes apparaissent généralement en moins d'une minute ; l'historique des règlements prend plus de temps car il est plus volumineux.

Deux choses à savoir ici :

- Si un flux indique **"nécessite le rôle ... — reconnectez-vous pour l'octroyer"**, votre autorisation manque l'un des rôles SP-API dont dépend ce flux. Une reconnexion pour l'octroyer résout le problème ; rien d'autre n'est cassé.
- Vous pouvez **vous déconnecter à tout moment** depuis la même page. La déconnexion arrête la synchronisation ; une réautorisation la reprend.

## Étape 2 — Connectez votre assistant IA

Passons à la partie intéressante. Il existe quatre méthodes, selon l'assistant que vous utilisez. Toutes pointent vers le même endpoint.

### Claude Code (terminal)

Dans AgentXray, allez dans **Paramètres → Assistant IA → Créer un token**. Le panneau vous donne une commande d'une ligne avec le token déjà inclus — collez-la dans votre terminal :

```
claude mcp add --transport http agentxray https://agentxray.ai/api/mcp --header "Authorization: Bearer axr_..."
```

Le token n'est affiché **qu'une seule fois**. Le serveur ne renvoie jamais le secret, alors copiez-le pendant qu'il est à l'écran. Vous pouvez le révoquer depuis le même panneau quand vous le souhaitez, et en générer un nouveau.

### Claude Desktop et claude.ai

**Paramètres → Connecteurs → "Ajouter un connecteur personnalisé"**, et entrez `https://agentxray.ai/api/mcp`. Votre navigateur ouvre un écran de consentement AgentXray ; approuvez l'accès en lecture seule et vous êtes connecté. Pas de token à copier, pas de terminal. (Les connecteurs personnalisés nécessitent un abonnement payant Claude.)

Un connecteur ajouté sur claude.ai est aussi disponible dans **l'application mobile Claude** — cette étape unique configure aussi la possibilité de poser vos questions Amazon à voix haute, sur le chemin du travail.

### ChatGPT

Cela fonctionne même avec un compte ChatGPT **gratuit**, vérifié en direct : **Paramètres → Applications → Avancé → activer le mode Développeur**, puis **Paramètres → Connecteurs → Créer** avec `https://agentxray.ai/api/mcp` et OAuth. Le même écran de consentement AgentXray s'ouvre dans votre navigateur.

### Tout autre client MCP

Cursor et autres : endpoint HTTP streamable `https://agentxray.ai/api/mcp`, avec soit OAuth soit un token bearer dans l'en-tête `Authorization`.

### Vous voulez essayer avant de connecter quoi que ce soit ?

Il y a un **token de démonstration public** sur la [page des connecteurs](/fr/connect) qui lit un vendeur synthétique — trois produits, 90 jours d'historique, dont un qui perd discrètement de l'argent, un sans coût enregistré, un vieillissant en FBA. Pas besoin de compte, pas de connexion Amazon, aucun risque. C'est le moyen le plus rapide de voir à quoi ressemblent réellement les réponses.

![Fonctionnement de la connexion : Amazon Seller Central vers AgentXray vers votre assistant IA](/blog/images/connect-amazon-seller-account-ai-assistant-mcp/connection-flow.png)

## Étape 3 — Ce que vous pouvez maintenant demander

Une fois connecté, votre assistant peut appeler treize outils de lecture. Vous ne les nommez jamais ; vous posez simplement vos questions normalement et le modèle choisit. Groupés par type de réponse :

**Argent.** `get_profit_summary` — revenu réel, frais Amazon, COGS, bénéfice net et marge sur une période, groupés par devise. `get_profit_by_sku` — idem, classé par SKU, pour que "quel produit est réellement rentable" ait une réponse au lieu d'une intuition. `get_my_product_costs` — quels sont les coûts unitaires enregistrés, car un SKU sans coût sauvé est compté à coût zéro et son bénéfice est surestimé.

**Publicités.** `get_ads_overview`, `get_ads_campaigns`, `get_ads_targets`, `get_ads_search_terms` — dépense, ventes, clics, commandes, ACOS, ROAS, utilisation du budget, enchères actuelles, et quels termes de recherche sont déjà en négatif.

**Opérations.** `get_buybox_status` — taux de victoire, quels SKU perdent le Buy Box actuellement et de combien. `get_inventory_age` — comment le stock est réparti par tranche d'âge et ce qui dérive vers des frais de stockage à long terme. `list_my_marketplaces` — pour que l'assistant ne devine jamais un identifiant de marketplace.

**Jugement.** `daily_brief` — un court paragraphe, écrit pour être entendu plutôt que lu. `did_my_changes_work` — le résultat mesuré des changements que vous avez approuvés. `what_i_cannot_tell_you` — les limites honnêtes des données de votre propre compte, vérifiées en direct.

Questions réelles que les vendeurs posent dès le premier jour :

- "Comment s'est passée la journée ?"
- "Combien ai-je réellement gagné ces 30 derniers jours — et qu'est-ce qui *n'est pas* inclus dans ce chiffre ?"
- "Quel SKU est en train de perdre de l'argent actuellement ?"
- "Où est-ce que je perds le Buy Box, et de combien ?"
- "Est-ce que du stock FBA s'approche des frais de stockage à long terme ?"
- "À quel point puis-je faire confiance à ces chiffres ?"

Si vous ne savez pas quoi demander, pas besoin de formuler quoi que ce soit. Le serveur propose **des invites prédéfinies** qui apparaissent dans Claude Code sous forme de commandes slash — `weekly_profit_audit`, `losing_money`, `ad_waste_scan`, `inventory_risk`, `buybox_check`, `did_it_work`, `daily_brief`. La première question est un choix dans un menu.

## Ce qui rend les réponses utilisables : chaque chiffre cite sa source

Voici le point de défaillance de tous les produits IA-plus-tableau-de-bord : le modèle obtient un chiffre, perd la trace de sa provenance, et produit une phrase confiante qui est silencieusement fausse.

Chaque résultat de ce serveur est enveloppé dans une **enveloppe de provenance** avec trois champs :

- **`basis`** — le chemin des données d'où provient le chiffre. Pour le bénéfice, c'est *les événements de frais Amazon postés dans la fenêtre, joints à vos propres commandes, plus vos coûts produits enregistrés* — pas l'endpoint d'*estimation* des frais Amazon, connu pour sous-estimer (il exclut les taxes de consommation comme la GST australienne).
- **`gaps`** — ce qui manque actuellement, par rapport à votre compte.
- **`not_included`** — les éléments qu'un vendeur supposerait raisonnablement inclus dans le chiffre mais qui n'y sont pas.

C'est dans ce dernier que réside l'honnêteté. Quelques exemples livrés textuellement dans les résultats des outils :

- **Amazon poste les événements de frais environ 7,5 à 13 jours après l'achat.** Une fenêtre de bénéfice se terminant aujourd'hui sous-déclare les deux dernières semaines de ventes. Le bénéfice d'aujourd'hui n'existe pas en tant que chiffre mesuré, et le briefing quotidien le dit clairement au lieu de vous donner un chiffre.
- **Les dépenses publicitaires sont facturées séparément des règlements Amazon** et ne sont pas déduites dans les outils de bénéfice. Les rapports publicitaires et les chiffres de règlement sont des registres différents sur des horloges différentes ; ils ne se concilient pas ligne par ligne.
- **L'enchère affichée sur une cible est le plafond que vous avez fixé, pas le prix que vous payez par clic.**
- **Les montants ne sont jamais convertis entre devises.** Chaque devise est rapportée séparément.

L'assistant est instruit pour énoncer la base, répéter les lacunes textuellement, et ne jamais combler un trou avec une estimation. Si un chiffre manque, la réponse dit qu'il manque.

## Étape 4 — Quand l'assistant veut modifier quelque chose

La lecture est là où la plupart des outils s'arrêtent. C'est là qu'AgentXray commence à être une application opérationnelle.

Votre assistant peut rédiger six types de modification : une **mise à jour de fiche** (titre et puces), un **plan d'expédition FBA**, un **changement d'enchère**, des **mots-clés négatifs**, un **budget de campagne**, et **la mise en pause ou l'activation d'une campagne**.

Aucune ne touche Amazon. Chacune crée un brouillon dans le sas d'approbation d'AgentXray, et l'assistant est programmé pour vous le dire.

![Le sas d'approbation : l'assistant rédige, seule une session navigateur approuve](/blog/images/connect-amazon-seller-account-ai-assistant-mcp/approval-airlock.png)

### Deux clés, et l'assistant n'en détient qu'une

La séparation est structurelle, pas une politique que nous nous efforçons de suivre. **Un token de connecteur MCP peut créer des brouillons et rien d'autre.** L'approbation se fait uniquement dans le panneau AgentXray, avec une session navigateur. Un token de connecteur divulgué peut proposer tout ce qu'il veut sans rien changer.

L'accès en écriture est aussi opt-in par token : vous cochez une case quand vous le générez, et la case se réinitialise ensuite pour que le token suivant n'hérite pas silencieusement de la décision. L'écran de consentement OAuth n'offre jamais l'écriture du tout.

### Ce que le brouillon rapporte avec lui

Les brouillons sont filtrés avant de vous parvenir, et le filtre a deux niveaux de sévérité qui signifient des choses vraiment différentes :

- **Blocage** — Amazon refusera ceci. Une enchère hors plage autorisée, un budget à zéro, un titre de plus de 75 caractères. Un brouillon bloqué ne peut jamais être approuvé, car l'approbation ne pourrait qu'échouer.
- **Avertissement** — *vos propres chiffres* indiquent que ceci perd de l'argent. Toujours approuvable. Vous pourriez être en lancement, en liquidation de stock, ou en acquisition de part de marché pour des raisons que le logiciel ne peut pas voir, et bloquer serait nous substituer à une entreprise que nous ne gérons pas.

L'économie derrière l'avertissement est mesurée, pas modélisée : les propositions d'enchères sont évaluées contre les frais qu'Amazon a réellement déduits de *vos* lignes de règlement, donc ce qui revient est *votre* CPC seuil de rentabilité, pas un tarif standard. Un mot-clé négatif proposé sur une poignée de clics revient avec un avertissement que zéro commande sur quelques clics est ce à quoi ressemble un taux de conversion normal la plupart du temps. La mise en pause d'une campagne qui génère des commandes revient en indiquant la contribution que vous arrêteriez avec la dépense.

Et quand les chiffres ne peuvent pas être produits du tout — trop peu de commandes réglées, pas de coût unitaire enregistré pour le SKU — le brouillon le dit. Un changement non chiffré présenté comme sûr est exactement le défaut que ce système est conçu pour prévenir.

### Approbation

Ouvrez **Paramètres → Approbations**. Chaque brouillon montre ce qui change, ses risques, et son ancienneté. Deux boutons importent :

- **"Demander d'abord à Amazon"** envoie la charge utile exacte à travers l'aperçu de validation d'Amazon et retourne *le verdict même d'Amazon* — accepté ou rejeté — sans toucher à la fiche. Découvrir après coup qu'Amazon a refusé un changement coûte des heures de visibilité éligible aux publicités, donc ça vaut le clic.
- **"Approuver et envoyer à Amazon"** l'applique. La ligne passe à `applied` avec l'identifiant de soumission Amazon, ou à `failed` avec le vrai message d'erreur. Il n'y a pas d'état où le panneau dit approuvé alors que rien n'a été tenté.

Un brouillon vieux de plus de sept jours est marqué **obsolète** — l'économie qu'il contient était figée au moment de sa rédaction, et les taux de frais changent. C'est consultatif : vous pouvez l'appliquer quand même avec une confirmation supplémentaire.

Vous n'êtes pas censé vivre dans le panneau non plus. Quatre e-mails sont envoyés automatiquement : quand un brouillon est créé, une fois par jour pendant qu'il attend, au moment où il est appliqué ou échoue, et à nouveau quand le résultat est jugé.

## Étape 5 — Est-ce que ça a vraiment fonctionné ?

Deux semaines après l'application d'un changement, `did_my_changes_work` rapporte ce qui est arrivé à la conversion dans la quinzaine suivante, évalué par rapport à des fenêtres figées au moment où le changement a été appliqué.

Les verdicts sont délibérément conservateurs, et c'est une fonctionnalité, pas une limitation. À faible volume, **"inconclusif" est la réponse honnête** — et elle dit exactement pourquoi : trafic faible, variations normales jour à jour, ou un autre changement sur la même fiche dans la fenêtre. Un changement dont la fenêtre n'est pas encore fermée rapporte `measuring`, avec la date à laquelle il pourra être lu.

Il indique aussi son propre plafond : c'est ce qui s'est passé *en parallèle* du changement, pas une preuve que le changement l'a causé. Les publicités, concurrents, avis, promotions et saison ont tous bougé dans la même fenêtre. Et les changements que vous avez faits directement dans Seller Central lui sont invisibles, y compris ceux qui sont arrivés dans une fenêtre mesurée.

Quiconque vous promet une attribution causale propre sur une fiche à un seul SKU avec quelques ventes par jour vous vend un intervalle de confiance qu'il n'a pas calculé.

## Ce que ceci ne fait pas

- Il ne source pas de produits, ne scrape pas les concurrents, n'estime pas les ventes des autres. Il mesure **votre** compte. Si c'est ce que vous cherchez, notre [comparatif d'outils pour vendeurs UE](/fr/blog/best-amazon-fba-tools-eu-sellers-2026) est un meilleur point de départ.
- Il n'agit pas seul. Il n'y a pas de pilote automatique ; chaque changement attend un humain.
- Il ne convertit pas les devises, et n'invente pas un chiffre pour combler un trou.
- Sans coût unitaire enregistré pour un SKU, son bénéfice est surestimé du montant total du coût des marchandises — et `what_i_cannot_tell_you` vous dira quels SKU sont concernés, sans même demander.

## Pour commencer

1. [Essayez le connecteur de démonstration](/fr/connect) — pas besoin de compte, 60 secondes.
2. Connectez votre compte Amazon dans Paramètres → Connexion Amazon.
3. Générez un token dans Paramètres → Assistant IA, ou ajoutez le connecteur personnalisé dans Claude ou ChatGPT.
4. Demandez : *"À quel point puis-je faire confiance à ces chiffres ?"* C'est la première question la plus révélatrice que vous puissiez poser à n'importe quel outil Amazon, et celui-ci y répond avec une mesure au lieu d'une phrase marketing.

[Voir les tarifs →](/pricing)