Come collegare Lusha a Gemini via MCP

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

Lusha + Gemini

Dai alla tua AI i dati B2B di Lusha: trova contatti e aziende per nome, e-mail, URL LinkedIn o dominio, fai prospecting per ruolo, livello, settore, dimensione e località, controlla i crediti e rivela e-mail, numeri di telefono e dati aziendali solo per i record che scegli. Legge anche i segnali su cambi di lavoro e aziende.

Prerequisiti

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

LUSHA_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi a Lusha con un account che ha l'accesso API. Solo gli admin dell'account e i manager con accesso API vedono la pagina API.
2. Apri API → Manage API Keys su https://dashboard.lusha.com/api/manage-api-keys e crea o copia una chiave.
3. Incollala in LUSHA_API_KEY e installa il connettore. La chiave viene inviata nell'header api_key, solo a Lusha.
4. Verifica la configurazione con lusha_get_account_usage: mostra i crediti rimasti e il prezzo di ogni azione, senza consumare crediti.

Le chiamate che restituiscono record costano crediti, quindi l'AI chiede prima: la Lusha API v3 addebita il pool di crediti del tuo account per ogni chiamata che restituisce dati, ricerche comprese. I prezzi dipendono dal piano, e lusha_get_account_usage li elenca per azione (ricerca, reveal di aziende, e-mail, telefono e così via).

• Gratis: lusha_get_account_usage (al massimo 5 chiamate al minuto), lusha_list_filters, lusha_get_filter_values, lusha_list_signal_types e la verifica di un job di arricchimento con lusha_get_enrich_job.
• Un piccolo addebito per ogni risultato trovato (nulla se non trova niente): lusha_search_contacts, lusha_search_companies, lusha_prospect_contacts e lusha_prospect_companies. Restituiscono anteprime senza e-mail né numeri di telefono, più ciò che un arricchimento rivelerebbe e quanto costerebbe.
• Più crediti: lusha_enrich_contacts (per ogni e-mail e ogni numero rivelato; un numero di solito costa diverse volte un'e-mail), lusha_enrich_companies (per azienda), e lusha_get_contact_signals e lusha_get_company_signals (per ogni segnale trovato).

Prima di ogni chiamata a pagamento l'AI ti dice cosa eseguirà, per quanti record e quanto può costare, e aspetta il tuo sì. Tiene piccole le pagine di risultati e rivela solo i campi che ti servono: solo le e-mail costano meno di e-mail e telefoni.

Come funziona: per persone e aziende che conosci già, l'AI cerca per id Lusha, URL LinkedIn, e-mail, nome più azienda, oppure nome e dominio dell'azienda. Per nuovi prospect legge prima i valori validi dei filtri (livello, reparti, settori, dimensioni aziendali, fatturato, località, tecnologie) e poi cerca con filtri di inclusione ed esclusione. Dopo che hai scelto i record, li arricchisce per id Lusha, fino a 100 alla volta. Quando Lusha risponde con un job per dati che arrivano più tardi, l'AI attende e legge il job gratuitamente.

Segnali: cambi di lavoro e promozioni dei contatti, e picchi di assunzioni, variazioni dell'organico, traffico web, spesa IT, notizie e variazioni di intent delle aziende. lusha_list_signal_types li elenca gratis; leggere i segnali costa crediti per ogni corrispondenza.

Dati personali, solo per uso B2B: i record dei contatti descrivono persone reali: nomi, ruoli, datori di lavoro, indirizzi e-mail di lavoro e privati, numeri di cellulare e diretti. 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 Lusha. Conserva solo ciò che serve, rispetta il flag do-not-call sui numeri e il flag UE sui contatti, non creare liste per invii di massa e non cercare privati cittadini. Lusha stessa trattiene alcune persone per motivi legali (HTTP 451 o COMPLIANCE_RESTRICTED). Il connettore dà all'AI le stesse regole.

Limiti di richieste: di default 25 richieste al secondo per account, più quote orarie e giornaliere secondo il piano. Un 429 significa attendere e riprovare.

Errori comuni: 401: la chiave è errata, revocata o mancante. 402: crediti esauriti. 403: l'account è inattivo o il piano non include una funzione. 400: un valore di filtro o un parametro non valido, indicato nella risposta. 451: Lusha non può restituire questa persona per motivi legali. Anche una risposta riuscita può segnare singoli record come non trovati, limitati o non riusciti.

Il connettore non modifica mai dati in Lusha. Non cerca e arricchisce in un'unica chiamata (salterebbe la tua conferma) e non copre lookalike, buying group, scoring, visitatori del sito, export verso il CRM, webhook e i vecchi endpoint v2.

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Lusha.

Tool disponibili

Esempi di prompt

• "Quanti crediti Lusha ci restano, e quanto costa nel nostro piano rivelare un'e-mail o un numero di telefono?"
• "Trova i responsabili marketing di aziende SaaS in Italia con 51-500 dipendenti. Mostrami una piccola pagina di anteprime e dimmi prima quanto costa la ricerca."
• "Rivela solo le e-mail di lavoro dei primi due contatti. Dimmi il costo in crediti prima di procedere."
• "Controlla picchi di assunzioni e variazioni dell'organico su acme.com, northwind.com e contoso.com. Dimmi prima il costo."
• "Qualcuno di questi cinque contatti ha cambiato lavoro o è stato promosso di recente?"

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT