Construire une liste a toujours consisté à tâtonner avec des filtres : empiler des menus déroulants, regarder le décompte, ajuster, exporter, découvrir que la liste n'était pas celle voulue, et recommencer. Un agent IA connecté à la base transforme cette boucle en conversation. Vous décrivez l'audience, l'agent interroge les données et affine jusqu'à ce que les chiffres aient du sens, et c'est seulement alors que vous autorisez un résultat payant.
Ce tutoriel utilise Claude et Argorant via le Model Context Protocol. D'autres clients MCP peuvent utiliser le même endpoint distant, mais leur configuration de connecteur, leur interface d'approbation, leur authentification et leurs outils disponibles doivent être testés séparément.
La configuration en deux minutes
Argorant expose un serveur MCP distant à l'adresse https://mcp.argorant.com/mcp. Dans les paramètres de connecteurs de Claude (ou via `claude mcp add` dans Claude Code), ajoutez cette URL comme serveur distant. Le premier appel déclenche un flux OAuth dans votre navigateur : vous vous connectez à votre compte Argorant, approuvez la connexion, et l'agent reçoit un jeton à portée limitée. Aucune clé API à coller dans des fichiers de configuration, et vous pouvez révoquer la connexion depuis votre compte à tout moment.
Une fois connecté, Claude voit 15 outils documentés couvrant l'inspection du compte, la recherche d'entreprises et de personnes, les décomptes, les personnes d'une entreprise, les aperçus masqués, le déblocage de contacts, l'enrichissement, les listes enregistrées, les exports et le statut des tâches. L'accès MCP est inclus dans les forfaits payants d'Argorant ; un portefeuille agent prépayé distinct permet des achats de contacts plafonnés sans abonnement récurrent.
L'économie : consulter est gratuit, récupérer est facturé
La conception des outils sépare la découverte de l'obtention de contacts payants. La recherche, le décompte et l'aperçu masqué permettent à Claude de tester la forme du marché avant de débloquer ou d'exporter des coordonnées. Ces actions de découverte ne consomment pas de crédits contacts selon les règles actuelles du produit, même si les limites habituelles du compte et de débit s'appliquent toujours.
Les crédits ne sont dépensés que pour les déblocages et les exports, quand des données de contact vérifiées sortent réellement du système. Et comme Argorant vérifie chaque adresse en direct à l'export et facture 0 crédit pour les résultats invalides, l'étape payante ne vous facture que les adresses qui passent. Un agent ne peut épuiser votre solde ni en explorant, ni en rebonds.
Une vraie session, de bout en bout
Voici à quoi ressemble la boucle en pratique. Vous demandez : « Trouvez les responsables des opérations dans les entreprises de logistique de taille moyenne en Allemagne et aux Pays-Bas. » Claude appelle l'outil de décompte avec sa première interprétation de la demande (par exemple 50 à 500 salariés, un filtre sectoriel transport et logistique, deux codes pays) et annonce quelque chose comme 4,800 personnes correspondantes.
Vient ensuite la partie intéressante : vous interrogez le résultat avant de le payer. Demandez la répartition du décompte par pays et un échantillon masqué d'intitulés. Claude lance des appels d'aperçu, vous remarquez que le filtre d'intitulés attrape des chefs d'équipe d'entrepôt, vous le resserrez, et le décompte change. Continuez jusqu'à ce que les filtres interprétés et l'échantillon visible décrivent un segment auquel vous croyez vraiment.
C'est seulement alors que vous dites « débloquez les 200 premiers et exportez-les en CSV ». C'est le premier moment où des crédits sont dépensés, sur une liste que vous avez déjà examinée sous trois angles, chaque adresse étant vérifiée en SMTP à la sortie.
Un conseil pratique pour la reproductibilité : une fois une définition calée, demandez à Claude de reformuler explicitement le jeu de filtres final (secteurs, tranches d'effectif, pays, motifs d'intitulés). Collez-le dans un fichier de projet ou un prompt système, et la session suivante part d'une base éprouvée au lieu de reconstruire l'ICP de zéro.
Le prompt qui maintient Claude dans les clous
Demandez à Claude de travailler par étapes : d'abord reformuler l'ICP sous forme de filtres explicites ; ensuite lancer un décompte ; puis montrer un aperçu masqué et expliquer les écarts ; puis attendre l'approbation ; et seulement alors débloquer ou exporter un nombre maximal fixe de contacts. La limite d'approbation fait ainsi partie de la tâche au lieu de compter sur l'agent pour la deviner.
Un prompt pratique : « Traduisez cet ICP en filtres explicites sur l'entreprise et la personne. Montrez-moi les filtres, comptez les correspondances et prévisualisez cinq fiches masquées. Ne débloquez rien, n'enrichissez rien, ne créez pas d'export payant et n'envoyez rien vers un autre système tant que je n'ai pas approuvé les filtres finaux et une dépense maximale. » Après l'aperçu, demandez à Claude d'indiquer l'action payante prévue, la limite de fiches et le solde actuel avant de l'approuver.
Pour des exécutions reproductibles, enregistrez l'objet de filtres approuvé et les règles d'exclusion. N'enregistrez pas une instruction vague comme « trouver de bons acheteurs », car un futur modèle ou un vocabulaire de données modifié peut l'interpréter autrement.
Testez les parcours d'échec avant de vous fier au parcours idéal
Un décompte qui fonctionne n'est pas une preuve de bout en bout. Testez une requête sans résultat, un filtre volontairement non pris en charge, une connexion expirée ou révoquée, un solde insuffisant, une requête limitée en débit et une demande d'export en double. Claude doit expliquer la situation et s'arrêter, pas élargir silencieusement l'audience ni relancer une action payante sans limite.
Après un export autorisé, comparez la limite demandée, les lignes renvoyées, le nombre de résultats valides, les crédits facturés et le statut de la tâche. Les résultats invalides, catch-all, inconnus, exclus et en double ne doivent pas être fondus dans un seul chiffre de succès.
Enfin, déconnectez le connecteur dans Claude et révoquez-le dans Argorant. Confirmez que l'ancien jeton ne peut plus lire les données du compte. La révocation fait partie du test de configuration ; ce n'est pas une formalité administrative à traiter après coup.
Si vous préférez rester dans le terminal
Le même workflow est disponible sans agent au milieu. La CLI Argorant est publiée sur npm (`npx argorant` la lance sans installation) et expose recherche, décomptes, déblocages et exports sous forme de commandes scriptables. Elle s'authentifie sur le même compte et le même solde de crédits : une tâche cron, une étape CI ou une extraction ponctuelle depuis un shell puisent toutes au même endroit.
La CLI est aussi la couche de débogage pragmatique des workflows d'agents : quand vous voulez confirmer exactement ce qu'un filtre renvoie avant de l'inscrire dans les instructions d'un agent, une seule commande vous donne la vérité terrain.
Pourquoi cela bat les allers-retours dans le tableau de bord
Le gain structurel, c'est que l'itération devient presque gratuite, en temps comme en crédits. Dans un outil classique, chaque affinage coûte un rechargement de page et chaque erreur un export. Dans la boucle de l'agent, l'affinage tient en une phrase et les erreurs sont repérées au stade de l'aperçu, avant que l'argent ne bouge.
Cela signifie aussi que la construction de listes s'intègre à tout ce que fait votre agent. Claude peut extraire la liste, rédiger le premier e-mail en citant le secteur de chaque entreprise et transmettre le fichier à votre outil de séquences : une seule conversation, avec 630.7M de contacts dans 202 pays derrière un protocole que l'agent parle déjà. Connectez-vous une fois, puis arrêtez de cliquer dans des menus déroulants.
