docs(mcp): dedicated Leadbay MCP section

.gitbook.yaml

@@ -0,0 +1,5 @@
+root: ./
+
+redirects:
+  product-guides/leadbay-mcp: leadbay-mcp/what-is-leadbay-mcp.md
+  fr/product-guides/leadbay-mcp: fr/leadbay-mcp/what-is-leadbay-mcp.md

README.md

@@ -28,6 +28,6 @@ _Do they hire seasonally? Do they have a CRM? Are they expanding?_
 [ai-assistant.md](product-guides/ai-assistant.md)
 {% endcontent-ref %}
 
-{% content-ref url="product-guides/leadbay-mcp.md" %}
-[leadbay-mcp.md](product-guides/leadbay-mcp.md)
+{% content-ref url="leadbay-mcp/what-is-leadbay-mcp.md" %}
+[what-is-leadbay-mcp.md](leadbay-mcp/what-is-leadbay-mcp.md)
 {% endcontent-ref %}

SUMMARY.md

@@ -13,11 +13,18 @@
 * [Export](product-guides/export.md)
 * [Data Sources](product-guides/data-sources.md)
 * [SFTP Connector](product-guides/sftp-connector.md)
-* [Leadbay MCP for Claude](product-guides/leadbay-mcp.md)
 * [Team & Organization](product-guides/team-management.md)
 * [Manager Dashboard](product-guides/manager-dashboard.md)
 * [Install Mobile App](product-guides/install-mobile-app.md)
 
+## Leadbay MCP
+
+* [What is Leadbay MCP?](leadbay-mcp/what-is-leadbay-mcp.md)
+* [Quickstart](leadbay-mcp/quickstart.md)
+* [Installation](leadbay-mcp/installation.md)
+* [Tools reference](leadbay-mcp/tools-reference.md)
+* [Example prompts](leadbay-mcp/example-prompts.md)
+
 ## Best Practices
 
 * [Leadbay for Sales Reps](overview/best-practice-guides/leadbay-for-sales-reps.md)

fr/README.md

@@ -28,6 +28,6 @@ _Recrutent-ils de manière saisonnière ? Ont-ils un CRM ? Sont-ils en croissanc
 [ai-assistant.md](product-guides/ai-assistant.md)
 {% endcontent-ref %}
 
-{% content-ref url="product-guides/leadbay-mcp.md" %}
-[leadbay-mcp.md](product-guides/leadbay-mcp.md)
+{% content-ref url="leadbay-mcp/what-is-leadbay-mcp.md" %}
+[what-is-leadbay-mcp.md](leadbay-mcp/what-is-leadbay-mcp.md)
 {% endcontent-ref %}

fr/SUMMARY.md

@@ -13,11 +13,18 @@
 * [Export](product-guides/export.md)
 * [Sources de données](product-guides/data-sources.md)
 * [Connecteur SFTP](product-guides/sftp-connector.md)
