Come collegare HeyReach a Gemini via MCP

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

HeyReach + Gemini

Outreach LinkedIn con HeyReach da qualsiasi agente AI: gestisci le campagne e aggiungi o ferma i loro lead, cura liste di lead e aziende e i tag dei lead, leggi e rispondi alle conversazioni nell'inbox LinkedIn unificata, controlla account mittenti e collegamenti di 1° grado, confronta le statistiche di outreach e gestisci i webhook. Funziona con una chiave API di HeyReach; le eliminazioni sono disattivate all'installazione.

Prerequisiti

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

HEYREACH_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un workspace HeyReach.

1. In HeyReach apri Integrations e la sezione HeyReach API.
2. Fai clic su Get API Key, poi su New API Key, e copia la chiave in HEYREACH_API_KEY. Le chiavi non scadono ma lì si possono eliminare o disattivare. Una chiave appartiene a un solo workspace.
3. Installa il connettore ed esegui heyreach_check_api_key: risponde 200 con corpo vuoto se la chiave funziona.

La chiave viene inviata nell'header X-API-KEY.

Id: campaign_id viene da heyreach_list_campaigns; gli id dei mittenti (account_id, linkedin_account_id, sender_id) da heyreach_list_linkedin_accounts; list_id da heyreach_list_lists; conversation_id da heyreach_list_conversations; webhook_id da heyreach_list_webhooks. Un lead si identifica con l'URL del profilo LinkedIn (https://www.linkedin.com/in/<slug>/) o con il suo id LinkedIn (linkedin_id nei record dei lead).

Campagne:

• Lettura: heyreach_list_campaigns (filtro per stato o mittente), heyreach_get_campaign, heyreach_get_campaign_sequence (l'albero dei passaggi: richiesta di collegamento, messaggio, InMail, follow, like, visita al profilo, con attese e testi), heyreach_list_campaign_leads e heyreach_get_campaigns_for_lead.
• Controllo: heyreach_start_campaign avvia una bozza che ha sequenza, lista di lead e almeno un mittente LinkedIn collegato; heyreach_pause_campaign e heyreach_resume_campaign la fermano e la riprendono.
• Lead: heyreach_add_leads_to_campaign aggiunge fino a 100 lead per chiamata, eventualmente assegnando un mittente a ciascuno, e può riprendere una campagna in pausa nella stessa chiamata. heyreach_stop_lead_in_campaign ferma un lead, heyreach_update_lead_custom_fields imposta i campi personalizzati usati come variabili nei messaggi.
• Stati delle campagne: DRAFT, IN_PROGRESS, PAUSED, FINISHED, CANCELED, FAILED, STARTING, SCHEDULED. Stati dei lead: Pending, InSequence, Finished, Paused, Failed, Excluded.

Avviando campagne e aggiungendo lead i tuoi account LinkedIn agiscono su profili reali, quindi fatti mostrare prima campagna, mittente e lead.

Liste: heyreach_list_lists, heyreach_get_list, heyreach_list_list_leads, heyreach_list_list_companies, heyreach_get_lists_for_lead, heyreach_create_list (lista vuota di lead o di aziende) e heyreach_add_leads_to_list (fino a 100 lead per chiamata). Una lista non è una campagna: una campagna terminata non prende i nuovi lead della lista; per quello serve heyreach_add_leads_to_campaign.

Lead e tag: heyreach_get_lead legge un profilo dall'URL (nome, headline, azienda, ruolo, località, email, tag, esperienze, formazione). Poi heyreach_get_lead_tags, heyreach_add_lead_tags (mantiene i tag esistenti) e heyreach_replace_lead_tags.

Inbox: heyreach_list_conversations elenca le conversazioni degli account mittenti, dalla più recente, filtrate per mittente, campagna, lead, tag, stato di lettura e periodo. Non restituisce email né campi personalizzati: quelli li dà heyreach_get_lead. heyreach_get_conversation restituisce tutti i messaggi, heyreach_send_message risponde dal mittente a cui appartiene la conversazione e heyreach_set_conversation_seen la segna come letta o non letta. Un messaggio inviato arriva subito al lead su LinkedIn, quindi l'AI ti mostra prima il testo.

Mittenti e rete: heyreach_list_linkedin_accounts e heyreach_get_linkedin_account mostrano limiti, cooldown e stato di Sales Navigator e Recruiter; heyreach_get_linkedin_account_status dice se la sessione LinkedIn è ancora collegata e, se no, perché. heyreach_list_network elenca i collegamenti di 1° grado di un mittente, heyreach_is_connection controlla un lead (URL del profilo o id LinkedIn, non entrambi).

Statistiche: heyreach_get_overall_stats e heyreach_get_stats_by_campaign accettano start_date e end_date (ISO 8601, per esempio 2026-10-01T00:00:00.000Z) e, facoltativi, id di mittenti e campagne. Restituiscono visite al profilo, like, follow, richieste di collegamento inviate e accettate, messaggi e InMail inviati e con risposta, con tassi di accettazione e di risposta.

Webhook: heyreach_list_webhooks, heyreach_get_webhook, heyreach_create_webhook e heyreach_update_webhook. Un tipo di evento per webhook: CONNECTION_REQUEST_SENT, CONNECTION_REQUEST_ACCEPTED, MESSAGE_SENT, MESSAGE_REPLY_RECEIVED, EVERY_MESSAGE_REPLY_RECEIVED, INMAIL_SENT, INMAIL_REPLY_RECEIVED, FOLLOW_SENT, LIKED_POST, VIEWED_PROFILE, CAMPAIGN_COMPLETED, LEAD_TAG_UPDATED.

Disattivati all'installazione: heyreach_delete_leads_from_list e heyreach_delete_webhook. Non si possono annullare, quindi un admin del workspace li attiva quando servono al team.

Formati dei dati: gli orari sono ISO 8601, in UTC salvo offset indicato. Nelle statistiche byDayStats è indicizzato per giorno (UTC) e i tassi sono frazioni (0.23 = 23%).

Paginazione: la maggior parte degli elenchi accetta offset e limit (massimo 100) e restituisce totalCount e items; heyreach_list_list_leads consente fino a 1000 per pagina e heyreach_list_network usa page_size (massimo 100). heyreach_list_conversations usa un cursore (predefinito 10, massimo 100): l'AI ripassa nextCursor come cursor finché è null.

Limiti ed errori comuni: 300 richieste al minuto per chiave; oltre, HeyReach risponde 429. 401 indica una chiave errata o disattivata, 404 un id errato, 400 un corpo non valido, per esempio il nome di un campo personalizzato con caratteri diversi da lettere, cifre e trattini bassi.

Creare campagne, collegare account LinkedIn (password, cookie, proxy) e gestire l'organizzazione sono esclusi di proposito: si fanno nell'app di HeyReach.

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 HeyReach.

Tool disponibili

Esempi di prompt

• "Com'è andato il nostro outreach LinkedIn il mese scorso? Mostra richieste di collegamento inviate e accettate e il tasso di risposta per campagna."
• "Mostrami le conversazioni LinkedIn non lette degli ultimi 3 giorni con nome del lead e ultimo messaggio."
• "Aggiungi questi tre profili LinkedIn alla campagna Founders DACH e dimmi quanti sono stati aggiunti."
• "In questo momento uno dei nostri account mittenti LinkedIn è scollegato?"
• "In quali campagne si trova https://www.linkedin.com/in/jane-doe e con quale stato in ciascuna?"

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
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot