Koppel je Amazon-verkopersaccount aan je eigen AI: de complete MCP-gids

✨ AI-ondersteund schrijven, menselijke redactionele controle door Avanta Global EOOD. Meer informatie

De meeste Amazon-"AI-tools" zijn een chatvenster vastgeplakt aan een dashboard. Je moet nog steeds inloggen op hun app, hun grafieken lezen, en de AI blijft gissen naar cijfers die het niet kan zien.

AgentXray werkt precies andersom. Je verbindt je Amazon-verkopersaccount één keer, en dan krijgt je eigen AI-assistent — Claude, ChatGPT, Cursor, wat je ook al betaalt — een directe, geauthenticeerde verbinding met je gemeten Amazon-cijfers. Je stelt vragen in je eigen woorden, in je eigen taal, in de app die je al open hebt staan. En wanneer de assistent iets in je account wil aanpassen, kan dat niet: het kan alleen concepten maken, en jij keurt goed.

Deze handleiding loopt het hele pad af, in volgorde: account verbinden, assistent koppelen, vragen stellen, actie ondernemen op antwoorden, en meten of de actie zijn waarde bewees.

Wat MCP is, in dertig seconden

MCP (Model Context Protocol) is een open standaard voor het verbinden van een AI-assistent met een extern systeem — een set tools die het model kan aanroepen, met een gedefinieerd schema voor elke tool. Het is hetzelfde mechanisme dat Claude een GitHub-repository of Google Drive-map laat lezen.

AgentXray host een externe MCP-server op https://agentxray.ai/api/mcp. Het biedt twee soorten tools: leestools die je gemeten Amazon-cijfers ophalen, en concepttools die wijzigingen opstellen voor je goedkeuring — de actuele lijst staat op de connectorpagina. Je assistent ontdekt ze automatisch zodra de verbinding tot stand komt.

Wat voor een verkoper telt is wat dit wegneemt:

• Geen kopieer-plakwerk. Je exporteert geen rapport om het in een chatvenster te plakken, waar het model dan rekenwerk doet op een verouderde spreadsheet.
• Geen tweede dashboard. Het antwoord arriveert waar je al bent — inclusief de Claude mobiele app, hardop.
• Geen verzonnen cijfers. Elk resultaat vermeldt waar het vandaan komt. Meer daarover verderop, want dat is het deel waar het meeste werk in zat.

Stap 1 — Verbind je Amazon-verkopersaccount

Dit is de enige stap die Seller Central aanraakt, en het duurt ongeveer een minuut.

1. Open AgentXray → Instellingen → Amazon-verbinding.
2. Kies je primaire marketplace. De keuzelijst is gegroepeerd per regio — Noord-Amerika, Europa, Verre Oosten — omdat de autorisatieregio bepaald wordt door waar je account thuishoort, niet door waar je het meest verkoopt.
3. Klik op Amazon-account verbinden. Je wordt doorgestuurd naar Amazon Seller Central om AgentXray te autoriseren. Dit is Amazon's eigen OAuth-scherm; je inloggegevens worden nooit in AgentXray ingetypt.
4. Keur goed, en je landt terug op de verbindingspagina.

Dan begint het account zich te vullen. AgentXray haalt zes datastromen op de achtergrond binnen en toont je de voortgang van elk: orders, afrekeningen, voorraad, inkomende zendingen, productaanbiedingen, accountgezondheid. De eerste orders verschijnen meestal binnen een minuut; afrekeningsgeschiedenis duurt langer omdat er meer van is.

Twee dingen om te weten:

• Als een stroom meldt "heeft de ... rol nodig — verbind opnieuw om het toe te kennen", ontbreekt er een van de SP-API-rollen waar die stroom van afhangt. Opnieuw verbinden en toekennen lost het op; verder is er niets kapot.
• Je kunt op elk moment de verbinding verbreken vanaf dezelfde pagina. Verbreken stopt de synchronisatie; opnieuw autoriseren hervat het.

Stap 2 — Verbind je AI-assistent

Nu het interessante deel. Er zijn vier manieren, afhankelijk van welke assistent je gebruikt. Ze wijzen allemaal naar hetzelfde eindpunt.

Claude Code (terminal)

Ga in AgentXray naar Instellingen → AI-assistent → Token aanmaken. Het paneel geeft je een éénregelige opdracht met het token er al in — plak het in je terminal:

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

Het token wordt één keer getoond. De server geeft het geheim nooit meer terug, dus kopieer het terwijl het op het scherm staat. Je kunt het intrekken vanuit hetzelfde paneel wanneer je wilt, en een nieuwe aanmaken.

