Connecter Leadscraper à votre IA via MCP

Vous pouvez connecter Leadscraper directement à votre client IA — par exemple Claude (Desktop et Web), ChatGPT (Custom GPTs), Cursor ou votre propre agent. Vous pouvez alors lancer des recherches de leads, vérifier leur statut, récupérer vos leads et consulter votre solde de crédits sans jamais ouvrir Leadscraper — simplement en discutant avec votre IA.

Cela est rendu possible par MCP (Model Context Protocol) — un standard ouvert qui permet aux clients IA de communiquer en toute sécurité avec des outils externes. Leadscraper met à disposition son propre serveur MCP à cet effet.

Ce que vous en retirez

• Recherche directement depuis votre workflow IA. « Trouve-moi 10 menuisiers en Bavière » — et votre IA lance le run dans Leadscraper et vous ramène les résultats.
• Aucun changement d'outil. Recherche, statut et leads se déroulent là où vous travaillez déjà.
• Votre compte, vos règles. Les crédits sont décomptés normalement (1 crédit par lead livré).

Prérequis

• Un compte Leadscraper.
• Un client IA compatible MCP (par ex. Claude.ai, Claude Desktop, ChatGPT ou Cursor).

Méthode 1 – Connecter Claude.ai (Web) via OAuth (le plus rapide)

Pour Claude.ai dans le navigateur, vous n'avez besoin d'aucun token. Toute la procédure prend moins d'une minute.

Étape 1 – Ouvrir la carte Intégrations

1. Connectez-vous sur my.leadscraper.de.
2. Cliquez en haut à droite sur votre profil → Paramètres du compte (Account settings) → Intégrations (Integrations).
3. Sur la carte Leadscraper as MCP server, cliquez sur Se connecter à Claude (Connect to Claude).

Étape 2 – Copier l'URL du serveur et ajouter le connecteur dans Claude

Une fenêtre affiche l'URL de votre serveur MCP (https://mcp.leadscraper.eu/mcp) avec un bouton de copie. Ensuite :

1. Cliquez sur Ouvrir les connecteurs Claude ↗ (Open Claude connectors) – ou ouvrez directement dans Claude Paramètres → Connecteurs → Ajouter un connecteur personnalisé (Settings → Connectors → Add custom connector).
2. Collez l'URL du serveur et confirmez.
3. Claude vous redirige vers une page de consentement (Allow-Screen) Leadscraper – cliquez sur Allow.

Déjà connecté à Leadscraper ? Un seul clic sur la page de consentement suffit alors – aucun mot de passe séparé n'est nécessaire. Si Claude ne vous redirige pas automatiquement, retournez simplement vous-même sur votre onglet Claude – le connecteur y apparaît généralement déjà comme connecté.

Étape 3 – Vérifier la connexion

Demandez par exemple à Claude :

• « Liste mes profils leadscraper »
• « Quel est mon solde de crédits leadscraper ? »

Si Claude répond avec vos véritables données de compte, la connexion est active.

Méthode 2 – Token manuel (Claude Desktop, Cursor, agent personnalisé)

Utilisez cette méthode si vous préférez un token Bearer, ou si votre client ne prend pas (encore) en charge OAuth – par exemple Claude Desktop, Cursor ou vos propres SDK d'agent.

1. Sur la page Intégrations, cliquez à côté de « Se connecter à Claude » sur Générer un token (Generate token).
2. Dans la fenêtre Connecter un client IA (Connect an AI client), saisissez un nom (par ex. « Claude Desktop ») et cliquez sur Générer un token (Generate token).

3. Copiez le token immédiatement et conservez-le en lieu sûr. Pour des raisons de sécurité, il ne vous est affiché qu'une seule fois.
4. Ajoutez-le, avec l'URL du serveur, dans la configuration de votre client.

{
  "mcpServers": {
    "leadscraper": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.leadscraper.eu/mcp",
        "--header",
        "Authorization: Bearer <VOTRE_TOKEN>"
      ]
    }
  }
}

