> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.leadscraper.eu/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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).

![Le bouton « Connect to Claude » démarre le flux OAuth – aucun token n'est nécessaire pour Claude.ai.](https://public.deimann.io/img/help-ls/mcp_connect_step-01.png)

### É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).

![Le bouton « Generate token » crée un token nommé (par ex. « Claude Desktop ») – il n'est affiché qu'une seule fois.](https://public.deimann.io/img/help-ls/mcp_connect_step-02.png)

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.

```json
{
  "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 :

| Outil | Ce qu'il fait |
|---|---|
| **list_profiles** | Liste vos profils de recherche. |
| **create_profile** | Crée un nouveau profil de recherche. |
| **create_lead_search** | Lance une nouvelle recherche de leads pour un profil existant. |
| **get_search_status** | Indique si un run en cours est déjà terminé. |
| **list_leads** | Récupère les leads d'un profil – avec les mêmes données que dans le produit. |
| **get_credit_balance** | Affiche votre solde de crédits actuel. |

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.