Claude Desktop en claude.ai

Open in Claude Customize in het linkermenu, ga naar het tabblad Connectors, klik rechtsboven op Add en kies "Add custom connector"; voer daarna https://agentxray.ai/api/mcp in. Je browser opent een AgentXray-toestemmingsscherm; keur alleen-lezen toegang goed en je bent verbonden. Geen token om te kopiëren, geen terminal. (Volgens Anthropics eigen documentatie vereisen aangepaste connectors een betaald Claude-abonnement.) De stappen in detail staan op onze Claude-installatiepagina.

Een connector die op claude.ai is toegevoegd, is ook beschikbaar in de Claude mobiele app — dus deze ene stap is ook de setup om je Amazon-vragen hardop te stellen, onderweg naar werk.

ChatGPT

Dit werkt zelfs op een gratis ChatGPT-account, live geverifieerd: open Instellingen → Apps en schakel de ontwikkelaarsmodus in (een eigen regel binnen Apps, met een label voor hoog risico); maak daarna de connector aan met de + rechtsboven in de lijst met apps, met https://agentxray.ai/api/mcp en OAuth. Hetzelfde AgentXray-toestemmingsscherm opent in je browser. De stappen in detail staan op onze ChatGPT-installatiepagina.

Elke andere MCP-client

Cursor en soortgenoten: Stroombaar HTTP-eindpunt https://agentxray.ai/api/mcp, met ofwel OAuth of een bearer-token in de Authorization-header.

Wil je het eerst proberen zonder iets te verbinden?

Er is een publiek demo-token op de connectorpagina dat een synthetische demo-verkoper leest — drie producten, 90 dagen geschiedenis, eentje verliest stilletjes geld, eentje zonder geregistreerde kosten, eentje verouderend in FBA. Geen account, geen Amazon-verbinding, geen risico. Het is de snelste manier om te zien hoe de antwoorden er echt uitzien.

Stap 3 — Wat je nu kunt vragen

Eenmaal verbonden kan je assistent de leestools aanroepen. Je noemt ze nooit; je stelt gewoon normaal vragen en het model kiest. Een deel ervan, gegroepeerd op wat ze beantwoorden (de volledige, actuele lijst staat op de connectorpagina):

Geld. get_profit_summary — echte omzet, Amazon-vergoedingen, COGS, nettowinst en marge over een periode, gegroepeerd per valuta. get_profit_by_sku — hetzelfde, gerangschikt per SKU, zodat "welk product levert eigenlijk geld op" een antwoord heeft in plaats van een gevoel. get_my_product_costs — welke eenheidskosten geregistreerd staan, want een SKU zonder opgeslagen kosten wordt geteld op nul kosten en zijn winst is een overschatting.

Advertenties. get_ads_overview, get_ads_campaigns, get_ads_targets, get_ads_search_terms — uitgaven, verkopen, klikken, orders, ACoS, ROAS, budgetbenutting, huidige biedingen, en welke zoektermen al genegeerd zijn.

Operaties. get_buybox_status — winpercentage, welke SKU's nu de Buy Box verliezen en met hoeveel. get_inventory_age — hoe voorraad verdeeld is over leeftijdsbakken en wat richting langetermijnopslagkosten drijft. list_my_marketplaces — zodat de assistent nooit een marketplace-id raadt.

Beoordeling. daily_brief — één korte alinea, geschreven om gehoord te worden in plaats van gelezen. did_my_changes_work — het gemeten resultaat van wijzigingen die je goedkeurde. what_i_cannot_tell_you — de eerlijke beperkingen van je eigen accountgegevens, live gecontroleerd.

Echte vragen die verkopers op dag één stellen:

• "Hoe ging het vandaag?"
• "Wat heb ik de afgelopen 30 dagen echt verdiend — en wat zit niet in dat getal?"
• "Welke van mijn SKU's verliest nu geld?"
• "Waar verlies ik de Buy Box, en met hoeveel?"
• "Zit er FBA-voorraad aan te komen die richting langetermijnopslagkosten gaat?"
• "Hoeveel vertrouwen mag ik in deze cijfers stellen?"

Als je niet weet wat je moet vragen, hoef je niets te bedenken. De server levert kant-en-klare prompts die in Claude Code verschijnen als slash-commands — weekly_profit_audit, losing_money, ad_waste_scan, inventory_risk, buybox_check, did_it_work, daily_brief. De eerste vraag is een menukeuze.

