Lijsten bouwen was altijd gepriegel met filters: keuzelijsten stapelen, het aantal bekijken, bijstellen, exporteren, ontdekken dat de lijst niet was wat je bedoelde, en opnieuw beginnen. Een AI-agent die aan de database is gekoppeld, maakt van die lus een gesprek. Jij beschrijft de doelgroep, de agent bevraagt de data en verfijnt tot de cijfers kloppen, en pas daarna geef je toestemming voor betaald resultaat.
Deze rondleiding gebruikt Claude en Argorant via het Model Context Protocol. Andere MCP-clients kunnen hetzelfde remote endpoint gebruiken, maar hun instelling van de connector, goedkeuringsinterface, authenticatiegedrag en beschikbare tools moeten apart worden getest.
De opzet in twee minuten
Argorant biedt een remote MCP-server op https://mcp.argorant.com/mcp. Voeg die URL toe als remote server in de connectorinstellingen van Claude (of via `claude mcp add` in Claude Code). De eerste aanroep start een OAuth-flow in je browser: je logt in op je Argorant-account, keurt de koppeling goed en de agent krijgt een token met beperkte rechten. Geen API-sleutels die je in configuratiebestanden plakt, en je kunt de koppeling op elk moment vanuit je account intrekken.
Na het koppelen ziet Claude 15 gedocumenteerde tools voor het inspecteren van het account, zoeken naar bedrijven en personen, tellingen, personen per bedrijf, gemaskeerde voorbeelden, contacten vrijgeven, verrijking, opgeslagen lijsten, exports en taakstatus. MCP-toegang zit in de betaalde plannen van Argorant; een apart prepaid agenttegoed ondersteunt begrensde aankopen van contacten zonder terugkerend abonnement.
De economie: gratis kijken, betalen naar gebruik bij afnemen
Het toolontwerp scheidt ontdekken van betaald contactresultaat. Met zoeken, tellen en een gemaskeerd voorbeeld test Claude de vorm van de markt voordat het contactdata vrijgeeft of exporteert. Die ontdekacties verbruiken volgens de huidige productregels geen credits voor contactresultaat, al blijven de normale accountlimieten en snelheidslimieten gelden.
Credits worden alleen uitgegeven bij vrijgaven en exports, op het moment dat gecontroleerde contactdata het systeem echt verlaat. En omdat Argorant bij export live via SMTP controleert en 0 credits rekent voor ongeldige resultaten, betaal je bij de gemeten stap alleen voor adressen die slagen. Een agent kan je saldo niet opmaken aan verkennen, en ook niet aan bounces.
Een echte sessie, van begin tot eind
Zo ziet de lus er in de praktijk uit. Je vraagt: "Zoek hoofden operations bij middelgrote logistieke bedrijven in Duitsland en Nederland." Claude roept de teltool aan met een eerste interpretatie van die vraag (bijvoorbeeld 50-500 medewerkers, een branchefilter voor transport en logistiek, twee landcodes) en meldt iets als 4,800 passende personen.
Dan het interessante deel: je bevraagt het resultaat voordat je ervoor betaalt. Vraag hoe het aantal per land is verdeeld en vraag om een gemaskeerde sample van functietitels. Claude doet aanroepen voor voorbeelden, jij ziet dat het titelfilter ploegleiders in magazijnen meeneemt, je scherpt het aan en het aantal verandert. Ga door tot de geïnterpreteerde filters en de zichtbare sample een segment beschrijven waar je echt in gelooft.
Pas dan zeg je "geef de beste 200 vrij en exporteer ze als CSV". Dat is het eerste moment waarop credits worden uitgegeven, voor een lijst die je al van drie kanten hebt bekeken, waarbij elk adres bij het exporteren een SMTP-controle krijgt.
Een praktische tip voor herhaalbaarheid: is een definitie eenmaal goed afgesteld, vraag Claude dan om de uiteindelijke set filters expliciet te herhalen (branches, klassen voor personeelsomvang, landen, titelpatronen). Plak die in een projectbestand of systeemprompt, dan begint de volgende sessie vanaf een bekende goede basis in plaats van het ideale klantprofiel opnieuw vanaf nul af te leiden.
De prompt die Claude binnen de grenzen houdt
Laat Claude in fasen werken: eerst het ideale klantprofiel herhalen als expliciete filters; daarna een telling draaien; daarna een gemaskeerd voorbeeld tonen en afwijkingen uitleggen; daarna wachten op goedkeuring; pas dan een vast maximumaantal contacten vrijgeven of exporteren. Zo wordt de grens van de goedkeuring deel van de taak, in plaats van erop te vertrouwen dat de agent die zelf afleidt.
Een praktische prompt is: 'Vertaal dit ideale klantprofiel naar expliciete filters op bedrijf en persoon. Laat me de filters zien, tel de matches en toon een voorbeeld van vijf gemaskeerde records. Geef niets vrij, verrijk niets, maak geen betaalde export en zet niets door naar een ander systeem tot ik de definitieve filters en een maximaal bedrag heb goedgekeurd.' Vraag Claude na het voorbeeld om de verwachte betaalde actie, de limiet aan records en het huidige saldo te noemen voordat je het goedkeurt.
Bewaar voor herhaalbare runs het goedgekeurde filterobject en de uitsluitingsregels. Bewaar geen brede instructie zoals 'vind goede kopers', want een toekomstig model of een veranderde datawoordenschat kan die anders interpreteren.
Test de foutpaden voordat je het ideale pad vertrouwt
Een werkende telling is geen bewijs van begin tot eind. Test een zoekopdracht zonder resultaat, een bewust niet-ondersteund filter, een verlopen of ingetrokken koppeling, onvoldoende saldo, een verzoek dat tegen de snelheidslimiet loopt en een dubbel exportverzoek. Claude moet de situatie uitleggen en stoppen, niet stilletjes de doelgroep verbreden of een betaalde actie zonder grens opnieuw proberen.
Vergelijk na een geautoriseerde export de gevraagde limiet, de teruggegeven rijen, het aantal geldige resultaten, de afgerekende credits en de taakstatus. Ongeldige, catch-all-, onbekende, onderdrukte en dubbele uitkomsten mogen niet worden samengevoegd tot één succesgetal.
Ontkoppel tot slot de connector in Claude en trek hem in bij Argorant. Bevestig dat het oude token geen accountdata meer kan lezen. Intrekken hoort bij de test van de opzet, het is geen administratieve bijzaak.
Als je liever in de terminal blijft
Dezelfde werkwijze kan ook zonder agent ertussen. De Argorant CLI staat op npm (`npx argorant` start hem zonder installatie) en biedt zoeken, tellingen, vrijgeven en exports als commando's die je in scripts kunt gebruiken. Hij logt in op hetzelfde account en hetzelfde creditsaldo, dus een cronjob, een CI-stap of een snelle eenmalige export vanuit een shell putten allemaal uit één bron.
De CLI is ook de praktische debuglaag voor workflows met agents: als je precies wilt bevestigen wat een filter matcht voordat je het in de instructies van een agent vastlegt, geeft één commando je de grondwaarheid.
Waarom dit beter werkt dan heen en weer in het dashboard
De structurele winst is dat itereren bijna gratis wordt, in tijd en in credits. In een traditionele tool kost elke verfijning een pagina die opnieuw laadt en elke fout een export. In de lus met een agent is verfijnen één zin en worden fouten in de voorbeeldfase opgevangen, voordat er geld beweegt.
Het betekent ook dat lijsten bouwen samengaat met al het andere wat je agent doet. Claude kan de lijst ophalen, de eerste mail opstellen met een verwijzing naar de branche van elk bedrijf en het bestand doorgeven aan je e-mailtool: één gesprek, met 630.7M contacten in 202 landen achter een protocol dat de agent al spreekt. Eén keer koppelen, en daarna nooit meer door keuzelijsten klikken.