Redémarrez ensuite votre client et vérifiez que l'icône des outils apparaît – la connexion est alors active.

URL du serveur : https://mcp.leadscraper.eu/mcp

Validité du token : les tokens manuels expirent automatiquement au bout de 90 jours. Sur la page Intégrations, un lien Revoke apparaît à côté de chaque token pour le révoquer par anticipation – par exemple s'il n'est plus nécessaire ou pourrait être compromis.

Ce que vous pouvez faire via l'IA

Six outils sont actuellement à votre disposition :

En pratique, vous parlez simplement avec votre IA – par ex. « Lance une recherche d'électriciens à Hambourg et montre-moi les résultats dès qu'ils sont disponibles. » L'IA appelle les outils appropriés en arrière-plan.

Actuellement en lecture + recherche uniquement : les actions qui consomment des crédits supplémentaires pour la recherche de contacts ou qui poussent des données vers un CRM (par ex. connexion à Pipedrive/HubSpot, rédaction d'e-mails d'outreach) sont volontairement désactivées jusqu'à ce qu'une étape de confirmation des dépenses soit disponible. Ces outils seront activés sans que vous ayez à reconfigurer la connexion.

Crédits et sécurité

• Crédits : une recherche consomme des crédits comme d'habitude – un crédit par lead livré. Quel que soit le comportement de votre IA : des limites de protection existent par token/connexion pour éviter tout dérapage involontaire.
• Accès : la connexion accède exclusivement à votre compte, est stockée de façon chiffrée et peut être révoquée à tout moment (Revoke).
• Validité : les connexions OAuth (Claude.ai) durent environ 30 jours et sont renouvelées automatiquement par Claude. Les tokens manuels expirent après 90 jours.
• Messages d'erreur : si un appel d'outil échoue, Claude affiche une raison concrète (par ex. crédits insuffisants, requête invalide) plutôt qu'un message d'erreur générique.
• Votre connexion habituelle n'est pas affectée – la connexion MCP fonctionne entièrement en parallèle.

Dépannage

« Add custom connector » n'accepte pas de champ pour le token ?
C'est normal – le flux de connecteurs personnalisés de Claude fonctionne exclusivement via OAuth. Collez simplement l'URL du serveur et confirmez via la page Allow, aucun token n'est nécessaire.

Il me manque des outils par rapport à avant ?
Si vous étiez précédemment connecté via un token, vous ne voyez peut-être que les six outils listés ci-dessus. Les outils plus gourmands en crédits et les outils de push CRM sont volontairement désactivés jusqu'à ce que l'étape de confirmation des dépenses soit en ligne.

Le connecteur se déconnecte après un jour ?
C'était un problème connu lié à des tokens de courte durée, désormais corrigé – les connexions OAuth durent maintenant environ 30 jours. Si cela continue de se produire quotidiennement chez vous, contactez-nous simplement via le chat intégré à l'application.

Questions fréquentes

Ai-je besoin de connaissances en programmation ?
Pas pour Claude.ai : un clic sur « Se connecter à Claude » suffit, aucun token n'est nécessaire. Pour les autres clients, vous créez un token et l'ajoutez avec l'URL du serveur dans la configuration de votre client.

Que faire si j'ai perdu mon token ?
Pas de problème : révoquez l'ancien via Revoke et créez-en un nouveau. Pour des raisons de sécurité, un token existant ne peut pas être réaffiché.

La simple connexion consomme-t-elle déjà des crédits ?
Non. Seule une recherche ou une recherche de contacts réellement lancée coûte des crédits – exactement comme dans le produit.

Quels clients IA sont pris en charge ?
Claude (Desktop et Web), ChatGPT (Custom GPTs), Cursor et tout autre client compatible MCP, y compris via vos propres SDK d'agent.

Puis-je continuer à utiliser Leadscraper normalement dans le navigateur ?
Oui, sans restriction. MCP est une voie d'accès supplémentaire, pas un remplacement.

Mis à jour le : 31/07/2026