Come collegare RocketReach a ChatGPT via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → RocketReach, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

RocketReach + ChatGPT

Dai alla tua AI i dati B2B di RocketReach: cerca persone e aziende per nome, ruolo, datore di lavoro, località, settore e dimensione, controlla i crediti e recupera e-mail, numeri di telefono e profili aziendali solo per i record che scegli.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

ROCKETREACH_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi su https://rocketreach.co con un account che ha l'accesso API (un piano API o un piano che include chiamate API).
2. Apri Account Settings → API su https://rocketreach.co/account?section=nav_gen_api e scegli Generate New API Key, oppure copia la chiave esistente.
3. Incollala in ROCKETREACH_API_KEY e installa il connettore. La chiave viene inviata nell'header Api-Key, solo a RocketReach.
4. Verifica la configurazione con rocketreach_get_account: mostra i crediti per tipo e i limiti di richieste, senza consumare crediti.

Gratis: ricerca: rocketreach_search_people, rocketreach_search_companies, rocketreach_get_account e rocketreach_check_lookup_status non consumano crediti; le ricerche contano solo per i limiti di ricerca. I risultati non contengono e-mail né numeri di telefono, solo un teaser (domini e-mail e numeri mascherati) che indica se un lookup troverà qualcosa.

I lookup costano crediti, quindi l'AI chiede prima: rocketreach_lookup_person consuma un credito lookup e un credito person export quando trova dati di contatto (un lookup premium se trova un'e-mail di qualità massima o un numero valido, uno standard se trova solo un'e-mail). Nessun dato trovato, nessun costo, e ripetere più tardi il lookup della stessa persona è gratis finché il piano è attivo. rocketreach_lookup_company consuma un credito company export; i lookup di aziende non sono inclusi in tutti i piani. Entrambi aggiungono il record a My Contacts o My Companies in RocketReach. Prima di un lookup l'AI ti mostra chi o cosa cercherà e che costa crediti, e aspetta il tuo sì.

Come funziona: l'AI cerca con facet come ruolo attuale, datore di lavoro, località, settore, dimensione e fatturato dell'azienda (per esempio {"current_title": ["CFO"], "geo": ["Italy"]}), ti mostra le corrispondenze e fa il lookup solo delle persone che scegli, per id RocketReach, URL LinkedIn, e-mail, o nome più datore di lavoro attuale. Un lookup di persona richiede spesso qualche secondo: l'AI controlla lo stato gratuitamente finché non è completo. Un lookup di azienda restituisce il profilo completo: dominio, indirizzo, telefono, numero di dipendenti, fatturato, settore, codici SIC e NAICS, tecnologie, concorrenti, organico per reparto e crescita.

Dati personali, solo per uso B2B: i lookup di persone restituiscono indirizzi e-mail di lavoro e privati e numeri di telefono di persone reali. Usali solo per uno scopo aziendale legittimo che puoi giustificare, come vendite B2B o recruiting sulla base del legittimo interesse, nel rispetto del GDPR, del CAN-SPAM e delle condizioni di RocketReach. Per i contatti commerciali preferisci le e-mail professionali, conserva solo ciò che serve, non creare liste per invii di massa e non cercare privati cittadini. Il connettore dà all'AI le stesse regole.

Pagine e limiti di richieste: una pagina contiene fino a 100 record e una ricerca arriva al massimo a 10.000. RocketReach consente 10 richieste al secondo su tutta l'API, più limiti al minuto, orari, giornalieri e mensili per ricerca e lookup a seconda del piano. Un 429 indica l'attesa in Retry-After.

Errori comuni: 401: la chiave API è errata o mancante. 403: la chiave non ha il permesso per questa chiamata, i crediti lookup sono esauriti, il piano non include i lookup di aziende, oppure una verifica di stato riguardava un profilo che non è tra i tuoi contatti. 400: un parametro o un facet non valido. 404: il profilo o l'azienda non esiste.

Universal Credits: RocketReach sta passando alcuni clienti agli Universal Credits, che usano endpoint separati. Questo connettore usa gli endpoint standard; se le chiamate falliscono su un account Universal Credits, chiedi a RocketReach quali endpoint può usare il tuo account.

Il connettore non copre lookup in blocco, lookup combinati di persone e aziende, verifica delle e-mail, webhook e rotazione delle chiavi API.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca + e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: RocketReach.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Tool disponibili

Esempi di prompt

• "Quanti crediti lookup ci restano su RocketReach?"
• "Trova i CFO di aziende di logistica in Italia con 201-500 dipendenti. Mostra nomi, ruoli, aziende e il teaser, senza lookup per ora."
• "Recupera i dati di contatto delle prime due persone della lista. Dimmi quanto costa prima di procedere."
• "Quali produttori di macchinari in Lombardia hanno da 51 a 200 dipendenti?"
• "Recupera il profilo completo di northwind-logistics.com: dipendenti, fatturato, tecnologie e concorrenti. Chiedimi prima di spendere il credito."

FAQ

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse