diff --git a/.gitbook.yaml b/.gitbook.yaml
new file mode 100644
index 0000000..9465914
--- /dev/null
+++ b/.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
diff --git a/README.md b/README.md
index 9d7c9f8..dcf1821 100644
--- a/README.md
+++ b/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 %}
diff --git a/SUMMARY.md b/SUMMARY.md
index a233ff1..1e24ae0 100644
--- a/SUMMARY.md
+++ b/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)
diff --git a/fr/README.md b/fr/README.md
index a26c6f8..3cd28e3 100644
--- a/fr/README.md
+++ b/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 %}
diff --git a/fr/SUMMARY.md b/fr/SUMMARY.md
index d1be698..dc55b8e 100644
--- a/fr/SUMMARY.md
+++ b/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)
diff --git a/fr/leadbay-mcp/example-prompts.md b/fr/leadbay-mcp/example-prompts.md
new file mode 100644
index 0000000..4157358
--- /dev/null
+++ b/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 %}
diff --git a/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md
new file mode 100644
index 0000000..a9a6f2d
--- /dev/null
+++ b/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) |
diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md
new file mode 100644
index 0000000..07b5114
--- /dev/null
+++ b/fr/leadbay-mcp/quickstart.md
@@ -0,0 +1,86 @@
+# Démarrage rapide
+
+Connectez Leadbay à Claude et obtenez vos premiers leads qualifiés en environ cinq minutes. C'est la voie rapide — choisissez votre client, installez, connectez-vous, et demandez. Les options détaillées et le dépannage sont dans le guide d'[Installation](installation.md).
+
+{% hint style="info" %}
+Il vous faut un [compte Leadbay](https://leadbay.ai/) et un assistant IA qui supporte MCP (Claude Desktop, Claude Cowork, Claude Code ou Cursor — Codex aussi). C'est tout — aucun jeton d'API à copier ou coller. _Le support de ChatGPT arrive bientôt._
+{% endhint %}
+
+---
+
+## Étape 1 — Installer
+
+Choisissez la voie qui correspond à votre client. Les détails complets sont dans le guide d'[Installation](installation.md).
+
+**Sur Claude (Desktop / Cowork) — extension `.dxt`** (recommandé) : téléchargez le dernier `leadbay-X.Y.Z.dxt` depuis la [page des releases LeadClaw](https://github.com/leadbay/leadclaw/releases/latest), puis **double-cliquez dessus** pour l'installer dans Claude.
+
+**Sur Claude Code, Cursor ou Codex — installateur en une commande** (nécessite [Node.js](https://nodejs.org) 22+). Il fonctionne aussi pour Claude Desktop :
+
+```bash
+npx -y -p @leadbay/mcp@latest installer
+```
+
+---
+
+## Étape 2 — Se connecter (cela se fait automatiquement)
+
+Vous ne configurez rien à la main. Dès que vous installez — ou la première fois que Claude utilise un outil Leadbay — une page **Se connecter avec Leadbay** **s'ouvre automatiquement dans votre navigateur** :
+
+1. La page de connexion Leadbay apparaît d'elle-même.
+2. Connectez-vous (ou confirmez votre session existante).
+3. Cliquez sur **Approuver** pour relier Claude à votre compte.
+4. L'onglet se ferme tout seul et Claude est prêt.
+
+C'est toute la connexion. Aucun jeton, aucun fichier de config. Claude est désormais relié à **votre** compte, avec tous les leads et lenses que vous avez déjà dans Leadbay. Vous pouvez révoquer l'accès à tout moment depuis **Paramètres → Applications connectées**.
+
+{% hint style="info" %}
+Si vous avez à la fois un compte US et UE, connectez-vous sur l'instance que vous voulez que Claude utilise. Vous pouvez changer plus tard en vous déconnectant puis en vous reconnectant sur l'autre instance.
+{% endhint %}
+
+---
+
+## Étape 3 — Demandez vos premiers leads
+
+Ouvrez une nouvelle conversation et tapez :
+
+> *Montre-moi les leads du jour et dis-moi lesquels valent la peine d'être ouverts en premier.*
+
+Claude appelle vos outils Leadbay et répond avec une courte liste classée — entreprise, pourquoi elle correspond, et le meilleur contact à joindre.
+
+---
+
+## Étape 4 — Ce que vous devriez voir
+
+Une première réponse réussie ressemble à un **tableau de leads classés**, pas à un pavé de texte. Pour chaque lead vous obtenez :
+
+- un **score** (à quel point il correspond à votre audience),
+- une **raison** en une ligne,
+- le **meilleur contact** avec un lien quand il est disponible.
+
+Si Claude répond avec des leads comme ça, vous êtes complètement connecté. 🎉
+
+---
+
+## Étape 5 — Continuez
+
+Une fois vos premiers leads affichés, essayez ceci :
+
+> *Recherche le meilleur pour moi — est-ce un bon fit ?*
+
+> *Rédige-moi un email de prospection pour lui.*
+
+> *Je viens de lui envoyer un email. Journalise-le comme prospection.*
+
+Claude se souvient des leads qu'il a fait remonter, vous pouvez donc continuer à parler du « meilleur » sans vous répéter.
+
+---
+
+## Et ensuite
+
+{% content-ref url="example-prompts.md" %}
+[Exemples de prompts](example-prompts.md)
+{% endcontent-ref %}
+
+{% content-ref url="tools-reference.md" %}
+[Référence des outils](tools-reference.md)
+{% endcontent-ref %}
diff --git a/fr/leadbay-mcp/tools-reference.md b/fr/leadbay-mcp/tools-reference.md
new file mode 100644
index 0000000..df0900a
--- /dev/null
+++ b/fr/leadbay-mcp/tools-reference.md
@@ -0,0 +1,156 @@
+# Référence des outils
+
+Quand vous connectez Leadbay à Claude, le serveur expose un ensemble d'**outils** que Claude appelle pour vous. Vous ne les appelez jamais directement — vous demandez en langage naturel (« récupère les leads du jour », « recherche acme.com », « note que j'ai envoyé un email à Jane ») et Claude choisit le bon outil. Cette page est une référence de ce qui est disponible et de ce que fait chaque outil.
+
+Les outils se répartissent en deux groupes : **lecture seule** (récupèrent des données, ne modifient jamais rien) et **écriture / activation** (effectuent une action sur votre compte).
+
+---
+
+## Outils en lecture seule
+
+Ils ne modifient jamais votre compte, on peut donc les autoriser sans risque.
+
+### Découvrir & relancer
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_pull_leads` | Récupère le lot de leads frais du jour, scoré et classé |
+| `leadbay_pull_followups` | Récupère les leads qui nécessitent une action de relance |
+| `leadbay_account_status` | Vérifie votre quota, vos crédits et l'état de votre compte |
+| `leadbay_scan_portfolio_signals` | Scanne vos leads existants pour un signal web en une seule passe (« lesquels de mes leads ont acquis une entreprise depuis 2025 ? ») — sans consommer de quota |
+
+### Rechercher une entreprise
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_research_lead_by_id` | Fiche de recherche détaillée pour un lead connu — regroupe détails, qualification et contacts dans une seule réponse |
+| `leadbay_research_lead_by_name_fuzzy` | Retrouve un lead par nom d'entreprise ou domaine quand vous n'avez pas son ID |
+| `leadbay_account_history` | Historique complet d'un compte — signaux IA actuels + toutes les notes + chronologie des interactions, en un seul appel (« pourquoi ce compte est-il revenu ? ») |
+| `leadbay_prepare_outreach` | Génère un brief de prospection personnalisé pour un lead |
+
+### Déplacements & terrain
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_followups_map` | Regroupe vos relances sur une carte pour planifier vos déplacements |
+| `leadbay_tour_plan` | Construit un itinéraire de visites pour un déplacement à venir dans une ville |
+
+### Campagnes
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_list_campaigns` | Liste vos campagnes existantes |
+| `leadbay_campaign_progression` | Affiche les métriques de funnel d'une campagne |
+| `leadbay_campaign_call_sheet` | Récupère la feuille d'appels d'une campagne |
+
+### Lenses & audience
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_list_sectors` | Liste les vrais libellés de la taxonomie de secteurs — pour que vous (et Claude) nommiez les secteurs correctement |
+| `leadbay_recall_ordered_titles` | Rappelle les intitulés de poste que vous avez déjà enrichis |
+| `leadbay_seed_candidates` | Surface de découverte en lecture seule pour construire une lens plus large |
+
+### Imports & jobs
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_import_status` | Vérifie l'état d'un job d'import |
+| `leadbay_qualify_status` | Vérifie l'état d'un job de qualification |
+| `leadbay_bulk_enrich_status` | Vérifie l'état d'un job d'enrichissement |
+| `leadbay_resolve_import_rows` | Fait correspondre les lignes importées à leurs IDs de lead |
+| `leadbay_list_mappable_fields` | Liste les champs CRM sur lesquels mapper un import |
+
+### Facturation
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_create_topup_link` | Génère un lien Stripe pour recharger votre quota (vous payez dans votre navigateur — rien n'est débité automatiquement) |
+| `leadbay_open_billing_portal` | Ouvre votre tableau de bord de facturation |
+
+---
+
+## Outils d'écriture / activation
+
+Ils effectuent une action sur votre compte. Activés par défaut. Chaque action est une action que vous pourriez effectuer vous-même dans l'application — il n'y a rien de destructeur au niveau de la plateforme.
+
+### Qualifier & enrichir
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_bulk_qualify_leads` | Déclenche la qualification IA sur un lot de leads |
+| `leadbay_enrich_titles` | Enrichit les contacts par intitulé de poste |
+
+### Prospection & activité
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_report_outreach` | Journalise une action de prospection (appel, email, rendez-vous) sur un lead |
+| `leadbay_add_note` | Ajoute une note à un lead |
+| `leadbay_like_lead` | Marque un lead comme aimé — entraîne votre profil de goût |
+| `leadbay_dislike_lead` | Marque un lead comme rejeté — entraîne votre profil de goût |
+
+### Contacts
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_add_contact` | Ajoute une personne à une entreprise (nom + LinkedIn / poste / email / téléphone optionnels) |
+| `leadbay_remove_contact` | Supprime un contact que vous avez ajouté |
+| `leadbay_pin_contact` | Épingle un contact comme priorité sur une entreprise |
+| `leadbay_unpin_contact` | Désépingle un contact |
+| `leadbay_update_contact` | Modifie les détails d'un contact (poste, email, LinkedIn…) |
+
+### Lenses & audience
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_my_lenses` | Liste, change, renomme ou supprime vos lenses |
+| `leadbay_new_lens` | Crée une lens nommée avec des critères de secteur / taille d'entreprise |
+| `leadbay_adjust_audience` | Modifie l'audience d'une lens (« arrête de me montrer les entreprises de plus de 50 employés ») |
+| `leadbay_extend_my_lens` | Remplit votre lens actuelle avec plus de leads à la demande (soumis à un quota de recharge quotidien) |
+| `leadbay_refine_prompt` | Affine le prompt de qualification qui score vos leads |
+| `leadbay_answer_clarification` | Répond à une question de clarification posée par Leadbay sur votre audience |
+
+### Imports & campagnes
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_import_leads` | Importe une liste de domaines d'entreprises |
+| `leadbay_import_and_qualify` | Importe une liste et la qualifie immédiatement |
+| `leadbay_create_custom_field` | Crée un champ CRM personnalisé (ex. pour préserver un ID système source) |
+| `leadbay_create_campaign` | Crée une nouvelle campagne |
+| `leadbay_add_leads_to_campaign` | Ajoute des leads à une campagne |
+| `leadbay_remove_leads_from_campaign` | Retire des leads d'une campagne |
+
+### Retours
+
+| Outil | Ce qu'il fait |
+|------|--------------|
+| `leadbay_send_feedback` | Envoie un message à l'équipe Leadbay (même boîte que le formulaire de feedback de l'application) |
+| `leadbay_report_friction` | Signale qu'un outil n'a pas livré ce dont vous aviez besoin — aide à améliorer le produit |
+
+---
+
+## Comment Claude choisit un outil
+
+Vous ne choisissez pas les outils — vous décrivez le résultat. Quelques exemples de correspondance :
+
+| Vous dites… | Claude appelle… |
+|----------|---------------|
+| « Montre-moi les leads du jour » | `leadbay_pull_leads` |
+| « Quels leads dois-je relancer ? » | `leadbay_pull_followups` |
+| « Parle-moi de acme.com » | `leadbay_research_lead_by_name_fuzzy` |
+| « Je vais à Lyon la semaine prochaine — planifie mes visites » | `leadbay_tour_plan` |
+| « Je viens d'appeler Jane chez Acme — journalise-le » | `leadbay_report_outreach` |
+| « Crée une lens appelée Joinery pour la fintech » | `leadbay_new_lens` |
+| « Arrête de me montrer les entreprises de plus de 50 personnes » | `leadbay_adjust_audience` |
+
+Voir la page [Exemples de prompts](example-prompts.md) pour une bibliothèque plus complète à copier-coller.
+
+---
+
+## Étape suivante
+
+{% content-ref url="example-prompts.md" %}
+[Exemples de prompts](example-prompts.md)
+{% endcontent-ref %}
diff --git a/fr/leadbay-mcp/what-is-leadbay-mcp.md b/fr/leadbay-mcp/what-is-leadbay-mcp.md
new file mode 100644
index 0000000..9660bdb
--- /dev/null
+++ b/fr/leadbay-mcp/what-is-leadbay-mcp.md
@@ -0,0 +1,65 @@
+# Qu'est-ce que Leadbay MCP ?
+
+**Leadbay MCP connecte Claude à votre compte Leadbay : vous travaillez vos leads en demandant, tout simplement.**
+
+Récupérez des leads, qualifiez-les, rédigez votre prospection, journalisez vos actions — en langage naturel. Claude agit sur vos vraies données, avec vos permissions, exactement comme vous le feriez dans l'application.
+
+{% hint style="info" %}
+**MCP** signifie *Model Context Protocol* — un standard ouvert qui permet aux assistants IA comme Claude de se connecter de façon sécurisée à des outils et des données externes. Le serveur Leadbay MCP est open source et se trouve sur [github.com/leadbay/leadclaw](https://github.com/leadbay/leadclaw).
+{% endhint %}
+
+---
+
+## Pourquoi connecter Leadbay à Claude ?
+
+Au lieu de basculer entre l'application Leadbay et votre flux de travail, vous travaillez en conversation :
+
+> *Récupère les meilleurs leads du jour et dis-moi lesquels valent la peine d'être ouverts ce matin.*
+
+> *Recherche acme.com — est-ce un bon fit pour nous ?*
+
+> *Je viens d'envoyer un email à Jane chez Acme. Journalise-le comme action de prospection.*
+
+Claude lit vos leads, vos lenses et votre profil de goût, raisonne dessus, et répond avec une analyse courte et qualifiée — puis effectue l'action que vous demandez.
+
+---
+
+## Où ça fonctionne
+
+Leadbay MCP fonctionne avec tout assistant IA qui supporte le Model Context Protocol :
+
+- **Claude Desktop**
+- **Claude Cowork**
+- **Claude Code**
+- **Cursor**
+- **Codex**
+
+---
+
+## Concepts clés
+
+Quelques termes Leadbay reviennent dans les prompts et les réponses. Vous n'avez besoin d'en gérer aucun pour démarrer — Claude s'occupe des détails — mais savoir ce qu'ils signifient aide :
+
+| Terme | Ce que ça veut dire |
+|------|---------------|
+| **Lens** | Votre audience enregistrée — le secteur, la taille d'entreprise et les critères qui définissent quels leads Leadbay fait remonter. Vous pouvez en avoir plusieurs et basculer entre elles (« bascule sur ma lens Joinery »). |
+| **Score** | Un score de fit firmographique de 0 à 100 sur chaque lead — à quel point il correspond à votre audience. Affiché sous forme de barre dans les tableaux de leads. |
+| **Score IA** | Un score de qualification plus poussé sur les meilleurs leads de chaque lot, issu d'une recherche web ciblée par rapport à vos questions de qualification. La plupart des leads ont le score de base ; les meilleurs sont qualifiés par l'IA. |
+| **Profil de goût** | Ce que Leadbay apprend de vos likes, dislikes et actions de prospection — il ajuste le scoring futur à votre jugement. Aimer un lead dans le chat l'entraîne. |
+| **Lecture vs écriture** | Les outils en **lecture** récupèrent seulement des données (leads, profils, contacts) et ne changent jamais rien. Les outils en **écriture** effectuent une action (qualifier, enrichir, journaliser la prospection, modifier des lenses). Les deux sont limités à votre compte — chaque écriture est une action que vous pourriez faire vous-même dans l'application, sans rien de destructeur au niveau de la plateforme. Vous contrôlez ce que votre client demande avant chaque action via ses réglages d'autorisation des outils. |
+
+Ces notions sont détaillées dans les guides produit [Lenses](../product-guides/lenses.md) et [AI Assistant](../product-guides/ai-assistant.md).
+
+---
+
+## Étape suivante
+
+Prêt à connecter ? Le Démarrage rapide vous amène à vos premiers leads en environ cinq minutes.
+
+{% content-ref url="quickstart.md" %}
+[Démarrage rapide](quickstart.md)
+{% endcontent-ref %}
+
+{% content-ref url="installation.md" %}
+[Installation](installation.md)
+{% endcontent-ref %}
diff --git a/fr/news/changelog.md b/fr/news/changelog.md
index 9bad17d..48c7721 100644
--- a/fr/news/changelog.md
+++ b/fr/news/changelog.md
@@ -13,8 +13,8 @@ Leadbay publie des mises à jour chaque semaine. Voici les étapes majeures.
 - **Déconnexion — cet appareil ou tous les appareils** : cliquer sur **Déconnexion** ouvre désormais un dialogue demandant si vous voulez vous déconnecter uniquement de cette session ou de chaque appareil et session de token agent/API d'un coup.
 - **Intégration Salesforce** : une nouvelle option Salesforce apparaît dans le sélecteur d'intégrations aux côtés de Zapier et SFTP — connectez vos données CRM directement.
 - **Affichage du score final affiné** : la décomposition du score sur les fiches leads a été resserrée — plus facile à lire en un coup d'œil.
-- **Serveur MCP Leadbay** : un tout nouveau serveur **Model Context Protocol** permet à Claude (Desktop, Code, Cowork) de récupérer des leads, les qualifier, enrichir des contacts et journaliser les actions de prospection pour vous — en utilisant votre compte Leadbay. Voir [Leadbay MCP](../product-guides/leadbay-mcp.md) pour le guide d'installation.
-- **Connexion OAuth pour Leadbay MCP** : l'extension MCP s'authentifie désormais via un flux **Se connecter avec Leadbay** en un clic à l'installation — fini le terminal, fini les bearer tokens à générer, copier, coller ou faire tourner. Les installations existantes continuent de fonctionner ; les nouvelles tiennent en une seule approbation. Voir [Leadbay MCP](../product-guides/leadbay-mcp.md) pour les étapes mises à jour.
+- **Serveur MCP Leadbay** : un tout nouveau serveur **Model Context Protocol** permet à Claude (Desktop, Code, Cowork) de récupérer des leads, les qualifier, enrichir des contacts et journaliser les actions de prospection pour vous — en utilisant votre compte Leadbay. Voir [Leadbay MCP](../leadbay-mcp/installation.md) pour le guide d'installation.
+- **Connexion OAuth pour Leadbay MCP** : l'extension MCP s'authentifie désormais via un flux **Se connecter avec Leadbay** en un clic à l'installation — fini le terminal, fini les bearer tokens à générer, copier, coller ou faire tourner. Les installations existantes continuent de fonctionner ; les nouvelles tiennent en une seule approbation. Voir [Leadbay MCP](../leadbay-mcp/installation.md) pour les étapes mises à jour.
 
 ## Avril 2026
 
diff --git a/fr/product-guides/leadbay-mcp.md b/fr/product-guides/leadbay-mcp.md
deleted file mode 100644
index 5f6dc72..0000000
--- a/fr/product-guides/leadbay-mcp.md
+++ /dev/null
@@ -1,117 +0,0 @@
-# Leadbay MCP pour Claude
-
-Donnez à Claude (Desktop, Code et Cowork) un accès direct à votre compte Leadbay. Une fois installé, Claude peut récupérer des leads, les qualifier, enrichir des contacts, journaliser les actions de prospection — en utilisant vos vraies données, avec vos permissions.
-
-Ce guide couvre l'installation dans **Claude Cowork** via l'extension prête à l'emploi `.mcpb`. Les autres clients (Claude Desktop, Cursor, Claude Code) sont couverts dans le [README Leadbay MCP](https://github.com/leadbay/leadclaw#install).
-
-{% hint style="info" %}
-Le serveur MCP est open source et se trouve sur [github.com/leadbay/leadclaw](https://github.com/leadbay/leadclaw). Il 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)
-- Claude Cowork (ou tout client Claude qui supporte les extensions MCP)
-- Une minute
-
----
-
-## Étape 1 — Télécharger la dernière extension
-
-Ouvrez la [page des releases LeadClaw](https://github.com/leadbay/leadclaw/releases/) et récupérez le dernier fichier `.mcpb` (cherchez un nom du type `leadbay-X.Y.Z.mcpb` dans la section **Assets** de la release la plus récente).
-
-Sauvegardez-le dans un endroit facile à retrouver — votre dossier Téléchargements fonctionne.
-
----
-
-## Étape 2 — Installer l'extension dans Cowork
-
-Dans Claude Cowork, allez dans :
-
-**Settings → Extensions → Advanced → Install extension**
-
-Sélectionnez le fichier `leadbay-X.Y.Z.mcpb` que vous avez téléchargé à l'étape 1.
-
-Un dialogue s'ouvre avec les détails de l'extension. Cliquez sur **Install**, puis confirmez avec **Install** à nouveau.
-
-Une fois installée, basculez l'extension sur **Enabled**.
-
----
-
-## É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 donner à Claude l'accès à votre compte
-4. L'onglet du navigateur se ferme tout seul et Claude poursuit la conversation
-
-Et voilà — aucun token à générer, copier, coller ou faire tourner. La connexion est scopée à votre compte et vous pouvez la révoquer à tout moment depuis **Settings → Connected apps** dans Leadbay.
-
-{% hint style="info" %}
-Si vous avez accès aux deux instances de Leadbay (US et EU), connectez-vous sur celle que vous voulez que Claude utilise. Vous pouvez changer plus tard en vous déconnectant depuis l'extension Leadbay dans Cowork et en vous reconnectant sur l'autre instance.
-{% endhint %}
-
----
-
-## Étape 4 — Autoriser les outils
-
-Leadbay livre deux saveurs d'outils :
-
-| Saveur | Ce qu'elle contient | Permission recommandée |
-|--------|---------------------|------------------------|
-| **Read-only** | Récupère leads, lenses, profils, contacts, taste profile, quota d'enrichissement — ne change jamais rien | **Always allow** |
-| **Write / delete** | Qualifie des leads, enrichit des contacts, ajoute des notes, importe des leads, journalise des actions de prospection, affine l'audience | **Always allow** |
-
-Les deux saveurs peuvent être en always-allow sans risque car le Leadbay MCP est **scopé à votre compte** — rien de destructif au niveau plateforme. Mettre les deux en « always allow » permet à Claude de circuler sans vous interrompre pour une permission à chaque appel.
-
-Pour configurer : dans l'écran **Configure** de l'extension Leadbay, mettez **Always allow** à la fois pour le groupe d'outils read-only et pour le groupe write/delete.
-
----
-
-## Essayez-le
-
-Ouvrez une conversation Cowork et demandez :
-
-> *Récupère les meilleurs leads du jour et dis-moi lesquels ouvrir en priorité ce matin.*
-
-Claude appellera `leadbay_pull_leads`, `leadbay_get_lead_profile` et leurs amis — et répondra avec une shortlist courte et qualifiée.
-
-Quelques prompts supplémentaires qui marchent dès le départ :
-
-- *Recherche acme.com — est-ce que c'est un fit pour nous ?*
-- *Affine mon audience pour me focaliser sur les entreprises européennes qui recrutent des commerciaux.*
-- *Je viens d'envoyer un email à Jane chez Acme. Journalise-le comme action de prospection.*
-
-La liste complète des outils et des workflows recommandés est dans le [README LeadClaw](https://github.com/leadbay/leadclaw#tools).
-
----
-
-## Mettre à jour
-
-Quand une nouvelle release sort, répétez l'**étape 1** (téléchargez le nouveau `.mcpb`) et l'**étape 2** (Install extension). Cowork remplace l'ancienne version en place ; votre connexion reste valide, donc pas besoin de vous ré-authentifier.
-
----
-
-## Utiliser Leadbay avec Claude Desktop
-
-Claude Desktop est plus lent que Cowork à charger les outils MCP, donc quelques précautions supplémentaires aident.
-
-Après avoir installé l'extension Leadbay, **quittez complètement Claude Desktop et relancez-le** (Cmd-Q sur Mac, puis rouvrez — ne vous contentez pas de 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 genre *« Je ne vois pas d'outils 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 prendra en compte. À partir de là, le reste de votre session fonctionne normalement.
-
----
-
-## 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 et Claude vous reproposera le flux **Se connecter avec Leadbay** |
-| Les outils n'apparaissent pas dans Cowork | Vérifiez que l'extension est bien sur **Enabled** dans Settings → Extensions |
-| Les outils apparaissent mais Claude ne les appelle pas | Ouvrez **Configure** et passez les groupes d'outils en **Always allow** |
-| Mauvaise instance (pas de leads / 404s) | Déconnectez-vous depuis l'extension Leadbay et reconnectez-vous sur la bonne instance (US ou EU) |
-| Autre problème | Ouvrez un bug sur [github.com/leadbay/leadclaw/issues](https://github.com/leadbay/leadclaw/issues) |
diff --git a/leadbay-mcp/example-prompts.md b/leadbay-mcp/example-prompts.md
new file mode 100644
index 0000000..f70c62e
--- /dev/null
+++ b/leadbay-mcp/example-prompts.md
@@ -0,0 +1,169 @@
+# Example prompts
+
+Leadbay MCP works best when you talk to Claude the way you'd talk to a colleague — describe the outcome, not the tool. Below is a library of prompts that work out of the box, grouped by what you're trying to do. Copy, tweak, and make them yours.
+
+{% hint style="info" %}
+You don't need to name tools or IDs. "Pull today's leads", "research acme.com", "log that I emailed Jane" — Claude picks the right tool. Every action is scoped to your account; how much your client asks before each one depends on its tool-permission settings.
+{% endhint %}
+
+---
+
+## Start your day
+
+> *Show me today's leads.*
+
+> *What's in my inbox this morning?*
+
+> *Pull my best new prospects and tell me which two are worth opening first.*
+
+> *Give me an overview of my prospecting — where am I, what should I do next?*
+
+Claude pulls your fresh batch, ranks it, and offers a short shortlist. It won't take any action until you ask.
+
+---
+
+## Follow up & re-engage
+
+> *Which leads should I follow up with this week?*
+
+> *Who have I contacted that I should circle back to?*
+
+> *What's the full history on this account — is it worth another visit?*
+
+> *Which of my leads acquired a company since 2025?*
+
+> *Scan my portfolio for funding signals.*
+
+The portfolio-scan prompts filter your existing leads by a web signal in one pass — no need to research each one individually.
+
+---
+
+## Research a company
+
+> *Tell me about jaxpartycompany.com — is it a fit for us?*
+
+> *Research Acme Corp and summarise why they score the way they do.*
+
+> *Pull the contacts and qualification for this lead.*
+
+Claude returns a research card with the company's score, why it fits, and the best contact to reach.
+
+---
+
+## Plan a trip / field sales
+
+> *I'm visiting Jacksonville in 3 days — plan my visits.*
+
+> *I'm flying to Berlin Thursday — who should I meet while I'm there?*
+
+> *Show my follow-ups around Lyon on a map.*
+
+> *Give me 3 existing customers, 3 qualified leads, and 3 new prospects near Limoges, on one map.*
+
+These render on a map where your client supports it, with the best contact and a one-line reason per stop.
+
+---
+
+## Draft & log outreach
+
+> *Draft me an outreach email for JAX PARTY COMPANY LLC.*
+
+> *Write a cold-call opener for Acme — I'm selling field-service software.*
+
+> *I just emailed Jane at Acme. Log it as outreach.*
+
+> *I called Acme this morning and left a voicemail — record that.*
+
+Drafting is read-only. Logging writes the activity to your account.
+
+---
+
+## Import & qualify a list
+
+> *I have 400 event attendees — import them and rank the most promising.*
+
+> *Here's a CSV of domains. Import and qualify the top 50.*
+
+> *Qualify the top 10 leads in my batch.*
+
+> *What's the status of my import?*
+
+Claude maps your file's columns, imports the rows, and can immediately run AI qualification on the most promising ones.
+
+---
+
+## Manage your audience (lenses)
+
+> *Show me my lenses and switch to the Joinery one.*
+
+> *Create a lens called Joinery for the fintech sector.*
+
+> *Stop showing me companies with more than 50 employees.*
+
+> *I prefer EU companies that are actively hiring sales reps — refine my audience.*
+
+> *I want more leads on this lens — give me a bigger batch today.*
+
+Lens changes are reversible and reflected immediately in your next pull.
+
+---
+
+## Build a team campaign
+
+> *Set up a prospecting campaign for my team.*
+
+> *Create a campaign for the leads I just qualified and add the top 20.*
+
+> *Show me how the Q3 campaign is progressing.*
+
+> *Give me the call sheet for the Lyon campaign.*
+
+Campaigns persist a hand-picked cohort of leads your team can work through together.
+
+---
+
+## Manage contacts
+
+> *Acme has no contacts — add Jane Doe, VP Eng, here's her LinkedIn.*
+
+> *Pin Jane Doe as the main contact on this company.*
+
+> *Update Jane Doe's title to SVP Engineering.*
+
+> *Remove Jane Doe — I added her by mistake.*
+
+---
+
+## Housekeeping & feedback
+
+> *How much enrichment quota do I have left?*
+
+> *Top up my quota.*
+
+> *Send feedback to the team: lead scores feel off this week.*
+
+---
+
+## Chaining it together
+
+You can ask for a whole sequence in one message, or build it up turn by turn:
+
+> *Pull today's leads, research the top one, and draft me an email to them.*
+
+> *Show me my follow-ups near Madrid, put them on a map, and prep outreach for the closest three.*
+
+Claude carries context across the conversation — once it's surfaced a lead, you can keep referring to "the top one" or "that company" without repeating yourself.
+
+---
+
+## Next step
+
+New here? Start with the overview, then connect.
+
+{% content-ref url="what-is-leadbay-mcp.md" %}
+[What is Leadbay MCP?](what-is-leadbay-mcp.md)
+{% endcontent-ref %}
+
+{% content-ref url="installation.md" %}
+[Installation](installation.md)
+{% endcontent-ref %}
diff --git a/leadbay-mcp/installation.md b/leadbay-mcp/installation.md
new file mode 100644
index 0000000..c20e278
--- /dev/null
+++ b/leadbay-mcp/installation.md
@@ -0,0 +1,131 @@
+# Installation
+
+Connecting Leadbay takes about a minute. Pick the path that matches your client:
+
+- **On Claude (Desktop / Cowork):** the **`.dxt` extension** — download one file and double-click to install. Recommended.
+- **On Claude Code, Cursor, or Codex:** the **one-command installer**. It also works for Claude Desktop.
+
+Advanced setup and other clients are covered in the [Leadbay MCP README](https://github.com/leadbay/leadclaw#install).
+
+{% hint style="info" %}
+The MCP server uses **your** Leadbay account, so any action Claude takes is the same as if you'd done it yourself in the app.
+{% endhint %}
+
+---
+
+## What you'll need
+
+- A Leadbay account ([sign up here](https://leadbay.ai/) if you don't have one)
+- An AI assistant that supports MCP — Claude, Claude Code, Cursor, or Codex
+- One minute
+
+---
+
+## On Claude — `.dxt` extension (recommended)
+
+For **Claude Desktop and Claude Cowork**, the simplest setup is to download a single extension file and double-click it. (Using Claude Code, Cursor, or Codex instead? Skip to the [one-command installer](#one-command-installer-claude-code-cursor-codex) below.)
+
+### Step 1 — Download the latest extension
+
+Open the [LeadClaw releases page](https://github.com/leadbay/leadclaw/releases/latest) and download the latest `.dxt` file (look for a name like `leadbay-X.Y.Z.dxt` under the release's **Assets**).
+
+---
+
+### Step 2 — Double-click to install
+
+**Double-click the downloaded `.dxt` file.** Claude opens with the extension details — click **Install** to confirm, then toggle the extension to **Enabled**. That's it.
+
+{% hint style="info" %}
+Prefer to install from inside the app? Go to **Settings → Extensions → Advanced → Install extension** and pick the `.dxt` file instead of double-clicking.
+{% endhint %}
+
+---
+
+### Step 3 — Sign in with Leadbay
+
+The first time Claude calls a Leadbay tool, it triggers a one-tap **Sign in with Leadbay** flow:
+
+1. A Leadbay login page opens in your browser
+2. Log in (or confirm your existing session)
+3. Click **Approve** to grant Claude access to your account
+4. The browser tab closes itself and Claude continues the conversation
+
+That's it — no tokens to mint, copy, paste, or rotate. The connection is scoped to your account and you can revoke it anytime from **Settings → Connected apps** in Leadbay.
+
+{% hint style="info" %}
+If you have access to both the US and EU instances of Leadbay, sign in on the instance you want Claude to use. You can switch later by signing out from the Leadbay extension and signing back in on the other instance.
+{% endhint %}
+
+---
+
+### Step 4 — Allow the tools
+
+Leadbay ships two flavors of tools:
+
+| Flavor | What's in it | Recommended permission |
+|--------|--------------|------------------------|
+| **Read-only** | Pulls leads, lenses, profiles, contacts, taste profile, enrichment quota — never changes anything | **Always allow** |
+| **Write / delete** | Qualifies leads, enriches contacts, adds notes, imports leads, reports outreach, refines audience | **Always allow** |
+
+Both flavors are safe to always-allow because the Leadbay MCP is **scoped to your account** — there's nothing destructive at the platform level. Setting both to "always allow" makes Claude flow without interrupting you for permission on every call.
+
+To configure: in the Leadbay extension's **Configure** screen, set **Always allow** for both the read-only tool group and the write/delete tool group.
+
+---
+
+## One-command installer (Claude Code, Cursor, Codex)
+
+For **Claude Code, Cursor, or Codex**, one command installs Leadbay and signs you in. It also works for **Claude Desktop** if you'd rather automate the setup than install the `.dxt` by hand. You'll need [Node.js](https://nodejs.org) 22 or newer.
+
+```bash
+npx -y -p @leadbay/mcp@latest installer
+```
+
+This opens a guided wizard that detects your installed clients (Claude Desktop, Claude Code, Cursor, Codex), adds Leadbay to the ones you pick, and runs the **Sign in with Leadbay** flow.
+
+To remove Leadbay later from every client the installer set up:
+
+```bash
+npx -y -p @leadbay/mcp@latest installer --uninstall
+```
+
+---
+
+## You're connected
+
+That's it — Leadbay is set up. Head to the Quickstart for your first prompt and what a successful result looks like.
+
+{% content-ref url="quickstart.md" %}
+[Quickstart](quickstart.md)
+{% endcontent-ref %}
+
+---
+
+## Using Leadbay with Claude Desktop
+
+Claude Desktop is slower than Cowork to load MCP tools, so a couple of extra precautions help.
+
+After installing the Leadbay extension, **fully quit and relaunch Claude Desktop** (Cmd-Q on Mac, then reopen — not just closing the window). Open a new chat and wait about **30 seconds** before sending your first message. This gives Claude time to load the Leadbay tools.
+
+If your first message gets a response like *"I don't see any Leadbay tools"* or *"I can't find Leadbay in your setup"*, don't worry — the tools are still loading. Send any second message (even just *"try again"*) and Claude will pick them up. From that point on, the rest of your session works normally.
+
+---
+
+## Updating
+
+For the **`.dxt` extension**, when a new release ships, repeat **Step 1** (download the new `.dxt`) and **Step 2** (Install extension). Claude replaces the old version in place; your sign-in stays valid, so you don't need to re-authenticate.
+
+The **one-command installer** always runs the latest version — there's nothing to update.
+
+---
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| Claude says "not authenticated" or 401 errors | Your sign-in may have expired or been revoked. Trigger any Leadbay tool again and Claude will re-prompt the **Sign in with Leadbay** flow |
+| Tools don't appear after install | Make sure the extension toggle is **Enabled** in Settings → Extensions |
+| Tools appear but Claude won't call them | Open **Configure** and switch the tool groups to **Always allow** |
+| Connected, but "show me leads" returns an empty list | You're signed in fine — there's just nothing to show right now. Ask *"show me my lenses"* to confirm which audience is active and switch if needed, or check you're on the right instance (US vs EU) |
+| Wrong instance (no leads / 404s) | Sign out from the Leadbay extension and sign back in on the right instance (US or EU) |
+| Other issue | File a bug at [github.com/leadbay/leadclaw/issues](https://github.com/leadbay/leadclaw/issues) |
diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md
new file mode 100644
index 0000000..9d1c776
--- /dev/null
+++ b/leadbay-mcp/quickstart.md
@@ -0,0 +1,86 @@
+# Quickstart
+
+Connect Leadbay to Claude and get your first qualified leads in about five minutes. This is the fast path — pick your client, install, sign in, and ask. Detailed options and troubleshooting live in the [Installation](installation.md) guide.
+
+{% hint style="info" %}
+You'll need a [Leadbay account](https://leadbay.ai/) and an AI assistant that supports MCP (Claude Desktop, Claude Cowork, Claude Code, or Cursor — Codex too). That's it — no API tokens to copy or paste. _ChatGPT support is coming soon._
+{% endhint %}
+
+---
+
+## Step 1 — Install
+
+Pick the path for your client. Full details are in the [Installation](installation.md) guide.
+
+**On Claude (Desktop / Cowork) — `.dxt` extension** (recommended): download the latest `leadbay-X.Y.Z.dxt` from the [LeadClaw releases page](https://github.com/leadbay/leadclaw/releases/latest), then **double-click it** to install in Claude.
+
+**On Claude Code, Cursor, or Codex — one-command installer** (needs [Node.js](https://nodejs.org) 22+). It also works for Claude Desktop:
+
+```bash
+npx -y -p @leadbay/mcp@latest installer
+```
+
+---
+
+## Step 2 — Sign in (this happens automatically)
+
+You don't set anything up by hand. The moment you install — or the first time Claude uses a Leadbay tool — a **Sign in with Leadbay** page **opens automatically in your browser**:
+
+1. The Leadbay login page appears on its own.
+2. Log in (or confirm your existing session).
+3. Click **Approve** to connect Claude to your account.
+4. The tab closes itself and Claude is ready.
+
+That's the whole connection. No tokens, no config files. Claude is now linked to **your** account, with all the leads and lenses you already have in Leadbay. You can revoke access anytime from **Settings → Connected apps**.
+
+{% hint style="info" %}
+If you have both a US and an EU account, sign in on the instance you want Claude to use. You can switch later by signing out and back in on the other instance.
+{% endhint %}
+
+---
+
+## Step 3 — Ask for your first leads
+
+Open a new conversation and type:
+
+> *Show me today's leads and tell me which two are worth opening first.*
+
+Claude calls your Leadbay tools and replies with a short, ranked shortlist — company, why it fits, and the best contact to reach.
+
+---
+
+## Step 4 — What you should see
+
+A successful first response looks like a **ranked table of leads**, not a wall of text. For each lead you'll get:
+
+- a **score** (how well it matches your audience),
+- a one-line **why it fits**,
+- the **best contact** with a link where available.
+
+If Claude replies with leads like that, you're fully connected. 🎉
+
+---
+
+## Step 5 — Keep going
+
+Once you've seen your first leads, try these:
+
+> *Research the top one for me — is it a fit?*
+
+> *Draft me an outreach email to them.*
+
+> *I just emailed them. Log it as outreach.*
+
+Claude remembers the leads it surfaced, so you can keep referring to "the top one" without repeating yourself.
+
+---
+
+## Where to next
+
+{% content-ref url="example-prompts.md" %}
+[Example prompts](example-prompts.md)
+{% endcontent-ref %}
+
+{% content-ref url="tools-reference.md" %}
+[Tools reference](tools-reference.md)
+{% endcontent-ref %}
diff --git a/leadbay-mcp/tools-reference.md b/leadbay-mcp/tools-reference.md
new file mode 100644
index 0000000..c9ead6e
--- /dev/null
+++ b/leadbay-mcp/tools-reference.md
@@ -0,0 +1,156 @@
+# Tools reference
+
+When you connect Leadbay to Claude, the server exposes a set of **tools** that Claude calls on your behalf. You never call these directly — you ask in plain language ("pull today's leads", "research acme.com", "log that I emailed Jane") and Claude picks the right tool. This page is a reference for what's available and what each tool does.
+
+Tools come in two groups: **read-only** (pull data, never change anything) and **write / activate** (take action on your account).
+
+---
+
+## Read-only tools
+
+These never modify your account, so they're always safe to allow.
+
+### Discover & follow up
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_pull_leads` | Retrieves today's fresh lead batch, scored and ranked |
+| `leadbay_pull_followups` | Pulls the leads that need a follow-up action |
+| `leadbay_account_status` | Checks your quota, credits, and account state |
+| `leadbay_scan_portfolio_signals` | Scans your existing leads for a web signal in one pass ("which of my leads acquired a company since 2025?") — no quota burn |
+
+### Research a company
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_research_lead_by_id` | Deep-dive research card for a known lead — bundles details, qualification, and contacts into one response |
+| `leadbay_research_lead_by_name_fuzzy` | Looks up a lead by company name or domain when you don't have its ID |
+| `leadbay_account_history` | Full history on one account — current AI signals + all notes + the interaction timeline, in one call ("why has this account resurfaced?") |
+| `leadbay_prepare_outreach` | Generates a personalized outreach brief for a lead |
+
+### Travel & field sales
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_followups_map` | Geo-clusters your follow-ups on a map for travel planning |
+| `leadbay_tour_plan` | Builds a visit itinerary for an upcoming trip to a city |
+
+### Campaigns
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_list_campaigns` | Lists your existing campaigns |
+| `leadbay_campaign_progression` | Shows a campaign's funnel metrics |
+| `leadbay_campaign_call_sheet` | Pulls the call sheet for a campaign |
+
+### Lenses & audience
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_list_sectors` | Lists the real sector taxonomy labels — so you (and Claude) name sectors correctly |
+| `leadbay_recall_ordered_titles` | Recalls the job titles you've previously enriched |
+| `leadbay_seed_candidates` | Read-only discovery surface for building a bigger lens |
+
+### Imports & jobs
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_import_status` | Checks the status of an import job |
+| `leadbay_qualify_status` | Checks the status of a qualification job |
+| `leadbay_bulk_enrich_status` | Checks the status of an enrichment job |
+| `leadbay_resolve_import_rows` | Maps imported rows back to their lead IDs |
+| `leadbay_list_mappable_fields` | Lists the CRM fields you can map an import onto |
+
+### Billing
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_create_topup_link` | Generates a Stripe link to top up your quota (you pay in your browser — nothing is charged automatically) |
+| `leadbay_open_billing_portal` | Opens your billing dashboard |
+
+---
+
+## Write / activate tools
+
+These take action on your account. They're on by default. Every action is one you could take yourself in the app — there's nothing destructive at the platform level.
+
+### Qualify & enrich
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_bulk_qualify_leads` | Triggers AI qualification on a batch of leads |
+| `leadbay_enrich_titles` | Enriches contacts by job title |
+
+### Outreach & activity
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_report_outreach` | Logs an outreach action (call, email, meeting) against a lead |
+| `leadbay_add_note` | Adds a note to a lead |
+| `leadbay_like_lead` | Marks a lead as liked — teaches your taste profile |
+| `leadbay_dislike_lead` | Marks a lead as disliked — teaches your taste profile |
+
+### Contacts
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_add_contact` | Adds a person to a company (name + optional LinkedIn / title / email / phone) |
+| `leadbay_remove_contact` | Removes a contact you added |
+| `leadbay_pin_contact` | Pins a contact as the priority on a company |
+| `leadbay_unpin_contact` | Unpins a contact |
+| `leadbay_update_contact` | Edits a contact's details (title, email, LinkedIn…) |
+
+### Lenses & audience
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_my_lenses` | Lists, switches, renames, or deletes your lenses |
+| `leadbay_new_lens` | Creates a named lens with sector / company-size criteria |
+| `leadbay_adjust_audience` | Edits a lens's audience ("stop showing me companies over 50 employees") |
+| `leadbay_extend_my_lens` | Fills your current lens with more leads on demand (subject to a daily refill quota) |
+| `leadbay_refine_prompt` | Refines the qualification prompt that scores your leads |
+| `leadbay_answer_clarification` | Answers a clarification question Leadbay asked about your audience |
+
+### Imports & campaigns
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_import_leads` | Imports a list of company domains |
+| `leadbay_import_and_qualify` | Imports a list and immediately qualifies it |
+| `leadbay_create_custom_field` | Creates a custom CRM field (e.g. to preserve a source-system ID) |
+| `leadbay_create_campaign` | Creates a new campaign |
+| `leadbay_add_leads_to_campaign` | Adds leads to a campaign |
+| `leadbay_remove_leads_from_campaign` | Removes leads from a campaign |
+
+### Feedback
+
+| Tool | What it does |
+|------|--------------|
+| `leadbay_send_feedback` | Sends a message to the Leadbay team (same inbox as the in-app feedback form) |
+| `leadbay_report_friction` | Reports when a tool didn't deliver what you needed — helps improve the product |
+
+---
+
+## How Claude chooses a tool
+
+You don't pick tools — you describe the outcome. A few examples of the mapping:
+
+| You say… | Claude calls… |
+|----------|---------------|
+| "Show me today's leads" | `leadbay_pull_leads` |
+| "Which leads should I follow up with?" | `leadbay_pull_followups` |
+| "Tell me about acme.com" | `leadbay_research_lead_by_name_fuzzy` |
+| "I'm visiting Lyon next week — plan my visits" | `leadbay_tour_plan` |
+| "I just called Jane at Acme — log it" | `leadbay_report_outreach` |
+| "Create a lens called Joinery for fintech" | `leadbay_new_lens` |
+| "Stop showing me companies over 50 people" | `leadbay_adjust_audience` |
+
+See the [Example prompts](example-prompts.md) page for a fuller library you can copy and paste.
+
+---
+
+## Next step
+
+{% content-ref url="example-prompts.md" %}
+[Example prompts](example-prompts.md)
+{% endcontent-ref %}
diff --git a/leadbay-mcp/what-is-leadbay-mcp.md b/leadbay-mcp/what-is-leadbay-mcp.md
new file mode 100644
index 0000000..6d87c1e
--- /dev/null
+++ b/leadbay-mcp/what-is-leadbay-mcp.md
@@ -0,0 +1,65 @@
+# What is Leadbay MCP?
+
+**Leadbay MCP connects Claude to your Leadbay account, so you can work your leads by simply asking.**
+
+Pull leads, qualify them, draft outreach, log activity — in plain language. Claude acts on your real data, with your permissions, just as you would in the app.
+
+{% hint style="info" %}
+**MCP** stands for *Model Context Protocol* — an open standard that lets AI assistants like Claude securely connect to external tools and data. The Leadbay MCP server is open source and lives at [github.com/leadbay/leadclaw](https://github.com/leadbay/leadclaw).
+{% endhint %}
+
+---
+
+## Why connect Leadbay to Claude?
+
+Instead of switching between the Leadbay app and your workflow, you work conversationally:
+
+> *Pull today's top leads and tell me which two are worth opening this morning.*
+
+> *Research acme.com — is it a fit for us?*
+
+> *I just emailed Jane at Acme. Log it as outreach.*
+
+Claude reads your leads, lenses, and taste profile, reasons over them, and replies with a short, qualified answer — then takes the follow-up action you ask for.
+
+---
+
+## Where it works
+
+Leadbay MCP works with any AI assistant that supports the Model Context Protocol:
+
+- **Claude Desktop**
+- **Claude Cowork**
+- **Claude Code**
+- **Cursor**
+- **Codex**
+
+---
+
+## Key concepts
+
+A few Leadbay terms show up in prompts and responses. You don't need to manage any of them to get started — Claude handles the details — but knowing what they mean helps:
+
+| Term | What it means |
+|------|---------------|
+| **Lens** | Your saved audience — the sector, company size, and criteria that define which leads Leadbay surfaces. You can have several and switch between them ("switch to my Joinery lens"). |
+| **Score** | A 0–100 firmographic fit score on every lead — how well it matches your audience. Shown as a bar in lead tables. |
+| **AI score** | A deeper qualification score on the top leads in each batch, from targeted web research against your qualification questions. Most leads ship with the basic score; the best get AI-qualified. |
+| **Taste profile** | What Leadbay learns from your likes, dislikes, and outreach — it tunes future scoring to your judgement. Liking a lead in chat teaches it. |
+| **Read vs write** | **Read** tools only pull data (leads, profiles, contacts) and never change anything. **Write** tools take action (qualify, enrich, log outreach, edit lenses). Both are scoped to your account — every write is something you could do yourself in the app, with nothing destructive at the platform level. You control how much your client asks before each action through its tool-permission settings. |
+
+These are covered in depth in the [Lenses](../product-guides/lenses.md) and [AI Assistant](../product-guides/ai-assistant.md) product guides.
+
+---
+
+## Next step
+
+Ready to connect? The Quickstart gets you to your first leads in about five minutes.
+
+{% content-ref url="quickstart.md" %}
+[Quickstart](quickstart.md)
+{% endcontent-ref %}
+
+{% content-ref url="installation.md" %}
+[Installation](installation.md)
+{% endcontent-ref %}
diff --git a/news/changelog.md b/news/changelog.md
index e8ef30c..17c0fb3 100644
--- a/news/changelog.md
+++ b/news/changelog.md
@@ -13,8 +13,8 @@ Leadbay ships updates every week. Below are the major milestones.
 - **Logout — this device or all devices**: clicking **Logout** now opens a dialog asking whether you want to sign out of just this session or every device and agent/API token session at once.
 - **Salesforce integration**: a new Salesforce option appears in the integrations picker alongside Zapier and SFTP — connect your CRM data directly.
 - **Refined final-score display**: the score breakdown on lead profiles has been tightened — easier to read at a glance.
-- **Leadbay MCP server**: a brand-new **Model Context Protocol** server lets Claude (Desktop, Code, Cowork) pull leads, qualify them, enrich contacts, and log outreach on your behalf — using your Leadbay account. See [Leadbay MCP](../product-guides/leadbay-mcp.md) for the install walkthrough.
-- **OAuth sign-in for Leadbay MCP**: the MCP extension now authenticates with a one-tap **Sign in with Leadbay** flow on install — no more terminal, no more bearer tokens to mint, copy, paste, or rotate. Existing installs keep working; new ones are a single approval click. See [Leadbay MCP](../product-guides/leadbay-mcp.md) for the refreshed steps.
+- **Leadbay MCP server**: a brand-new **Model Context Protocol** server lets Claude (Desktop, Code, Cowork) pull leads, qualify them, enrich contacts, and log outreach on your behalf — using your Leadbay account. See [Leadbay MCP](../leadbay-mcp/installation.md) for the install walkthrough.
+- **OAuth sign-in for Leadbay MCP**: the MCP extension now authenticates with a one-tap **Sign in with Leadbay** flow on install — no more terminal, no more bearer tokens to mint, copy, paste, or rotate. Existing installs keep working; new ones are a single approval click. See [Leadbay MCP](../leadbay-mcp/installation.md) for the refreshed steps.
 
 ## April 2026
 
diff --git a/product-guides/leadbay-mcp.md b/product-guides/leadbay-mcp.md
deleted file mode 100644
index 381bd0b..0000000
--- a/product-guides/leadbay-mcp.md
+++ /dev/null
@@ -1,176 +0,0 @@
-# Leadbay MCP for Claude
-
-Give Claude (Desktop, Code, and Cowork) direct access to your Leadbay account. Once installed, Claude can pull leads, qualify them, enrich contacts, log outreach — all using your real data, with your permissions.
-
-There are three ways to connect — pick the one that fits your client:
-
-- **Option A — Hosted connector:** paste a URL, nothing to install. Best for **Claude Desktop** and **ChatGPT**.
-- **Option B — One-command installer:** a guided wizard. Best for **Claude Desktop**, **Claude Code**, and **Cursor**.
-- **Option C — Manual `.mcpb` extension:** download and install by hand. Required for **Claude Cowork**.
-
-Advanced setup and other clients are covered in the [Leadbay MCP README](https://github.com/leadbay/leadclaw#install).
-
-{% hint style="info" %}
-The MCP server is open source and lives at [github.com/leadbay/leadclaw](https://github.com/leadbay/leadclaw). It uses **your** Leadbay account, so any action Claude takes is the same as if you'd done it yourself in the app.
-{% endhint %}
-
----
-
-## What you'll need
-
-- A Leadbay account ([sign up here](https://leadbay.ai/) if you don't have one)
-- An AI assistant that supports MCP — Claude Desktop, Claude Cowork, Claude Code, Cursor, or ChatGPT
-- One minute
-
----
-
-## Option A — Hosted connector (no install)
-
-The fastest way: Leadbay runs a hosted MCP server, so you add a connector URL with nothing to download, update, or maintain. Pick the URL that matches your Leadbay instance:
-
-| Your Leadbay instance | Connector URL |
-|---|---|
-| EU / France | `https://leadbay-mcp-prod.fly.dev/fr/mcp` |
-| US | `https://leadbay-mcp-prod.fly.dev/mcp` |
-
-{% hint style="info" %}
-Not sure which instance you're on? Most accounts are EU/France — start with the `/fr/mcp` URL. If sign-in can't find your account, use the US URL instead.
-{% endhint %}
-
-**In Claude Desktop:**
-
-1. Open **Settings → Connectors → Add custom connector**.
-2. Paste the URL for your instance and confirm.
-3. The first time Claude uses a Leadbay tool, a **Sign in with Leadbay** page opens in your browser — log in and click **Approve**.
-
-**In ChatGPT:**
-
-1. Open **Settings → Apps → Add app**.
-2. Paste the same URL and follow the sign-in prompt.
-
-No tokens to copy or rotate. You can revoke access anytime from **Settings → Connected apps** in Leadbay.
-
----
-
-## Option B — One-command installer
-
-Prefer a local setup, or using **Claude Code** or **Cursor**? One command installs Leadbay and signs you in. You'll need [Node.js](https://nodejs.org) 22 or newer.
-
-```bash
-npx -y -p @leadbay/mcp@latest installer
-```
-
-This opens a guided wizard that detects your installed clients (Claude Desktop, Claude Code, Cursor), adds Leadbay to the ones you pick, and runs the **Sign in with Leadbay** flow.
-
-To remove Leadbay later from every client the installer set up:
-
-```bash
-npx -y -p @leadbay/mcp@latest installer --uninstall
-```
-
----
-
-## Option C — Manual `.mcpb` extension (Cowork)
-
-Claude Cowork installs MCP tools from a downloaded extension file. Use this method for Cowork (it also works for Claude Desktop).
-
-### Step 1 — Download the latest extension
-
-Open the [LeadClaw releases page](https://github.com/leadbay/leadclaw/releases/) and grab the latest `.mcpb` file (look for a name like `leadbay-X.Y.Z.mcpb` under the most recent release's **Assets**).
-
-Save it somewhere easy to find — your Downloads folder works.
-
----
-
-### Step 2 — Install the extension in Cowork
-
-In Claude Cowork, go to:
-
-**Settings → Extensions → Advanced → Install extension**
-
-Pick the `leadbay-X.Y.Z.mcpb` file you downloaded in Step 1.
-
-A dialog opens with the extension details. Click **Install**, then confirm with **Install** again.
-
-Once installed, toggle the extension to **Enabled**.
-
----
-
-### Step 3 — Sign in with Leadbay
-
-The first time Claude calls a Leadbay tool, it triggers a one-tap **Sign in with Leadbay** flow:
-
-1. A Leadbay login page opens in your browser
-2. Log in (or confirm your existing session)
-3. Click **Approve** to grant Claude access to your account
-4. The browser tab closes itself and Claude continues the conversation
-
-That's it — no tokens to mint, copy, paste, or rotate. The connection is scoped to your account and you can revoke it anytime from **Settings → Connected apps** in Leadbay.
-
-{% hint style="info" %}
-If you have access to both the US and EU instances of Leadbay, sign in on the instance you want Claude to use. You can switch later by signing out from the Leadbay extension in Cowork and signing back in on the other instance.
-{% endhint %}
-
----
-
-### Step 4 — Allow the tools
-
-Leadbay ships two flavors of tools:
-
-| Flavor | What's in it | Recommended permission |
-|--------|--------------|------------------------|
-| **Read-only** | Pulls leads, lenses, profiles, contacts, taste profile, enrichment quota — never changes anything | **Always allow** |
-| **Write / delete** | Qualifies leads, enriches contacts, adds notes, imports leads, reports outreach, refines audience | **Always allow** |
-
-Both flavors are safe to always-allow because the Leadbay MCP is **scoped to your account** — there's nothing destructive at the platform level. Setting both to "always allow" makes Claude flow without interrupting you for permission on every call.
-
-To configure: in the Leadbay extension's **Configure** screen, set **Always allow** for both the read-only tool group and the write/delete tool group.
-
----
-
-## Try it
-
-Open a Cowork conversation and ask:
-
-> *Pull today's top leads and tell me which two are worth opening this morning.*
-
-Claude will call `leadbay_pull_leads`, `leadbay_get_lead_profile`, and friends — and reply with a short, qualified shortlist.
-
-A few more prompts that work out of the box:
-
-- *Research acme.com — is it a fit for us?*
-- *Refine my audience to focus on EU companies hiring sales reps.*
-- *I just emailed Jane at Acme. Log it as outreach.*
-
-The full list of tools and recommended workflows is in the [LeadClaw README](https://github.com/leadbay/leadclaw#tools).
-
----
-
-## Updating
-
-The hosted connector (**Option A**) always runs the latest version — there's nothing to update.
-
-For the manual `.mcpb` extension (**Option C**), when a new release ships, repeat **Step 1** (download the new `.mcpb`) and **Step 2** (Install extension). Cowork replaces the old version in place; your sign-in stays valid, so you don't need to re-authenticate.
-
----
-
-## Using Leadbay with Claude Desktop
-
-Claude Desktop is slower than Cowork to load MCP tools, so a couple of extra precautions help.
-
-After installing the Leadbay extension, **fully quit and relaunch Claude Desktop** (Cmd-Q on Mac, then reopen — not just closing the window). Open a new chat and wait about **30 seconds** before sending your first message. This gives Claude time to load the Leadbay tools.
-
-If your first message gets a response like *"I don't see any Leadbay tools"* or *"I can't find Leadbay in your setup"*, don't worry — the tools are still loading. Send any second message (even just *"try again"*) and Claude will pick them up. From that point on, the rest of your session works normally.
-
----
-
-## Troubleshooting
-
-| Symptom | Fix |
-|---------|-----|
-| Claude says "not authenticated" or 401 errors | Your sign-in may have expired or been revoked. Trigger any Leadbay tool again and Claude will re-prompt the **Sign in with Leadbay** flow |
-| Hosted connector won't sign in ("couldn't register" or "can't find your account") | Make sure the URL matches your instance — `/fr/mcp` for EU/France, `/mcp` for US |
-| Tools don't appear in Cowork | Make sure the extension toggle is **Enabled** in Settings → Extensions |
-| Tools appear but Claude won't call them | Open **Configure** and switch the tool groups to **Always allow** |
-| Wrong instance (no leads / 404s) | Sign out from the Leadbay extension and sign back in on the right instance (US or EU) |
-| Other issue | File a bug at [github.com/leadbay/leadclaw/issues](https://github.com/leadbay/leadclaw/issues) |