🔌 Guide Installation MCP Apollo, Hunter & Google Sheets

📋 Vue d'ensemble

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

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️⃣ Installation Google Sheets MCP

Étape 1 : Créer un projet Google Cloud Platform (GCP)

1. Aller sur https://console.cloud.google.com/
2. Cliquer Create Project
3. Nom du projet : Claude-UTPLA-MCP
4. Cliquer Create

Étape 2 : Activer Google Sheets API

1. Dans le menu de gauche : APIs & Services → Library
2. Chercher : Google Sheets API
3. Cliquer sur Google Sheets API
4. Cliquer Enable

Étape 3 : Créer des identifiants OAuth 2.0

1. Aller dans APIs & Services → Credentials
2. Cliquer Create Credentials → OAuth client ID
3. Type d'application : Desktop app
4. Nom : Claude Desktop MCP
5. Cliquer Create
6. Télécharger le JSON des identifiants (bouton Download)
7. Renommer le fichier : google-credentials.json
8. Déplacer dans : ~/.config/claude/ (macOS/Linux) ou %APPDATA%\Claude\ (Windows)

Étape 4 : Installer le serveur MCP Google Sheets

Option recommandée : Composio Google Sheets

1. Installer via npm :

npm install -g composio-googlesheets-mcp

2. Configurer Claude Desktop (comme pour Hunter) :

{
  "mcpServers": {
    "hunter": {
      "command": "npx",
      "args": ["-y", "@hunter-io/hunter-mcp"],
      "env": {
        "HUNTER_API_KEY": "ta_clé_hunter"
      }
    },
    "google-sheets": {
      "command": "npx",
      "args": ["-y", "composio-googlesheets-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/Users/TON_NOM/.config/claude/google-credentials.json"
      }
    }
  }
}

3. Remplacer /Users/TON_NOM/ par ton vrai chemin utilisateur
4. Sauvegarder et redémarrer Claude Desktop

Option alternative : mcp-google-sheets (GitHub xing5)

Si Composio ne fonctionne pas, utiliser cette implémentation :

# Cloner le repo
git clone https://github.com/xing5/mcp-google-sheets.git
cd mcp-google-sheets

# Installer les dépendances
npm install

# Configurer dans Claude Desktop
{
  "mcpServers": {
    "google-sheets": {
      "command": "node",
      "args": ["/chemin/vers/mcp-google-sheets/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/Users/TON_NOM/.config/claude/google-credentials.json"
      }
    }
  }
}

Étape 5 : Premier lancement et autorisation OAuth

1. Redémarrer Claude Desktop
2. Démarrer une conversation
3. Taper : "Peux-tu lister mes Google Sheets ?"
4. Claude affiche un lien OAuth → Cliquer dessus
5. Se connecter avec ton compte Google
6. Autoriser l'accès à Google Sheets
7. Revenir dans Claude Desktop

4️⃣ 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

Test Google Sheets MCP

Créer un Google Sheet test "CRM_Test_UTPLA" avec colonnes : Prénom | Nom | Entreprise | Email

Dans Claude Desktop :

1. "Liste mes Google Sheets"
   → Résultat attendu : liste avec CRM_Test_UTPLA

2. "Lis les 5 premières lignes de CRM_Test_UTPLA"
   → Résultat attendu : affichage des données

3. "Ajoute une ligne dans CRM_Test_UTPLA :
    Prénom=Marie, Nom=Martin, Entreprise=Total, Email=marie.martin@totalenergies.com"
   → Résultat attendu : confirmation ajout + nouvelle ligne visible dans Sheets

5️⃣ 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 : Google Sheets MCP OAuth échoue

Solutions :

• ✅ Vérifier chemin GOOGLE_APPLICATION_CREDENTIALS (absolu, pas relatif)
• ✅ Vérifier fichier google-credentials.json bien téléchargé depuis GCP
• ✅ Autoriser "Desktop app" dans GCP OAuth consent screen
• ✅ Supprimer tokens cache : rm ~/.config/claude/google-tokens.json et réessayer

Problème 5 : "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 6 : 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)

6️⃣ Utilisation dans la formation UTPLA

JOUR 1 : Test MCP basique

Tu testeras Google Sheets MCP uniquement (lecture CRM).

JOUR 2 : Enrichissement automatique

Tu utiliseras Hunter MCP pour vérifier emails contacts :

• Ajouter contact manuellement dans Google Sheets
• Claude lit Sheets via MCP
• Claude vérifie email via Hunter MCP
• Claude met à jour Sheets avec résultat (deliverable/risky)

JOUR 3 : CRM complet

Tu combineras Google Sheets + Hunter + Apollo MCPs pour un pipeline automatisé.

📚 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

Google Sheets MCP

• 📖 Composio (recommandé) : https://composio.dev/toolkits/googlesheets/framework/claude-code
• 💻 GitHub xing5/mcp-google-sheets : https://github.com/xing5/mcp-google-sheets
• 💻 GitHub ringo380/claude-google-sheets-mcp : https://github.com/ringo380/claude-google-sheets-mcp
• 🔧 Google Cloud Platform : https://console.cloud.google.com/

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 :

• [ ] Hunter.io MCP installé et testé (vérification 1 email OK)
• [ ] Google Sheets MCP installé et testé (lecture 1 Sheet OK)
• [ ] Clé API Hunter.io sauvegardée dans gestionnaire mots de passe
• [ ] Google Cloud Platform projet créé
• [ ] OAuth Google Sheets autorisé
• [ ] Google Sheet "CRM_Test_UTPLA" créé avec 5 lignes test
• [ ] Claude Desktop redémarré après config MCP
• [ ] Quota Hunter vérifié (25 recherches disponibles)