AI-ASSISTENT EN MCP
Een AI-assistent voor je QR-codes en klantfeedback
Er zijn twee ingangen. De assistent die in de Mosaqo-werkruimte is ingebouwd, beantwoordt vragen over je codes, scans en enquêtes en bereidt wijzigingen voor als kaarten waarop je klikt. Met de MCP-server kunnen Claude, ChatGPT of elke andere MCP-client met dezelfde werkruimte werken, via een sleutel of een aanmelding die jij goedkeurt. Hoe dan ook kan de assistent precies wat zijn toegang toestaat, en je trekt die toegang in één stap weer in.
SNEL OVERZICHT
Wat dit in de praktijk verandert
01
Wat je hem kunt vragen
De vragen die mensen echt over hun QR-codes hebben, zijn vergelijkingen en lijstjes: welke codes deze maand het vaakst zijn gescand, welke niemand meer heeft gescand sinds de oplage, hoe deze week zich verhoudt tot de vorige, welke plaatsing van een campagne het werk doet. Een assistent beantwoordt dat in één zin in plaats van met een dashboard dat je zelf moet lezen, en hij noemt de codes bij naam, zodat je het kunt nagaan.
Feedback werkt net zo: hoe een enquête zich ontwikkelt, welke vraag het laagst scoort, hoeveel mensen hebben geantwoord sinds het menu veranderde. Via MCP krijgt een assistent de cijfers — aantallen, keuzes, de spreiding per vraag, hoeveel mensen een opmerking schreven — en nooit de tekst van een opmerking. De ingebouwde assistent kan de meest recente geschreven opmerkingen lezen, voor dezelfde mensen aan wie het Postvak IN met antwoorden ze toont, zodat hij je in één zin kan vertellen waar ze over gaan.
- De meest gescande en de stille codes, bij naam
- Deze periode tegenover de vorige, voor één code of de hele werkruimte
- Enquêtescores, en de spreiding achter een gemiddelde
- Scandetails, begrensd door de eigen privacy-instellingen van de werkruimte
02
Wat hij kan wijzigen, en wie ja zegt
In de werkruimte handelt de assistent nooit op eigen houtje. Hij stelt voor: een nieuwe code, een kaartsjabloon op basis van jouw beschrijving, de vragen van een enquête, een nieuwe bestemming voor een dynamische code, publiceren of archiveren. Elk voorstel komt als een kaart die zegt wat er gaat gebeuren, en er verandert niets tot iemand erop klikt — met de eigen rol van die persoon, dus een lezer kan een voorstel wel lezen maar niet uitvoeren.
Via MCP roept de assistent de tools aan die zijn sleutel of aanmelding toestaat. Elke tool die schrijft, is als zodanig gemarkeerd, en archiveren is gemarkeerd als destructief, dus een client die zich aan die markeringen houdt, vraagt het je voordat hij ze uitvoert. Er is geen tool die een code verwijdert: verder dan archiveren gaat het niet, en een gearchiveerde code kan worden teruggezet.
- Ingebouwd: URL-, Wi-Fi-, tekst-, vCard- en App-linkcodes maken; kaartsjablonen en enquêtes opstellen
- Ingebouwd en via MCP: een dynamische code naar een nieuwe plek laten wijzen, publiceren, archiveren
- Via MCP: URL-codes als concept maken, en een CSV-import starten die een proefrun is, tenzij je anders zegt
- Geen van beide: een code verwijderen, mensen uitnodigen of wijzigen wie toegang heeft
03
Twee manieren om een externe assistent te koppelen
De MCP-server heeft één adres: https://api.mosaqo.app/v1/mcp. De eenvoudigste weg is een API-sleutel. Een eigenaar of admin maakt er een aan onder “Bulk en API”, vinkt aan wat die sleutel mag en plakt hem in de client. Een sleutel kan een vervaldatum en een IP-allowlist hebben, en intrekken stopt hem meteen.
De andere weg is een aanmelding. De client registreert zichzelf en opent een Mosaqo-pagina, waar een eigenaar of admin hem voor één werkruimte goedkeurt. Daarna staat hij onder “Gekoppelde assistenten”, en “Ontkoppelen” beëindigt de koppeling direct. Hoe dan ook geeft één set inloggegevens toegang tot één werkruimte.
- qr:read en qr:write voor codes, exports:read voor hun afbeeldingen
- analytics:read voor scans, reviews:read voor plekken en enquêterapporten
- bulk:write en webhooks:write alleen als je ze nodig hebt
- Een tool buiten de toegang die je hebt verleend, krijgt de assistent helemaal niet aangeboden
04
Begin met minder toegang dan je denkt nodig te hebben
Een alleen-lezen sleutel beantwoordt het meeste van wat mensen van een assistent willen: rapporten, vergelijkingen, de lijst met codes die aandacht nodig hebben. Geef hem qr:read en analytics:read, gebruik hem een week, en voeg qr:write toe zodra er een wijziging is die je echt vanuit een gesprek wilt laten doorvoeren.
Houd een aparte sleutel aan voor elke tool en elke persoon. Een sleutel die uitlekt, of een experiment waarmee je klaar bent, kun je dan intrekken zonder iets anders aan te raken.
05
Grenzen die je moet kennen voordat je erop vertrouwt
De ingebouwde assistent beantwoordt tot 60 vragen per werkruimte per uur en 300 per dag, en hij blijft bij het onderwerp van de werkruimte: een vraag die daar niets mee te maken heeft, krijgt een beleefde weigering. Iedereen kan hem voor de eigen werkruimtes verbergen onder “Voorkeuren”.
Via MCP kan elke sleutel of aanmelding 600 verzoeken per minuut doen, als bescherming tegen een op hol geslagen lus, niet als limiet van een abonnement. Scananalyses gelden alleen voor dynamische codes, omdat een statische code na het drukken nooit meer via Mosaqo loopt.
FAQ
Veelgestelde vragen
Welke assistenten kunnen met Mosaqo koppelen?
Elke client die het Model Context Protocol spreekt, waaronder Claude en ChatGPT. Wijs hem naar https://api.mosaqo.app/v1/mcp en geef hem toestemming met een API-sleutel of door je aan te melden.
Kan een assistent lezen wat mijn klanten schreven?
Niet via MCP of de API. Een enquêterapport bevat daar scores, aantallen en hoeveel mensen iets schreven, en de tekst zelf wordt verwijderd voordat het rapport vertrekt. De ingebouwde assistent kan de nieuwste geschreven opmerkingen lezen, voor dezelfde rollen die het Postvak IN met antwoorden kunnen openen, zodat hij ze kan samenvatten als je erom vraagt.
Hoe trek ik de toegang van een assistent weer in?
Trek zijn API-sleutel in, of klik op “Ontkoppelen” naast hem onder “Gekoppelde assistenten”; hij bereikt de werkruimte meteen niet meer. Iedereen kan de ingebouwde assistent voor zichzelf uitzetten onder “Voorkeuren”.
Kost de assistent extra?
Nee. De ingebouwde assistent en de MCP-server zitten in het gratis plan, net als elke andere functie.
VOLGENDE STAP