Het deel dat de antwoorden bruikbaar maakt: elk getal noemt zijn bron

Dit is het faalmechanisme van elk AI-plus-dashboardproduct: het model krijgt een getal, verliest bij waar het vandaan kwam, en produceert een vol vertrouwen zin die stilletjes fout is.

Elk resultaat van deze server is verpakt in een herkomstenvelop met drie velden:

• basis — het gegevenspad waar het getal uit kwam. Voor winst is dat Amazon-vergoedinggebeurtenissen die binnen het venster geboekt werden, gekoppeld aan je eigen orders, plus je opgeslagen productkosten — niet Amazon's vergoeding-schatting-eindpunt, waarvan bekend is dat het te laag uitvalt (het sluit verbruiksbelasting zoals AU GST uit).
• gaps — wat er nu ontbreekt, gemeten tegen je account.
• not_included — de dingen die een verkoper redelijkerwijs zou aannemen dat in het getal zitten, maar niet zo zijn.

Dat laatste is waar de eerlijkheid leeft. Een paar voorbeelden die letterlijk in de toolresultaten zitten:

• Amazon boekt vergoedingsgebeurtenissen ongeveer 7,5–13 dagen na aankoop. Een winstvenster dat vandaag eindigt, rapporteert de laatste twee weken verkopen te laag. De winst van vandaag bestaat niet als gemeten getal, en de daily brief zegt dat hardop in plaats van je een cijfer te geven.
• Advertentie-uitgaven worden apart van Amazon-afrekeningen gefactureerd en worden niet afgetrokken van de winsttools. Advertentierapportage en afrekeningscijfers zijn verschillende grootboeken op verschillende klokken; ze zullen niet regel voor regel overeenkomen.
• Het bod dat op een doel getoond wordt, is het maximum dat je instelde, niet de prijs die je per klik betaalde.
• Bedragen worden nooit tussen valuta's omgerekend. Elke valuta wordt apart gerapporteerd.

De assistent krijgt de instructie om de basis te vermelden, de gaps letterlijk te herhalen, en nooit een gat met een schatting te vullen. Als een getal ontbreekt, zegt het antwoord dat het ontbreekt.

Stap 4 — Wanneer de assistent iets wil wijzigen

Lezen is waar de meeste tools stoppen. Hier begint AgentXray een operations-app te zijn.

Je assistent kan wijzigingen opstellen zoals een productaanbiedingsupdate (titel en bullets), een prijswijziging, een FBA-zendingsplan, een bodwijziging, negatieve zoekwoorden, een campagnebudget, en campagnes pauzeren of inschakelen — de volledige, actuele lijst van concepttools staat op de connectorpagina.

Geen ervan raakt Amazon. Elk maakt een concept in AgentXray's goedkeuringsluchtsluis, en de assistent krijgt te horen dat te melden.

Twee sleutels, en de assistent heeft er maar één

De scheiding is structureel, geen beleid dat we proberen te volgen. Een MCP-connectortoken kan concepten maken en verder niets. Goedkeuring gebeurt alleen in het AgentXray-paneel, met een browsersessie. Een uitgelekt connectortoken kan voorstellen wat het wil en verandert niets.

Schrijftoegang is ook opt-in per token: je vinkt een vakje aan wanneer je het aanmaakt, en het vakje reset daarna zodat het volgende token niet stilletjes de beslissing erft. Het OAuth-toestemmingsscherm biedt schrijven überhaupt niet aan.

Wat het concept terugbrengt

Concepten worden gescreend voordat ze bij je komen, en het scherm heeft twee ernstniveaus die echt verschillen:

• Blokkeren — Amazon zal dit weigeren. Een bod buiten het toegestane bereik, een budget van nul, een titel langer dan 75 tekens. Een geblokkeerd concept kan nooit goedgekeurd worden, want goedkeuren zou alleen kunnen mislukken.
• Waarschuwen — je eigen cijfers zeggen dat dit geld verliest. Nog steeds goed te keuren. Misschien ben je aan het lanceren, voorraad aan het opruimen, of marktaandeel aan het kopen om redenen die de software niet kan zien, en blokkeren zou ons zijn die een bedrijf overrulen dat we niet runnen.

De economie achter de waarschuwing is gemeten, niet gemodelleerd: bodvoorstellen worden geprijsd tegen de vergoedingen die Amazon daadwerkelijk van jouw afrekeningsregels aftrok, dus wat terugkomt is jouw break-even CPC, niet een tarievenkaart. Een negatief zoekwoord voorgesteld op een handvol klikken komt terug met de waarschuwing dat nul orders op enkele klikken is hoe een normale conversieratio er meestal uitziet. Een campagne pauzeren die orders produceert, komt terug met de bijdrage die je zou stoppen samen met de uitgaven.

