Costruire liste è sempre stato un esercizio di aggiustamento dei filtri: impili menu a tendina, guardi il conteggio, correggi, esporti, scopri che la lista non era quella che intendevi e ricominci. Un agente AI collegato al database trasforma quel ciclo in una conversazione. Descrivi il pubblico, l'agente interroga i dati e affina finché i numeri hanno senso, e solo allora autorizzi un risultato a pagamento.
Questa guida usa Claude e Argorant tramite il Model Context Protocol. Altri client MCP possono usare lo stesso endpoint remoto, ma configurazione del connettore, interfaccia di approvazione, comportamento dell'autenticazione e strumenti disponibili vanno testati a parte.
La configurazione in due minuti
Argorant espone un server MCP remoto su https://mcp.argorant.com/mcp. Nelle impostazioni dei connettori di Claude (o con `claude mcp add` in Claude Code), aggiungi quell'URL come server remoto. La prima chiamata avvia un flusso OAuth nel browser: accedi al tuo account Argorant, approvi la connessione e l'agente riceve un token con ambito limitato. Nessuna chiave API incollata nei file di configurazione, e puoi revocare la connessione dal tuo account in qualsiasi momento.
Una volta collegato, Claude vede 15 strumenti documentati che coprono ispezione dell'account, ricerca di aziende e persone, conteggi, persone di un'azienda, anteprime oscurate, visualizzazione dei contatti, arricchimento, liste salvate, esportazioni e stato dei job. L'accesso MCP è incluso nei piani a pagamento di Argorant; un portafoglio prepagato separato per agenti consente acquisti di contatti entro limiti definiti senza abbonamento ricorrente.
L'economia: guardare è gratis, prendere è a consumo
Il design degli strumenti separa la ricerca dall'output di contatti a pagamento. Ricerca, conteggio e anteprima oscurata permettono a Claude di testare la forma del mercato prima di mostrare o esportare dati di contatto. Con le regole attuali del prodotto queste azioni di esplorazione non consumano crediti di output contatti, anche se restano validi i normali limiti dell'account e di frequenza.
I crediti si spendono solo per mostrare ed esportare, quando i dati di contatto verificati escono davvero dal sistema. E poiché Argorant verifica via SMTP in tempo reale all'esportazione e addebita 0 crediti per i risultati non validi, il passaggio a consumo ti addebita solo gli indirizzi che superano la verifica. Un agente non può bruciare il tuo saldo nell'esplorazione, né sui rimbalzi.
Una sessione reale, dall'inizio alla fine
Ecco come funziona il ciclo nella pratica. Chiedi: "Trova i responsabili delle operations in aziende di logistica di medie dimensioni in Germania e nei Paesi Bassi." Claude chiama lo strumento di conteggio con la sua prima interpretazione della richiesta (magari 50-500 dipendenti, un filtro di settore trasporti e logistica, due codici paese) e riporta qualcosa come 4,800 persone corrispondenti.
Poi la parte interessante: interroghi il risultato prima di pagarlo. Chiedi come si divide il conteggio per paese e richiedi un campione oscurato di qualifiche. Claude esegue chiamate di anteprima, tu noti che il filtro sulle qualifiche sta prendendo i capoturno di magazzino, lo restringi e il conteggio cambia. Continua finché i filtri interpretati e il campione visibile non descrivono un segmento in cui credi davvero.
Solo a quel punto dici "mostra i primi 200 ed esportali in CSV". È il primo momento in cui spendi crediti, su una lista che hai già esaminato da tre angolazioni, con ogni indirizzo verificato via SMTP in uscita.
Un consiglio pratico per poterlo ripetere: quando una definizione è messa a punto, chiedi a Claude di riformulare in modo esplicito l'insieme finale di filtri (settori, fasce di dipendenti, paesi, schemi di qualifica). Incollalo in un file di progetto o in un prompt di sistema, e la sessione successiva partirà da una base collaudata invece di ricostruire l'ICP da zero.
Il prompt che tiene Claude dentro i limiti
Chiedi a Claude di lavorare per fasi: prima riformulare l'ICP come filtri espliciti; poi eseguire un conteggio; poi mostrare un'anteprima oscurata e spiegare le discrepanze; poi attendere l'approvazione; solo allora mostrare o esportare un numero massimo fisso di contatti. Così il limite di approvazione diventa parte dell'attività invece di affidarsi all'agente perché lo deduca.
Un prompt pratico è: 'Traduci questo ICP in filtri espliciti su aziende e persone. Mostrami i filtri, conta le corrispondenze e mostrami l'anteprima di cinque record oscurati. Non mostrare contatti, non arricchire, non creare esportazioni a pagamento e non inviare ad altri sistemi finché non approvo i filtri finali e una spesa massima.' Dopo l'anteprima, chiedi a Claude di indicare l'azione a pagamento prevista, il limite di record e il saldo attuale prima di approvarla.
Per esecuzioni ripetibili, salva l'oggetto filtro approvato e le regole di esclusione. Non salvare un'istruzione generica come 'trova buoni acquirenti', perché un modello futuro o un vocabolario dei dati cambiato potrebbero interpretarla diversamente.
Testa i casi di errore prima di fidarti del caso ideale
Un conteggio che funziona non è una prova completa. Prova una query senza risultati, un filtro volutamente non supportato, una connessione scaduta o revocata, un saldo insufficiente, una richiesta con limite di frequenza e una richiesta di esportazione duplicata. Claude dovrebbe spiegare lo stato e fermarsi, non allargare il pubblico in silenzio o ripetere un'azione a pagamento senza limiti.
Dopo un'esportazione autorizzata, confronta il limite richiesto, le righe restituite, il numero di risultati validi, i crediti addebitati e lo stato del job. Esiti non validi, catch-all, sconosciuti, esclusi e duplicati non dovrebbero essere schiacciati in un unico numero di successo.
Infine, scollega il connettore in Claude e revocalo in Argorant. Conferma che il vecchio token non può più leggere i dati dell'account. La revoca fa parte del test di configurazione, non è un ripensamento amministrativo.
Se preferisci restare nel terminale
Lo stesso flusso è disponibile anche senza un agente in mezzo. La CLI di Argorant è pubblicata su npm (`npx argorant` la avvia senza installare nulla) ed espone ricerca, conteggi, contatti mostrati ed esportazioni come comandi che puoi automatizzare con script. Si autentica sullo stesso account e sullo stesso saldo crediti, quindi un cron job, un passaggio di CI o un'estrazione veloce dalla shell attingono tutti dallo stesso posto.
La CLI è anche il livello pratico di debug per i workflow con agenti: quando vuoi confermare esattamente cosa corrisponde a un filtro prima di inserirlo nelle istruzioni di un agente, un solo comando ti dà la verità.
Perché è meglio del giro tra le dashboard
Il vantaggio strutturale è che iterare diventa quasi gratis, sia in tempo sia in crediti. In uno strumento tradizionale ogni affinamento costa il ricaricamento di una pagina e ogni errore costa un'esportazione. Nel ciclo con l'agente, affinare è una frase e gli errori vengono intercettati nella fase di anteprima, prima che si muova denaro.
Significa anche che la costruzione delle liste si integra con tutto il resto che fa il tuo agente. Claude può estrarre la lista, scrivere il primo messaggio citando il settore di ogni azienda e passare il file al tuo strumento di sequenze: una sola conversazione, con 630.7M contatti in 202 paesi dietro un protocollo che l'agente parla già. Collegalo una volta e smetti di cliccare menu a tendina.
