Mago: de AI-assistent die we met vijf bureaus bouwden

Haimanti Dekker
Haimanti Dekker
9 november 20268 min

Vrijdagmiddag, 16:55. Er komt een ticket binnen: “Waarom werkt SUMMER10 niet???!” Iedereen die bij een Magento-bureau werkt kent dit soort vragen. De kortingsregel is verlopen, of een andere regel heeft voorrang, of de klant zit in de verkeerde klantgroep. Het antwoord staat ergens in de admin, maar je moet wel weten waar.

Elk bureau beantwoordt die vragen elke week opnieuw, en ieder voor zich. Daar zijn we dit jaar met vijf Nederlandse bureaus samen iets aan gaan doen. Het resultaat heet Mago, en Linted was een van de initiatiefnemers.

Even vooraf: dit is dus geen neutrale review. We hebben het zelf mee gebouwd. Wel een eerlijk verhaal, inclusief wat het niet kan.

Wat Mago is

“Vraag Mago alles. Of zeg wat hij moet doen.”

askmago.com

Mago is een AI-assistent in je Magento-admin. Je stelt in gewone taal een vraag (“wat waren deze week onze best verkochte producten?”, “welke kortingsregels staan nu aan?”) en Mago zoekt het op in je eigen winkel, met live data. Je kunt het ook iets laten doen, zoals een instelling aanpassen, de cache legen of een productomschrijving schrijven. Dan zie je eerst wat er gaat veranderen en gebeurt er pas iets als jij op ‘toestaan’ klikt.

De belangrijkste punten op een rij:

  • Gratis en open source (MIT-licentie). Geen licentie, geen abonnement, geen seats.
  • Je eigen AI-aanbieder. Je koppelt je eigen account. Op dit moment zijn dat Claude (Anthropic) en OpenAI. Koppelingen met andere aanbieders, zoals Gemini of een lokaal model, zijn er nog niet. Mago is open source, dus heb je er een nodig: draag zelf bij. De kosten per gesprek zijn meestal een paar cent, en die betaal je direct aan die aanbieder. Er zit geen Mago-server tussen.
  • Volgt je adminrechten. Mago gebruikt de rollen die je in Magento al hebt ingesteld. Mag een collega geen bestellingen zien, dan kan dat via Mago ook niet.
  • Niets zonder akkoord. Lezen gaat direct, elke wijziging vraagt eerst om bevestiging. Bij ingrijpende acties, zoals een bestelling annuleren of terugbetalen, zie je vooraf wat het gevolg is.
  • Vanaf Magento 2.4.8. Of Mage-OS 1.1 en hoger, met PHP 8.2 of nieuwer.

Sinds Mage-OS 4.0 zit Mago standaard in die distributie. Op Magento van Adobe installeer je het met composer.

Wat het met je klantdata doet

Dit is het onderdeel dat ik zelf heb gebouwd, en de vraag die we het vaakst krijgen. Een taalmodel draait bij een externe partij, dus wat gaat daar naartoe?

Zo weinig mogelijk.

“Namen, e-mailadressen, telefoonnummers en adressen gaan nooit de deur uit. Mago haalt ze uit elke opzoeking voordat het met de AI-provider praat. Order- en klantnummers worden placeholders zoals [order_1].”

In de praktijk: vraag je naar de laatste bestelling van een klant, dan haalt Mago die bestelling op in je eigen winkel en vervangt de persoonsgegevens door codes voordat er iets naar het taalmodel gaat. Het model krijgt iets als “klant [customer_1] heeft bestelling [order_3] geplaatst, totaal 89 euro, verzonden naar Nederland”. Daar kan het mee rekenen en redeneren, maar het weet niet wie de klant is. Pas op jouw scherm worden de echte naam en het echte bestelnummer weer ingevuld.

Een paar keuzes die we daarbij bewust hebben gemaakt:

  • De privacylaag staat altijd aan en kan niet uit. Dan kan hij ook niet per ongeluk verkeerd staan.
  • Wat niet is ingedeeld, gaat niet mee. Elke functie moet per veld aangeven of het door mag, vervangen wordt door een code of wordt weggelaten. Dat geldt ook voor uitbreidingen van anderen.
  • Ook wat je zelf typt. Een e-mailadres, IBAN, BSN, btw-nummer of telefoonnummer in de chat wordt vervangen voordat het verstuurd wordt.
  • Wachtwoorden en API-sleutels uit je instellingen gaan nooit naar het taalmodel.
  • Gesprekken worden na 90 dagen verwijderd, inclusief de koppeling tussen codes en echte gegevens. Die termijn stel je zelf in.

En eerlijk is eerlijk: geen systeem is perfect. Typ je zelf een klantnaam midden in een zin, dan herkent Mago die niet altijd. En omdat je eigen winkel weet welke code bij welke klant hoort, blijft het onder de AVG vallen. “De AI-provider verwerkt het gesprek zelf wel, dus sluit een verwerkersovereenkomst af, zoals met elke verwerker.”