En wanneer de cijfers helemaal niet geproduceerd kunnen worden — te weinig afgerekende orders, geen eenheidskosten opgeslagen voor de SKU — zegt het concept dat. Een ongeprijsde wijziging presenteren als veilig is precies het defect waar dit systeem voor gebouwd is.

Goedkeuren

Open Instellingen → Goedkeuringen. Elk concept toont wat er verandert, de risico's, en hoe oud het is. Twee knoppen tellen:

• "Eerst aan Amazon vragen" stuurt de exacte payload door Amazon's validatievoorbeeld en geeft Amazon's eigen uitspraak terug — accepteren of weigeren — zonder de aanbieding aan te raken. Pas achteraf leren dat Amazon een wijziging weigerde, kost uren van advertentiegeschikte zichtbaarheid, dus de klik is het waard.
• "Goedkeuren & naar Amazon sturen" past het toe. De rij gaat naar toegepast met Amazon's indienings-id, of naar mislukt met de echte foutmelding. Er is geen staat waarin het paneel zegt dat het goedgekeurd is terwijl er niets geprobeerd is.

Een concept ouder dan zeven dagen wordt gemarkeerd als verouderd — de economie erin bevroor toen het geschreven werd, en vergoedingspercentages veranderen wel. Dat is adviserend: je kunt het desondanks toepassen met één extra bevestiging.

Je hoeft ook niet in het paneel te leven. Drie e-mails worden automatisch verstuurd: wanneer een concept gemaakt wordt, op het moment dat het toegepast wordt of mislukt, en wanneer het resultaat ongeveer twee weken later beoordeeld wordt. Er is geen dagelijkse herinnering — het paneel toont hoeveel concepten nog wachten.

Stap 5 — Werkt het echt?

Twee weken nadat een wijziging is toegepast, rapporteert did_my_changes_work wat er met de conversie in de daaropvolgende veertien dagen gebeurde, beoordeeld tegen vensters die bevroren waren op het moment van toepassen.

De uitspraken zijn bewust conservatief, en dat is de feature, geen beperking. Bij laag volume is "niet overtuigend" het eerlijke antwoord — en het zegt precies waarom: dun verkeer, normale dag-tot-dag-schommeling, of een andere wijziging aan dezelfde aanbieding binnen het venster. Een wijziging waarvan het venster nog niet gesloten is, rapporteert aan_het_meten, met de datum waarop het eerst gelezen kan worden.

Het vermeldt ook zijn eigen plafond: dit is wat er gebeurde samen met de wijziging, geen bewijs dat de wijziging het veroorzaakte. Advertenties, concurrenten, reviews, promoties en seizoen bewogen allemaal in hetzelfde venster. En wijzigingen die je direct in Seller Central maakte, zijn er onzichtbaar voor, inclusief die binnen een gemeten venster landden.

Iedereen die je schone causale attributie belooft op een single-SKU-aanbieding met een paar verkopen per dag, verkoopt je een betrouwbaarheidsinterval dat ze niet berekend hebben.

Wat dit niet doet

• Het haalt geen producten in, schraapt geen concurrenten, of schat iemand anders verkopen in. Het meet jouw account. Als dat is wat je zoekt, onze toolvergelijking voor EU-verkopers is een beter startpunt.
• Het handelt niet uit zichzelf. Er is geen autopilot; elke wijziging wacht op een mens.
• Het rekent geen valuta's om, en het verzint geen getal om een gat te vullen.
• Zonder opgeslagen eenheidskosten voor een SKU, is zijn winst overschat met de volledige kosten van goederen — en what_i_cannot_tell_you zal je vertellen welke SKU's dat zijn, ongevraagd.

Aan de slag

1. Probeer de demo-connector — geen account nodig, 60 seconden.
2. Verbind je Amazon-account onder Instellingen → Amazon-verbinding.
3. Maak een token aan onder Instellingen → AI-assistent, of voeg de aangepaste connector toe in Claude of ChatGPT.
4. Vraag: "Hoeveel vertrouwen mag ik in deze cijfers stellen?" Het is de meest onthullende eerste vraag die je aan elk Amazon-tool kunt stellen, en deze beantwoordt het met een meting in plaats van een marketingzin.

Bekijk abonnementen en prijzen →