Come collegare ZoomInfo a ChatGPT via MCP

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

ZoomInfo + ChatGPT

Dai alla tua AI i dati B2B di ZoomInfo: cerca gratis contatti e aziende per ruolo, livello, settore, dimensione e località, consulta i valori esatti dei filtri che ZoomInfo accetta, controlla il consumo di crediti e arricchisci solo i record che scegli con e-mail, numeri di telefono e dati aziendali.

Prerequisiti

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

ZOOMINFO_CLIENT_ID, ZOOMINFO_CLIENT_SECRET

Step 1 — Ottieni le credenziali

L'accesso API fa parte di un piano ZoomInfo GTM.ai o di un contratto Enterprise con accesso API; ZoomInfo non ha un livello API gratuito. L'app la crea una persona della tua azienda che ha questo accesso.

1. Crea un'app. Su GTM.ai self-serve apri la scheda Developer su https://gtm-studio.zoominfo.com e scegli Create. Con un contratto Enterprise accedi al ZoomInfo Developer Portal su https://developer.zoominfo.com e scegli Create App; se non riesci ad aprirlo, chiedi al tuo amministratore ZoomInfo l'accesso al Developer Portal.
2. Nell'autenticazione scegli Client Credentials Flow (da server a server) e l'utente di integrazione con cui girano le chiamate. Un'app creata per il flusso Authorization Code (PKCE) non accetta questo accesso e risponde unauthorized_client.
3. Seleziona gli scope Contact (api:data:contact), Company (api:data:company) e Lookup (api:data:lookup) e crea l'app.
4. Incolla Client ID e Client Secret in ZOOMINFO_CLIENT_ID e ZOOMINFO_CLIENT_SECRET e installa il connettore. Il connettore li scambia con un token di breve durata e lo rinnova da solo; il secret viene inviato solo a ZoomInfo.
5. Verifica la configurazione con zoominfo_get_usage: mostra i tuoi limiti e quanto resta, senza consumare crediti.

Gratis: ricerca e consultazione: zoominfo_search_contacts, zoominfo_search_companies, zoominfo_lookup_values, zoominfo_list_search_fields, zoominfo_list_enrich_fields e zoominfo_get_usage non consumano crediti; contano solo per i limiti di richieste. Le ricerche di contatti mostrano nomi, ruoli, aziende e se esistono un'e-mail o un numero di telefono, mai l'e-mail o il numero.

L'arricchimento costa crediti, quindi l'AI chiede prima: zoominfo_enrich_contacts e zoominfo_enrich_companies (fino a 25 record per chiamata) consumano 1 credito bulk data per ogni record restituito che non è già in gestione nel tuo account. Un record resta in gestione, e si può arricchire di nuovo gratis, per 12 mesi dal primo arricchimento. Nessuna corrispondenza, nessun costo. Prima di un arricchimento l'AI ti mostra i record trovati, ti dice il costo massimo (un credito per record) e aspetta il tuo sì. Arricchisce pochi record scelti, non un'intera pagina di risultati.

Come funziona: l'AI trasforma prima le tue parole in valori ZoomInfo con zoominfo_lookup_values (settori, livelli manageriali, reparti, funzioni, aree metropolitane, paesi, numero di dipendenti, fasce di fatturato), perché la ricerca rifiuta testo libero che non è un valore noto. Poi cerca, ti mostra le corrispondenze e arricchisce solo quelle che scegli, con i soli campi di output che ti servono. zoominfo_list_enrich_fields mostra quali campi include il tuo piano.

Dati personali, solo per uso B2B: i record dei contatti descrivono persone reali: nomi, ruoli, datori di lavoro, e-mail aziendali, numeri diretti e cellulari. 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 ZoomInfo. Conserva solo ciò che serve, rispetta i flag Do Not Call e il flag UE di ogni record, 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: le ricerche restituiscono fino a 100 record per pagina e al massimo 100 pagine. ZoomInfo consente da 5 a 35 richieste al secondo per tenant, più limiti orari e giornalieri, a seconda del pacchetto. Un 429 significa attendere i secondi indicati da ZoomInfo in Retry-After.

Errori comuni: 400 unauthorized_client all'accesso: il Client ID è sconosciuto, oppure l'app non è stata creata per il flusso client credentials. 401 ZI0001: il token non è valido; se persiste, controlla il client secret. 403 ZI0002: all'app manca lo scope per questa chiamata. 403 ZI0003: il tuo contratto non include questo endpoint o l'accesso API. 400 PFAPI0006: un valore di filtro che ZoomInfo non conosce. 400 PFAPI0001 o PFAPI0009: un campo di output non incluso nel tuo piano, o scritto male. 400 PFAPI0011: hai raggiunto il limite di crediti; chiedi al tuo amministratore ZoomInfo.

Il connettore non modifica mai dati in ZoomInfo. Non copre intent, scoops e news, organigrammi, gerarchie societarie, tecnologie, lookalike, audience, webhook e la vecchia API Enterprise con nome utente e password.

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: ZoomInfo.
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 ZoomInfo ci restano in questo periodo contrattuale?"
• "Trova i responsabili acquisti dei produttori di macchinari in Italia con 200-1.000 dipendenti. Mostra nomi, ruoli e aziende, senza arricchire per ora."
• "Quali aziende software nell'area metropolitana di Milano hanno da 50 a 500 dipendenti e più di 10 milioni di USD di fatturato?"
• "Arricchisci i primi tre contatti di quella lista con e-mail aziendale e numero diretto. Dimmi prima il costo massimo in crediti."
• "Recupera il profilo completo di northwind-logistics.com: settore, numero di dipendenti, fatturato, sede e capogruppo."

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