Je gebruikt je eigen account bij die aanbieder, dus die afspraak maak je zelf. Wil je dat alles in de EU blijft, dan is dat nu nog een open punt: een koppeling met een aanbieder in een EU-regio of een lokaal model moet nog gebouwd worden. De volledige uitleg staat op de security-pagina van Mago.

Waarom vijf bureaus samen iets bouwen

Mago is gebouwd door Control Alt Delete, Linted, Made by Mouses, Magmodules en Vendic, met Mage-OS Nederland als neutrale grond. Elk bureau met een eigen club klanten en een eigen kijk op Magento.

“Dezelfde vraag. Hetzelfde leergeld. Niet ons onderscheid.”

We kregen allemaal dezelfde vragen, we zouden allemaal hetzelfde leergeld betalen om zoiets goed te bouwen, en een admin-assistent is voor geen van ons het ding waarmee we ons onderscheiden. “Het was iets om één keer te bouwen, samen.”

Het begon in april 2026 op Hyvä Developers Paradise in Marbella: “a tan and no plan”, zoals het in onze slides stond. In juni, op de Mage Unconference, kozen we aan een picknicktafel voor een AI-assistent in de admin. Daarna was er elke week huiswerk, en in september werd het proof of concept tijdens de Mage-OS-hackathon in Zwolle een product dat je durft te installeren. Van eerste commit tot versie 1.0 duurde het 104 dagen, met 22 mensen die code schreven, reviewden en testten.

We werkten met drie afspraken: één gedeelde lijst met een eigenaar, iedereen doet waar hij goed in is, en een ander bureau reviewt je code. Geen pull request gaat erin zonder dat een developer van een ander bureau hem heeft gelezen. Dat laatste was in het begin even wennen, en achteraf het beste besluit.

Want de AI zelf was het makkelijke deel.

“Een demo is makkelijk. Een product dat je vertrouwt niet.”

Het werk zat in het saaie deel: het ziet alleen wat je adminrol toestaat, het vraagt voordat het iets wijzigt, het doet nooit meer dan je vroeg, en het houdt bij wat het deed. “Dat saaie deel is waarom Mago een collega in je backoffice is, geen chatbot op je website.”

Michiel Gerritsen, Tabitha Karta en Haimanti Dekker op het podium van Meet Magento DE

Op Meet Magento NL en Meet Magento DE vertelden we het verhaal samen met Michiel Gerritsen (Mage-OS, Control Alt Delete) en Tabitha Karta (Vendic): Mage-OS als neutrale plek waar bureaus samen kunnen bouwen, hoe je zo’n samenwerking werkend houdt, en Mago als bewijs.

Zelf uitbreiden

Omdat Mago open source is, kan iedereen er functies aan toevoegen zonder de kern aan te passen. Marvin Besselsen bouwde een check op btw-nummers via VIES, ik bouwde er een KvK-check bovenop. Vraag “klopt dit btw-nummer?” of “van wie is dit KvK-nummer?” en je krijgt het antwoord in de admin, zonder tabbladen te wisselen. Er wordt nu gewerkt aan een koppeling met RUMvision, zodat je echte gebruikersdata over snelheid in je admin ziet.

Het team achter Mago na de talk op Meet Magento NL

Moet je het installeren?

Als je op Mage-OS 4.0 zit, heb je het al en hoef je het alleen nog in te stellen. Zit je op Magento Open Source 2.4.8 of hoger, dan is het één composer-pakket. In beide gevallen geldt: bepaal eerst wie in je team het gaat gebruiken en waarvoor, regel de verwerkersovereenkomst met je AI-aanbieder, en zet dan pas aan. Het is gratis, maar dat is geen reden om het zonder nadenken aan te zetten.

Wil je hulp bij het installeren, of wil je een eigen uitbreiding voor je shop of je ERP? Mago is zo gebouwd dat je er zelf op kunt doorbouwen. Dat doen we bij Linted als onderdeel van Magento onderhoud of als los project. Neem contact op als je wilt sparren.

Veelgestelde vragen

Wat kost Mago?

Mago zelf is gratis, onder MIT-licentie. Je betaalt alleen je AI-aanbieder voor wat je gebruikt, direct en zonder opslag. Een normale vraag of actie kost een paar cent.

Stuurt Mago klantgegevens naar OpenAI of Anthropic?

Namen, e-mailadressen, telefoonnummers en adressen niet: die worden vervangen door codes voordat er iets naar het taalmodel gaat. Bedragen, producten en instellingen gaan wel mee, want daar rekent het model mee. Je hebt nog steeds een verwerkersovereenkomst met je AI-aanbieder nodig.

Werkt Mago op oudere Magento-versies?

Nee. Mago vereist Magento 2.4.8 of hoger, of Mage-OS 1.1 of hoger, met PHP 8.2 of nieuwer. Draai je een oudere versie, dan is upgraden sowieso de eerste stap.

Kan Mago zelf dingen in mijn winkel veranderen?

Alleen als jij daar per keer toestemming voor geeft, en alleen wat jouw adminrol mag. Mago kan geen ruwe SQL uitvoeren en kan zijn eigen instellingen, betaalinstellingen, wachtwoorden en API-sleutels niet lezen of wijzigen.

Meer lezen?

Bekijk al onze artikelen over e-commerce en development.