-* [Leadbay MCP pour Claude](product-guides/leadbay-mcp.md)
 * [Équipe & Organisation](product-guides/team-management.md)
 * [Tableau de bord Manager](product-guides/manager-dashboard.md)
 * [Installer l'application mobile](product-guides/install-mobile-app.md)
 
+## Leadbay MCP
+
+* [Qu'est-ce que Leadbay MCP ?](leadbay-mcp/what-is-leadbay-mcp.md)
+* [Démarrage rapide](leadbay-mcp/quickstart.md)
+* [Installation](leadbay-mcp/installation.md)
+* [Référence des outils](leadbay-mcp/tools-reference.md)
+* [Exemples de prompts](leadbay-mcp/example-prompts.md)
+
 ## Bonnes Pratiques
 
 * [Leadbay pour les commerciaux](overview/best-practice-guides/leadbay-for-sales-reps.md)

fr/leadbay-mcp/example-prompts.md

@@ -0,0 +1,169 @@
+# Exemples de prompts
+
+Leadbay MCP fonctionne mieux quand vous parlez à Claude comme à un collègue — décrivez le résultat, pas l'outil. Voici une bibliothèque de prompts qui fonctionnent d'emblée, regroupés par objectif. Copiez, adaptez, et appropriez-vous-les.
+
+{% hint style="info" %}
+Vous n'avez pas besoin de nommer des outils ou des IDs. « Récupère les leads du jour », « recherche acme.com », « note que j'ai envoyé un email à Jane » — Claude choisit le bon outil. Chaque action est limitée à votre compte ; ce que votre client demande avant chacune dépend de ses réglages d'autorisation des outils.
+{% endhint %}
+
+---
+
+## Commencer votre journée
+
+> *Montre-moi les leads du jour.*
+
+> *Qu'est-ce qu'il y a dans mon inbox ce matin ?*
+
+> *Récupère mes meilleurs nouveaux prospects et dis-moi lesquels valent la peine d'être ouverts en premier.*
+
+> *Donne-moi une vue d'ensemble de ma prospection — où en suis-je, que dois-je faire ensuite ?*
+
+Claude récupère votre lot frais, le classe, et propose une courte liste. Il n'effectue aucune action tant que vous ne le demandez pas.
+
+---
+
+## Relancer & réengager
+
+> *Quels leads dois-je relancer cette semaine ?*
+
+> *Qui ai-je contacté et que je devrais relancer ?*
+
+> *Quel est l'historique complet de ce compte — vaut-il une nouvelle visite ?*
+
+> *Lesquels de mes leads ont acquis une entreprise depuis 2025 ?*
+
+> *Scanne mon portefeuille pour des signaux de levée de fonds.*
+
+Les prompts de scan de portefeuille filtrent vos leads existants par un signal web en une seule passe — pas besoin de rechercher chacun individuellement.
+
+---
+
+## Rechercher une entreprise
+
+> *Parle-moi de jaxpartycompany.com — est-ce un bon fit pour nous ?*
+
+> *Recherche Acme Corp et résume pourquoi ils ont ce score.*
+
+> *Récupère les contacts et la qualification de ce lead.*
+
+Claude renvoie une fiche de recherche avec le score de l'entreprise, pourquoi elle correspond, et le meilleur contact à joindre.
+
+---
+
+## Planifier un déplacement / terrain
+
+> *Je vais à Jacksonville dans 3 jours — planifie mes visites.*
+
+> *Je m'envole pour Berlin jeudi — qui devrais-je rencontrer sur place ?*
+
+> *Montre mes relances autour de Lyon sur une carte.*
+
+> *Donne-moi 3 clients existants, 3 leads qualifiés et 3 nouveaux prospects près de Limoges, sur une seule carte.*
+
+Ces prompts s'affichent sur une carte là où votre client le permet, avec le meilleur contact et une raison en une ligne par étape.
+
+---
+
+## Rédiger & journaliser la prospection
+
+> *Rédige-moi un email de prospection pour JAX PARTY COMPANY LLC.*
+
+> *Écris une accroche d'appel à froid pour Acme — je vends un logiciel de gestion d'interventions.*
+
+> *Je viens d'envoyer un email à Jane chez Acme. Journalise-le comme prospection.*
+
+> *J'ai appelé Acme ce matin et laissé un message vocal — note-le.*
+
+La rédaction est en lecture seule. La journalisation écrit l'activité sur votre compte.
+
+---
+
+## Importer & qualifier une liste
+
+> *J'ai 400 participants à un événement — importe-les et classe les plus prometteurs.*
+
+> *Voici un CSV de domaines. Importe et qualifie le top 50.*
+
+> *Qualifie les 10 meilleurs leads de mon lot.*
+
+> *Où en est mon import ?*
+
+Claude mappe les colonnes de votre fichier, importe les lignes, et peut lancer immédiatement la qualification IA sur les plus prometteuses.
+
+---
+
+## Gérer votre audience (lenses)
+
+> *Montre-moi mes lenses et bascule sur celle de Joinery.*
+
+> *Crée une lens appelée Joinery pour le secteur fintech.*
+
+> *Arrête de me montrer les entreprises de plus de 50 employés.*
+
+> *Je préfère les entreprises de l'UE qui recrutent activement des commerciaux — affine mon audience.*
+
+> *Je veux plus de leads sur cette lens — un lot plus large aujourd'hui.*
+
+Les changements de lens sont réversibles et reflétés immédiatement dans votre prochain pull.
+
+---
+
+## Construire une campagne d'équipe
+
+> *Mets en place une campagne de prospection pour mon équipe.*
+
+> *Crée une campagne pour les leads que je viens de qualifier et ajoute le top 20.*
+
+> *Montre-moi comment progresse la campagne Q3.*
+
+> *Donne-moi la feuille d'appels de la campagne de Lyon.*
+
+Les campagnes persistent un cohorte de leads triés sur le volet que votre équipe peut travailler ensemble.
+
+---
+
+## Gérer les contacts
+
+> *Acme n'a aucun contact — ajoute Jane Doe, VP Eng, voici son LinkedIn.*
+
+> *Épingle Jane Doe comme contact principal sur cette entreprise.*
+
+> *Mets à jour le poste de Jane Doe en SVP Engineering.*
+
+> *Retire Jane Doe — je l'ai ajoutée par erreur.*
+
+---
+
+## Intendance & retours
+
+> *Combien de quota d'enrichissement me reste-t-il ?*
+
+> *Recharge mon quota.*
+
+> *Envoie un feedback à l'équipe : les scores de leads me semblent décalés cette semaine.*
+
+---
+
+## Tout enchaîner
+
+Vous pouvez demander toute une séquence en un seul message, ou la construire tour par tour :
+
+> *Récupère les leads du jour, recherche le meilleur, et rédige-moi un email pour lui.*
+
+> *Montre-moi mes relances près de Madrid, mets-les sur une carte, et prépare la prospection pour les trois plus proches.*
+
+Claude conserve le contexte au fil de la conversation — une fois qu'il a fait remonter un lead, vous pouvez continuer à parler du « meilleur » ou de « cette entreprise » sans vous répéter.
+
+---
+
+## Étape suivante
+
+Nouveau ici ? Commencez par l'aperçu, puis connectez-vous.
+
+{% content-ref url="what-is-leadbay-mcp.md" %}
+[Qu'est-ce que Leadbay MCP ?](what-is-leadbay-mcp.md)
+{% endcontent-ref %}
+
+{% content-ref url="installation.md" %}
+[Installation](installation.md)
+{% endcontent-ref %}

fr/leadbay-mcp/installation.md

@@ -0,0 +1,131 @@
+# Installation
+
+Connecter Leadbay prend environ une minute. Choisissez la voie qui correspond à votre client :
+
+- **Sur Claude (Desktop / Cowork) :** l'**extension `.dxt`** — téléchargez un fichier et double-cliquez pour l'installer. Recommandé.
+- **Sur Claude Code, Cursor ou Codex :** l'**installateur en une commande**. Il fonctionne aussi pour Claude Desktop.
+
+La configuration avancée et les autres clients sont couverts dans le [README Leadbay MCP](https://github.com/leadbay/leadclaw#install).
+
+{% hint style="info" %}
+Le serveur MCP utilise **votre** compte Leadbay, donc toute action prise par Claude est équivalente à ce que vous auriez fait vous-même dans l'application.
+{% endhint %}
+
+---
+
+## Ce dont vous avez besoin
+
+- Un compte Leadbay ([inscrivez-vous ici](https://leadbay.ai/) si vous n'en avez pas)
+- Un assistant IA qui supporte MCP — Claude, Claude Code, Cursor ou Codex
+- Une minute
+
+---
+
+## Sur Claude — extension `.dxt` (recommandé)
+
+Pour **Claude Desktop et Claude Cowork**, la configuration la plus simple est de télécharger un seul fichier d'extension et de double-cliquer dessus. (Vous utilisez Claude Code, Cursor ou Codex ? Passez à l'[installateur en une commande](#installateur-en-une-commande-claude-code-cursor-codex) ci-dessous.)
+
+### Étape 1 — Télécharger la dernière extension
+
+Ouvrez la [page des releases LeadClaw](https://github.com/leadbay/leadclaw/releases/latest) et téléchargez le dernier fichier `.dxt` (cherchez un nom du type `leadbay-X.Y.Z.dxt` dans la section **Assets** de la release).
+
+---
+
+### Étape 2 — Double-cliquer pour installer
+
+**Double-cliquez sur le fichier `.dxt` téléchargé.** Claude s'ouvre avec les détails de l'extension — cliquez sur **Install** pour confirmer, puis basculez l'extension sur **Enabled**. C'est tout.
+
+{% hint style="info" %}
+Vous préférez installer depuis l'application ? Allez dans **Settings → Extensions → Advanced → Install extension** et sélectionnez le fichier `.dxt` au lieu de double-cliquer.
+{% endhint %}
+
+---
+
+### Étape 3 — Se connecter avec Leadbay
+
+La première fois que Claude appelle un outil Leadbay, il déclenche un flux **Se connecter avec Leadbay** en un clic :
+
+1. Une page de connexion Leadbay s'ouvre dans votre navigateur
+2. Connectez-vous (ou confirmez votre session existante)
+3. Cliquez sur **Approuver** pour accorder à Claude l'accès à votre compte
+4. L'onglet du navigateur se ferme tout seul et Claude poursuit la conversation
+
+C'est tout — aucun jeton à générer, copier, coller ou renouveler. La connexion est limitée à votre compte et vous pouvez la révoquer à tout moment depuis **Paramètres → Applications connectées** dans Leadbay.
+
+{% hint style="info" %}
+Si vous avez accès aux instances US et UE de Leadbay, connectez-vous sur l'instance que vous voulez que Claude utilise. Vous pouvez changer plus tard en vous déconnectant de l'extension Leadbay et en vous reconnectant sur l'autre instance.
+{% endhint %}
+
+---
+
+### Étape 4 — Autoriser les outils
+
+Leadbay propose deux familles d'outils :
+
+| Famille | Ce qu'elle contient | Permission recommandée |
+|--------|--------------|------------------------|
+| **Lecture seule** | Récupère leads, lenses, profils, contacts, profil de goût, quota d'enrichissement — ne modifie jamais rien | **Toujours autoriser** |
+| **Écriture / suppression** | Qualifie des leads, enrichit des contacts, ajoute des notes, importe des leads, journalise la prospection, affine l'audience | **Toujours autoriser** |
+
+Les deux familles peuvent être autorisées en permanence sans risque, car le Leadbay MCP est **limité à votre compte** — il n'y a rien de destructeur au niveau de la plateforme. Régler les deux sur « toujours autoriser » permet à Claude de travailler en continu sans vous interrompre à chaque appel.
+
+Pour configurer : dans l'écran **Configure** de l'extension Leadbay, réglez **Always allow** pour le groupe d'outils en lecture seule et pour le groupe en écriture/suppression.
+
+---
+
+## Installateur en une commande (Claude Code, Cursor, Codex)
+
+Pour **Claude Code, Cursor ou Codex**, une seule commande installe Leadbay et vous connecte. Elle fonctionne aussi pour **Claude Desktop** si vous préférez automatiser la configuration plutôt qu'installer le `.dxt` à la main. Il vous faut [Node.js](https://nodejs.org) 22 ou plus récent.
+
+```bash
+npx -y -p @leadbay/mcp@latest installer
+```
+
+Cela ouvre un assistant guidé qui détecte vos clients installés (Claude Desktop, Claude Code, Cursor, Codex), ajoute Leadbay à ceux que vous choisissez, et lance le flux **Se connecter avec Leadbay**.
+
+Pour retirer Leadbay plus tard de tous les clients configurés par l'installateur :
+
+```bash
+npx -y -p @leadbay/mcp@latest installer --uninstall
+```
+
+---
+
+## Vous êtes connecté
+
+C'est tout — Leadbay est configuré. Rendez-vous sur le Démarrage rapide pour votre premier prompt et voir à quoi ressemble un résultat réussi.
+
+{% content-ref url="quickstart.md" %}
+[Démarrage rapide](quickstart.md)
+{% endcontent-ref %}
+
+---
+
+## Utiliser Leadbay avec Claude Desktop
+
+Claude Desktop charge les outils MCP plus lentement que Cowork, donc quelques précautions supplémentaires aident.
+
+Après avoir installé l'extension Leadbay, **quittez complètement et relancez Claude Desktop** (Cmd-Q sur Mac, puis rouvrez — pas seulement fermer la fenêtre). Ouvrez un nouveau chat et attendez environ **30 secondes** avant d'envoyer votre premier message. Cela laisse à Claude le temps de charger les outils Leadbay.
+
+Si votre premier message reçoit une réponse du type *« Je ne vois aucun outil Leadbay »* ou *« Je ne trouve pas Leadbay dans votre configuration »*, pas d'inquiétude — les outils sont encore en train de se charger. Envoyez n'importe quel deuxième message (même juste *« réessaie »*) et Claude les détectera. À partir de là, le reste de votre session fonctionne normalement.
+
+---
+
+## Mise à jour
+
+Pour l'**extension `.dxt`**, quand une nouvelle release sort, répétez l'**Étape 1** (télécharger le nouveau `.dxt`) et l'**Étape 2** (Install extension). Claude remplace l'ancienne version sur place ; votre connexion reste valide, vous n'avez donc pas à vous ré-authentifier.
+
+L'**installateur en une commande** exécute toujours la dernière version — il n'y a rien à mettre à jour.
+
+---
+
+## Dépannage
+
+| Symptôme | Solution |
+|---------|-----|
+| Claude dit « non authentifié » ou erreurs 401 | Votre connexion a peut-être expiré ou été révoquée. Déclenchez n'importe quel outil Leadbay à nouveau et Claude relancera le flux **Se connecter avec Leadbay** |
+| Les outils n'apparaissent pas après l'installation | Vérifiez que l'extension est bien sur **Enabled** dans Settings → Extensions |
+| Les outils apparaissent mais Claude ne les appelle pas | Ouvrez **Configure** et basculez les groupes d'outils sur **Always allow** |
+| Connecté, mais « montre-moi les leads » renvoie une liste vide | Vous êtes bien connecté — il n'y a simplement rien à afficher pour l'instant. Demandez *« montre-moi mes lenses »* pour confirmer quelle audience est active et basculer si besoin, ou vérifiez que vous êtes sur la bonne instance (US vs UE) |
+| Mauvaise instance (aucun lead / erreurs 404) | Déconnectez-vous de l'extension Leadbay et reconnectez-vous sur la bonne instance (US ou UE) |
+| Autre problème | Signalez un bug sur [github.com/leadbay/leadclaw/issues](https://github.com/leadbay/leadclaw/issues) |