🔌 Guide Installation MCP Apollo & Hunter

📋 Vue d'ensemble

Les MCP (Model Context Protocol) permettent à Claude Desktop de se connecter directement à des outils externes comme Apollo.io et Hunter.io.

1️⃣ Installation Apollo.io MCP

Étape 1 : Activer Apollo.io dans Claude Desktop

1. Ouvrir Claude Desktop
2. Aller dans Settings (⚙️ en haut à droite)
3. Cliquer sur Customize
4. Section Connectors → Chercher Apollo.io
5. Cliquer sur Configure à côté de Apollo.io
6. Une fenêtre OAuth s'ouvre → Cliquer Authorize
7. Se connecter avec ton compte Apollo.io
8. Accepter les permissions demandées
9. Revenir dans Claude Desktop

Étape 2 : Vérifier l'installation

1. Démarrer une nouvelle conversation dans Claude Desktop
2. Taper : "Trouve-moi 5 directeurs marketing dans le secteur biodiversité en France avec Apollo"
3. Si Claude répond avec des résultats Apollo (noms, emails, entreprises), c'est ✅ OK !

Étape 3 : Vérifier ton quota Apollo

1. Aller sur https://app.apollo.io/#/settings/credits
2. Vérifier Email Credits disponibles
3. Plan gratuit : 50 crédits/mois (1 crédit = 1 enrichissement contact)

2️⃣ Installation Hunter.io MCP

Étape 1 : Récupérer ta clé API Hunter.io

1. Aller sur https://hunter.io/api-keys
2. Se connecter avec ton compte Hunter.io
3. Copier la clé API (format : abc123def456...)
4. ⚠️ Ne JAMAIS partager cette clé

Étape 2 : Installer le serveur MCP Hunter.io

Option A : Installation via Claude Desktop (recommandée)

1. Ouvrir Claude Desktop
2. Aller dans Settings (⚙️ en haut à droite)
3. Cliquer sur Developer
4. Section MCP Servers → Cliquer Edit Config
5. Ajouter cette configuration dans le fichier JSON :

{
  "mcpServers": {
    "hunter": {
      "command": "npx",
      "args": ["-y", "@hunter-io/hunter-mcp"],
      "env": {
        "HUNTER_API_KEY": "COLLE_TA_CLÉ_API_ICI"
      }
    }
  }
}

6. Remplacer COLLE_TA_CLÉ_API_ICI par ta vraie clé API Hunter
7. Sauvegarder le fichier (Cmd+S ou Ctrl+S)
8. Redémarrer Claude Desktop

Option B : Installation manuelle (développeurs)

Si tu es à l'aise avec le terminal :

# Installer le package npm
npm install -g @hunter-io/hunter-mcp

# Ou utiliser npx (sans installation globale)
npx @hunter-io/hunter-mcp

Étape 3 : Vérifier l'installation

1. Ouvrir Claude Desktop
2. Démarrer une nouvelle conversation
3. Taper : "Peux-tu vérifier l'email contact@utpla.fr avec Hunter.io ?"
4. Si Claude répond avec des infos Hunter (deliverability, score), c'est ✅ OK !

3️⃣ Tests de validation

Test Apollo.io MCP

Dans Claude Desktop, essayer ces commandes :

1. "Trouve 5 directeurs marketing dans le secteur biodiversité en France avec Apollo"
   → Résultat attendu : liste 5 contacts (nom, poste, entreprise, email)

2. "Recherche des entreprises RSE à Paris avec Apollo"
   → Résultat attendu : liste entreprises avec données enrichies

3. "Enrichis ce contact avec Apollo : prénom=Marie, nom=Dubois, entreprise=Veolia"
   → Résultat attendu : email + LinkedIn + poste exact + localisation

Test Hunter.io MCP

Dans Claude Desktop, essayer ces commandes :

1. "Vérifie l'email contact@utpla.fr avec Hunter"
   → Résultat attendu : deliverability status + score

2. "Trouve l'email du CEO de Lafarge (France)"
   → Résultat attendu : email + nom + poste

3. "Enrichis le contact : Prénom=Jean, Nom=Dupont, Entreprise=Airbus"
   → Résultat attendu : email + LinkedIn + poste exact

4️⃣ Troubleshooting (Problèmes courants)

