Alla fine di questa guida il tuo agente AI (Claude, ChatGPT, Cursor, Grok o qualsiasi strumento che parli MCP o HTTP) cercherà tra 630.7 milioni di contatti, conterà i mercati gratis ed esporterà email verificate in autonomia. Faremo tutto il percorso una volta, con calma, segnalando ogni bivio: cosa vedrai quando funziona e cosa significa quando non funziona.
Cosa ti serve prima di iniziare
Parti da un indirizzo email che puoi confermare e da un runtime per agenti supportato. L'abbonamento non è l'unico modo di pagare: le azioni consentite possono usare un portafoglio prepagato.
I nuovi account ricevono una prova di 7 giorni dopo la conferma dell'email: 100 crediti e 300 email di campagna, senza abbonamento automatico; alla scadenza le campagne si mettono in pausa e i crediti di prova non usati scadono finché non aggiungi un piano o crediti a consumo. App, REST API, CLI e MCP condividono lo stesso account e lo stesso saldo; collegare un altro client o creare una chiave API non aggiunge un secondo bonus. Saldi e abbonamenti esistenti non cambiano.
Usa la connessione MCP con OAuth quando il tuo client supporta server MCP remoti personalizzati. Altrimenti usa la CLI da un terminale con Node/npm, oppure REST da un ambiente HTTP autorizzato. Incollare una chiave personale in una chat non crea una connessione né aggira le restrizioni del client.
Ricerca, conteggi e anteprime oscurate non scalano crediti. Valgono comunque i permessi dell'account e i limiti di frequenza.
Richiedi un'approvazione esplicita di ambito, limite di righe e budget di crediti prima di mostrare contatti, arricchire persone o creare una nuova esportazione, e prima di avviare una campagna o inviare una risposta. Le etichette degli strumenti client non garantiscono sempre una conferma; i comandi CLI non interattivi possono spendere subito.
Passaggio 1: crea l'account dal percorso per agenti
Apri app.argorant.com/start. Vedrai due porte: una per lavorare nell'app, una per configurare un agente. Scegli quella dell'agente.
Registrati con una casella permanente e conferma l'indirizzo con il codice che ricevi via email. Qui ci sono due bivi:
- "Starter credits need a permanent email address." Hai usato un dominio di email usa e getta. Usa invece una casella di lavoro o personale; le caselle temporanee non danno mai diritto ai crediti gratuiti.
- L'email di conferma non arriva mai. Controlla prima lo spam, poi richiedi un nuovo codice dalla stessa schermata. I codici scadono e vale solo il più recente.
Passaggio 2: scegli OAuth o crea una chiave API personale
Per l'MCP remoto, collegati con OAuth e il tuo account Argorant; non incollare una chiave personale nell'URL MCP. Per CLI o REST, crea una chiave personale in /start o in Profilo. Una prima chiave idonea può ricevere i crediti iniziali descritti sopra. Controlla il saldo dell'account restituito prima di promettere risultati gratuiti.
La chiave inizia con ag_live_ e viene mostrata per intero una sola volta. Conservala come una password. Se la perdi, revocala e generane una nuova; nient'altro cambia nell'account.
Se la creazione della chiave viene rifiutata con "Starter credits were already claimed for this mailbox", i crediti gratuiti sono già stati usati da un account con lo stesso indirizzo normalizzato (i tag con il segno più e i punti di Gmail non creano nuove caselle). Ricarica il portafoglio o scegli un piano; la chiave viene generata comunque senza problemi.
Passaggio 3: collega il tuo agente
Ci sono due modalità di collegamento: scegli quella che il tuo agente supporta.
Opzione A: MCP (Claude, ChatGPT, Cursor, Grok Bot)
Aggiungi https://mcp.argorant.com/mcp in un client che supporta MCP remoto e OAuth. Accedi e approva i permessi richiesti. Il catalogo attuale ha 104 strumenti per trovare persone, contatti e numeri di telefono, gestire liste ed esportazioni, controllare le tue liste email, campagne, risposte, caselle e crediti. Prima di iniziare, imposta regole esplicite su spesa e risultati.
Opzione B: REST con una chiave personale in un runtime HTTP autorizzato
Ogni endpoint si trova sotto https://app.argorant.com/api/mcp/ con Authorization: Bearer ag_live_.... I tre che userai di continuo:
Passaggio 4: il primo compito reale
Dai all'agente qualcosa di concreto: "Conta i CFO delle aziende fintech tedesche su Argorant, mostrami un campione e dimmi quanto costerebbe esportare i primi 500."
Un'esecuzione corretta restituisce il conteggio reale, anche zero se nessun record corrisponde, un'anteprima oscurata e il costo in crediti applicabile. Un conteggio di contatti non è un conteggio di aziende uniche né la prova che ogni email sia già verificata. In questa fase i dati di contatto restano oscurati di proposito: iniziali, ruolo, azienda, località, ma nessun indirizzo. Non è un bug: è il motivo per cui esplorare non costa nulla.
Passaggio 5: l'esportazione e quanto paghi davvero
Quando la lista ti convince, lascia esportare all'agente. Ora, e solo ora, si muovono i crediti: 1 credito per contatto recapitabile. La verifica avviene in tempo reale al momento dell'esportazione; gli indirizzi che non la superano vengono rimossi e non costano nulla. Un'esportazione di 500 righe in cui 460 indirizzi superano la verifica addebita 460 crediti, e il CSV che scarichi contiene 460 righe recapitabili fino a pochi minuti prima.
I bivi che potresti incontrare:
- 402, "API and MCP access need either a plan or wallet credits." I crediti iniziali sono finiti. Ricarica il portafoglio (500 crediti per $17.50, senza abbonamento) o scegli un piano. Il portafoglio è il percorso pensato per gli agenti: entrano soldi, escono lead, niente di ricorrente.
- 429, limite di frequenza. L'agente sta martellando le API. Portafoglio e piani alzano il tetto; un agente ben costruito raggruppa i conteggi invece di ciclare un filtro alla volta.
- Esportazione più piccola del conteggio. È il comportamento corretto: il conteggio è l'universo delle corrispondenze, l'esportazione è il sottoinsieme recapitabile dopo la verifica in tempo reale e dopo aver tolto le righe che avevi già esportato.
E adesso?
Il tuo agente è collegato e ha prodotto la sua prima lista verificata. La prossima guida insegna la parte che dà frutti nel tempo: costruire una lista di target precisa con filtri per settore, seniority e parole chiave, e lasciare che l'agente allarghi o restringa il mercato su comando.