Problème 1 : Apollo MCP ne se connecte pas

Solutions :

• ✅ Vérifier que Apollo.io est bien activé dans Settings → Customize → Connectors
• ✅ Cliquer sur "Configure" à côté d'Apollo.io et refaire l'autorisation OAuth
• ✅ Redémarrer Claude Desktop après activation
• ✅ Vérifier quota Apollo (aller sur app.apollo.io/settings/credits)
• ✅ Si erreur "OAuth failed", déconnecter et reconnecter ton compte Apollo dans Claude

Problème 2 : Quota Apollo dépassé

Solutions :

• ⏰ Attendre le 1er du mois suivant (reset automatique)
• 💰 Upgrader vers plan payant Apollo ($49/mois = 500 crédits)
• 🎯 Utiliser Apollo uniquement pour prospects qualifiés (pas de tests aléatoires)
• 📊 Activer notifications quota dans app.apollo.io pour anticiper

Problème 3 : Hunter MCP ne répond pas

Solutions :

• ✅ Vérifier clé API Hunter (pas de quotes " dans le JSON config)
• ✅ Redémarrer Claude Desktop
• ✅ Tester clé API directement : curl "https://api.hunter.io/v2/email-verifier?email=test@example.com&api_key=TA_CLÉ"
• ✅ Vérifier quota Hunter (25 recherches/mois max plan gratuit)

Problème 4 : "npx command not found"

Solutions :

• ✅ Installer Node.js : https://nodejs.org/ (version LTS recommandée)
• ✅ Vérifier installation : node --version et npm --version
• ✅ Redémarrer terminal après installation Node.js

Problème 5 : Quota dépassé Hunter.io

Solutions :

• ⏰ Attendre le 1er du mois suivant (reset automatique)
• 💰 Upgrader vers plan payant Hunter ($49/mois = 500 recherches)
• 🎯 Utiliser Hunter uniquement pour leads qualifiés (pas de tests aléatoires)

5️⃣ Utilisation dans la formation UTPLA

JOUR 1 : Test MCP basique

Tu testeras Apollo MCP uniquement (recherche prospects).

JOUR 2 : Automation Make.com

Tu utiliseras Make.com pour automatiser l'enrichissement de contacts :

• Connexion native Make.com → Google Sheets (lecture/écriture CRM)
• Connexion native Make.com → Hunter.io (vérification emails)
• Connexion native Make.com → Apollo.io (enrichissement contacts B2B)
• Workflow automatisé : nouveau contact ajouté → enrichissement Apollo → vérification Hunter → mise à jour Sheets

JOUR 3 : Pipeline complet Claude + Make.com

Tu combineras Claude Desktop (Apollo MCP) + Make.com (Hunter + Sheets) pour un pipeline commercial automatisé.

6️⃣ Ressources officielles

Apollo.io MCP

• 📖 Documentation : https://www.anthropic.com/news/claude-desktop-connectors
• 🔧 Dashboard Apollo : https://app.apollo.io/
• 📊 Gestion quota : https://app.apollo.io/#/settings/credits
• 💡 Base de données : 230M+ contacts B2B, 70M+ entreprises

Hunter.io MCP

• 📖 Documentation : https://hunter.io/blog/hunter-mcp-server-bringing-ai-and-b2b-data-together/
• 💻 GitHub officiel : https://github.com/hunter-io/hunter-mcp
• 🔑 API Keys : https://hunter.io/api-keys

Model Context Protocol (MCP)

• 📖 Documentation officielle Anthropic : https://www.anthropic.com/news/model-context-protocol
• 💻 MCP Servers GitHub : https://github.com/modelcontextprotocol/servers
• 🌐 Liste MCP communautaires : https://mcpservers.org/

✅ Checklist finale

Avant le JOUR 1 de la formation :

• [ ] Apollo.io MCP installé et testé (recherche 5 prospects OK)
• [ ] Hunter.io MCP installé et testé (vérification 1 email OK)
• [ ] Clé API Hunter.io sauvegardée dans gestionnaire mots de passe
• [ ] Claude Desktop redémarré après config MCP
• [ ] Quota Apollo vérifié (50 crédits disponibles)
• [ ] Quota Hunter vérifié (25 recherches disponibles)