From 136409deb23905dbe39913147694671c1b4f4cf1 Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Fri, 19 Jun 2026 15:31:28 -0700 Subject: [PATCH 01/14] docs(mcp): add dedicated Leadbay MCP section Promote the single product-guides/leadbay-mcp.md page into a top-level "Leadbay MCP" section with four pages: What is Leadbay MCP?, Installation, Tools reference, Example prompts. Migrate the existing install content, fix .mcpb -> .dxt for the Claude extension, and repoint README quick-links and changelog references. FR mirror has the first two pages so far. Co-Authored-By: Claude --- README.md | 4 +- SUMMARY.md | 8 +- fr/README.md | 4 +- fr/SUMMARY.md | 6 +- fr/leadbay-mcp/installation.md | 174 ++++++++++++++++++ fr/leadbay-mcp/what-is-leadbay-mcp.md | 66 +++++++ fr/news/changelog.md | 4 +- fr/product-guides/leadbay-mcp.md | 117 ------------ leadbay-mcp/example-prompts.md | 169 +++++++++++++++++ .../installation.md | 34 ++-- leadbay-mcp/tools-reference.md | 163 ++++++++++++++++ leadbay-mcp/what-is-leadbay-mcp.md | 66 +++++++ news/changelog.md | 4 +- 13 files changed, 674 insertions(+), 145 deletions(-) create mode 100644 fr/leadbay-mcp/installation.md create mode 100644 fr/leadbay-mcp/what-is-leadbay-mcp.md delete mode 100644 fr/product-guides/leadbay-mcp.md create mode 100644 leadbay-mcp/example-prompts.md rename product-guides/leadbay-mcp.md => leadbay-mcp/installation.md (85%) create mode 100644 leadbay-mcp/tools-reference.md create mode 100644 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..e109fc1 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -13,11 +13,17 @@ * [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) +* [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..0514a32 100644 --- a/fr/SUMMARY.md +++ b/fr/SUMMARY.md @@ -13,11 +13,15 @@ * [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) +* [Installation](leadbay-mcp/installation.md) + ## Bonnes Pratiques * [Leadbay pour les commerciaux](overview/best-practice-guides/leadbay-for-sales-reps.md) diff --git a/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md new file mode 100644 index 0000000..f290cc8 --- /dev/null +++ b/fr/leadbay-mcp/installation.md @@ -0,0 +1,174 @@ +# Installation + +Connecter Leadbay à Claude prend environ une minute. Il y a trois façons de se connecter — choisissez celle qui correspond à votre client : + +- **Option A — Connecteur hébergé :** collez une URL, rien à installer. Idéal pour **Claude Desktop** et **ChatGPT**. +- **Option B — Installateur en une commande :** un assistant guidé. Idéal pour **Claude Desktop**, **Claude Code** et **Cursor**. +- **Option C — Extension `.dxt` manuelle :** téléchargez et installez à la main. Requis pour **Claude Cowork**. + +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 Desktop, Claude Cowork, Claude Code, Cursor ou ChatGPT +- Une minute + +--- + +## Option A — Connecteur hébergé (sans installation) + +La façon la plus rapide : Leadbay héberge un serveur MCP, vous ajoutez donc une URL de connecteur sans rien à télécharger, mettre à jour ou maintenir. Choisissez l'URL qui correspond à votre instance Leadbay : + +| Votre instance Leadbay | URL du connecteur | +|---|---| +| UE / France | `https://leadbay-mcp-prod.fly.dev/fr/mcp` | +| US | `https://leadbay-mcp-prod.fly.dev/mcp` | + +{% hint style="info" %} +Vous ne savez pas sur quelle instance vous êtes ? La plupart des comptes sont en UE/France — commencez par l'URL `/fr/mcp`. Si la connexion ne trouve pas votre compte, utilisez l'URL US. +{% endhint %} + +**Dans Claude Desktop :** + +1. Ouvrez **Settings → Connectors → Add custom connector**. +2. Collez l'URL de votre instance et confirmez. +3. La première fois que Claude utilise un outil Leadbay, une page **Se connecter avec Leadbay** s'ouvre dans votre navigateur — connectez-vous et cliquez sur **Approuver**. + +**Dans ChatGPT :** + +1. Ouvrez **Settings → Apps → Add app**. +2. Collez la même URL et suivez l'invite de connexion. + +Aucun jeton à copier ou renouveler. Vous pouvez révoquer l'accès à tout moment depuis **Paramètres → Applications connectées** dans Leadbay. + +--- + +## Option B — Installateur en une commande + +Vous préférez une installation locale, ou vous utilisez **Claude Code** ou **Cursor** ? Une seule commande installe Leadbay et vous connecte. 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), 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 +``` + +--- + +## Option C — Extension `.dxt` manuelle (Cowork) + +Claude Cowork installe les outils MCP à partir d'un fichier d'extension téléchargé. Utilisez cette méthode pour Cowork (elle fonctionne aussi pour Claude Desktop). + +### É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 `.dxt` (cherchez un nom du type `leadbay-X.Y.Z.dxt` 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.dxt` 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 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 dans Cowork 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. + +--- + +## Essayez + +Ouvrez une conversation et demandez : + +> *Récupère les meilleurs leads du jour et dis-moi lesquels valent la peine d'être ouverts ce matin.* + +Claude appellera `leadbay_pull_leads`, `leadbay_get_lead_profile`, et consorts — et répondra avec une liste courte et qualifiée. + +Quelques autres prompts qui fonctionnent d'emblée : + +- *Recherche acme.com — est-ce un bon fit pour nous ?* +- *Affine mon audience pour cibler les entreprises de l'UE 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 les workflows recommandés se trouvent dans le [README LeadClaw](https://github.com/leadbay/leadclaw#tools). + +--- + +## 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 + +Le connecteur hébergé (**Option A**) exécute toujours la dernière version — il n'y a rien à mettre à jour. + +Pour l'extension `.dxt` manuelle (**Option C**), quand une nouvelle release sort, répétez l'**Étape 1** (télécharger le nouveau `.dxt`) et l'**Étape 2** (Install extension). Cowork remplace l'ancienne version sur place ; votre connexion reste valide, vous n'avez donc pas à vous ré-authentifier. + +--- + +## 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** | +| Le connecteur hébergé ne se connecte pas (« échec d'enregistrement » ou « compte introuvable ») | Vérifiez que l'URL correspond à votre instance — `/fr/mcp` pour UE/France, `/mcp` pour US | +| 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 basculez les groupes d'outils sur **Always allow** | +| 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/what-is-leadbay-mcp.md b/fr/leadbay-mcp/what-is-leadbay-mcp.md new file mode 100644 index 0000000..145e5ed --- /dev/null +++ b/fr/leadbay-mcp/what-is-leadbay-mcp.md @@ -0,0 +1,66 @@ +# Qu'est-ce que Leadbay MCP ? + +Leadbay MCP donne à Claude un accès direct à votre compte Leadbay. Une fois connecté, vous pouvez demander à Claude — en langage naturel — de récupérer des leads, les qualifier, enrichir des contacts, rédiger des messages de prospection et journaliser vos actions. Claude effectue le travail avec **vos** vraies données et **vos** permissions, comme si vous l'aviez fait vous-même 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. + +--- + +## Ce que Claude peut faire + +Leadbay expose ses capacités à Claude sous forme d'**outils**, regroupés en deux familles : + +| Famille | Ce qu'elle couvre | Exemples | +|--------|---------------|----------| +| **Lecture seule** | Récupère des données, ne modifie jamais rien | Récupérer des leads, parcourir les lenses, lire des profils de lead, rechercher des contacts, consulter le quota d'enrichissement | +| **Écriture / activation** | Effectue des actions sur votre compte | Qualifier des leads, enrichir des contacts, ajouter des notes, importer des leads, journaliser la prospection, affiner votre audience | + +Tout est **limité à votre compte** — il n'y a rien de destructeur au niveau de la plateforme, et toute action prise par Claude est une action que vous pourriez prendre vous-même dans l'application. + +{% hint style="info" %} +La liste complète et à jour des outils ainsi que les workflows recommandés se trouvent dans le [README LeadClaw](https://github.com/leadbay/leadclaw#tools). +{% endhint %} + +--- + +## Où ça fonctionne + +Leadbay MCP fonctionne avec tout assistant IA qui supporte le Model Context Protocol : + +- **Claude Desktop** +- **Claude Code** +- **Claude Cowork** +- **Cursor** +- **ChatGPT** + +--- + +## Comment fonctionne la connexion + +Vous n'avez jamais à copier, coller ou renouveler de jetons d'API. La première fois que Claude appelle un outil Leadbay, une page **Se connecter avec Leadbay** s'ouvre dans votre navigateur — vous vous connectez, cliquez sur **Approuver**, et Claude est relié à votre compte. Vous pouvez révoquer l'accès à tout moment depuis **Paramètres → Applications connectées** dans Leadbay. + +--- + +## Étape suivante + +Prêt à connecter ? Rendez-vous sur le guide d'installation. + +{% content-ref url="installation.md" %} +[installation.md](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..66000f2 --- /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 and asks you to confirm anything that changes your account. +{% 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, so Claude confirms first. + +--- + +## 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/product-guides/leadbay-mcp.md b/leadbay-mcp/installation.md similarity index 85% rename from product-guides/leadbay-mcp.md rename to leadbay-mcp/installation.md index 381bd0b..55bb314 100644 --- a/product-guides/leadbay-mcp.md +++ b/leadbay-mcp/installation.md @@ -1,17 +1,15 @@ -# Leadbay MCP for Claude +# Installation -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: +Connecting Leadbay to Claude takes about a minute. 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**. +- **Option C — Manual `.dxt` 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. +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 %} --- @@ -70,13 +68,13 @@ npx -y -p @leadbay/mcp@latest installer --uninstall --- -## Option C — Manual `.mcpb` extension (Cowork) +## Option C — Manual `.dxt` 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**). +Open the [LeadClaw releases page](https://github.com/leadbay/leadclaw/releases/) and grab the latest `.dxt` file (look for a name like `leadbay-X.Y.Z.dxt` under the most recent release's **Assets**). Save it somewhere easy to find — your Downloads folder works. @@ -88,7 +86,7 @@ In Claude Cowork, go to: **Settings → Extensions → Advanced → Install extension** -Pick the `leadbay-X.Y.Z.mcpb` file you downloaded in Step 1. +Pick the `leadbay-X.Y.Z.dxt` file you downloaded in Step 1. A dialog opens with the extension details. Click **Install**, then confirm with **Install** again. @@ -130,7 +128,7 @@ To configure: in the Leadbay extension's **Configure** screen, set **Always allo ## Try it -Open a Cowork conversation and ask: +Open a conversation and ask: > *Pull today's top leads and tell me which two are worth opening this morning.* @@ -146,14 +144,6 @@ The full list of tools and recommended workflows is in the [LeadClaw README](htt --- -## 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. @@ -164,6 +154,14 @@ If your first message gets a response like *"I don't see any Leadbay tools"* or --- +## Updating + +The hosted connector (**Option A**) always runs the latest version — there's nothing to update. + +For the manual `.dxt` extension (**Option C**), when a new release ships, repeat **Step 1** (download the new `.dxt`) 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. + +--- + ## Troubleshooting | Symptom | Fix | diff --git a/leadbay-mcp/tools-reference.md b/leadbay-mcp/tools-reference.md new file mode 100644 index 0000000..fab5783 --- /dev/null +++ b/leadbay-mcp/tools-reference.md @@ -0,0 +1,163 @@ +# 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. Always available. +- **Write / activate** — take action on your account. On by default; an admin can disable them with `LEADBAY_MCP_WRITE=0`. + +{% hint style="info" %} +This page covers the tools a normal user sees. There's also an **advanced** set of low-level, single-API-call tools for integrations and power users, hidden behind `LEADBAY_MCP_ADVANCED=1`. Most people never need them. The current source of truth for every tool is the [LeadClaw README](https://github.com/leadbay/leadclaw#tools). +{% endhint %} + +--- + +## 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..7861625 --- /dev/null +++ b/leadbay-mcp/what-is-leadbay-mcp.md @@ -0,0 +1,66 @@ +# What is Leadbay MCP? + +Leadbay MCP gives Claude direct access to your Leadbay account. Once connected, you can ask Claude — in plain language — to pull leads, qualify them, enrich contacts, draft outreach, and log activity. Claude does the work using **your** real data, with **your** permissions, the same as if you'd done it yourself 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. + +--- + +## What Claude can do + +Leadbay exposes its capabilities to Claude as **tools**, grouped into two flavors: + +| Flavor | What it covers | Examples | +|--------|---------------|----------| +| **Read-only** | Pulls data, never changes anything | Pull leads, browse lenses, read lead profiles, look up contacts, check enrichment quota | +| **Write / activate** | Takes action on your account | Qualify leads, enrich contacts, add notes, import leads, report outreach, refine your audience | + +Everything is **scoped to your account** — there's nothing destructive at the platform level, and any action Claude takes is one you could take yourself in the app. + +{% hint style="info" %} +The full, current list of tools and recommended workflows lives in the [LeadClaw README](https://github.com/leadbay/leadclaw#tools). +{% endhint %} + +--- + +## Where it works + +Leadbay MCP works with any AI assistant that supports the Model Context Protocol: + +- **Claude Desktop** +- **Claude Code** +- **Claude Cowork** +- **Cursor** +- **ChatGPT** + +--- + +## How sign-in works + +You never copy, paste, or rotate API tokens. The first time Claude calls a Leadbay tool, a **Sign in with Leadbay** page opens in your browser — you log in, click **Approve**, and Claude is connected to your account. You can revoke access anytime from **Settings → Connected apps** in Leadbay. + +--- + +## Next step + +Ready to connect? Head to the installation guide. + +{% content-ref url="installation.md" %} +[installation.md](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 From 31c1c96e6284c2ee36a8c42dc2e00af4f8f8c25d Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Fri, 19 Jun 2026 15:34:31 -0700 Subject: [PATCH 02/14] =?UTF-8?q?docs(mcp):=20complete=20French=20mirror?= =?UTF-8?q?=20=E2=80=94=20tools=20reference=20+=20example=20prompts?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds FR translations of the Tools reference and Example prompts pages, bringing the French Leadbay MCP section to 4-page parity with English, and registers them in fr/SUMMARY.md. Co-Authored-By: Claude --- fr/SUMMARY.md | 2 + fr/leadbay-mcp/example-prompts.md | 169 ++++++++++++++++++++++++++++++ fr/leadbay-mcp/tools-reference.md | 163 ++++++++++++++++++++++++++++ 3 files changed, 334 insertions(+) create mode 100644 fr/leadbay-mcp/example-prompts.md create mode 100644 fr/leadbay-mcp/tools-reference.md diff --git a/fr/SUMMARY.md b/fr/SUMMARY.md index 0514a32..27c982b 100644 --- a/fr/SUMMARY.md +++ b/fr/SUMMARY.md @@ -21,6 +21,8 @@ * [Qu'est-ce que Leadbay MCP ?](leadbay-mcp/what-is-leadbay-mcp.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 diff --git a/fr/leadbay-mcp/example-prompts.md b/fr/leadbay-mcp/example-prompts.md new file mode 100644 index 0000000..1cbd5f7 --- /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 et vous demande de confirmer tout ce qui modifie votre compte. +{% 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, donc Claude confirme d'abord. + +--- + +## 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/tools-reference.md b/fr/leadbay-mcp/tools-reference.md new file mode 100644 index 0000000..9be55ac --- /dev/null +++ b/fr/leadbay-mcp/tools-reference.md @@ -0,0 +1,163 @@ +# 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. Toujours disponibles. +- **Écriture / activation** — effectuent une action sur votre compte. Activés par défaut ; un administrateur peut les désactiver avec `LEADBAY_MCP_WRITE=0`. + +{% hint style="info" %} +Cette page couvre les outils qu'un utilisateur normal voit. Il existe aussi un jeu d'outils **avancés**, de bas niveau (un appel API chacun), pour les intégrations et les utilisateurs experts, masqués derrière `LEADBAY_MCP_ADVANCED=1`. La plupart des gens n'en ont jamais besoin. La source de vérité à jour pour chaque outil est le [README LeadClaw](https://github.com/leadbay/leadclaw#tools). +{% endhint %} + +--- + +## 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 %} From 33b269f8b762fd69b66f63ae1993b6c182e88a5f Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Mon, 22 Jun 2026 11:03:53 -0700 Subject: [PATCH 03/14] docs(mcp): add Quickstart + key concepts for smoother onboarding MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Close the onboarding gaps surfaced while reviewing the section: - New Quickstart page (EN + FR): one linear first-5-minutes flow — pick client, install, the auto-opening sign-in page, first prompt, and what a successful result looks like. - Key concepts block on What-is (lens, score, AI score, taste profile, read vs write) so prompts make sense to a new user. - Troubleshooting row for the connected-but-empty-list case. - Cross-links: What-is now points to Quickstart first. Co-Authored-By: Claude --- SUMMARY.md | 1 + fr/SUMMARY.md | 1 + fr/leadbay-mcp/installation.md | 1 + fr/leadbay-mcp/quickstart.md | 105 ++++++++++++++++++++++++++ fr/leadbay-mcp/what-is-leadbay-mcp.md | 24 +++++- leadbay-mcp/installation.md | 1 + leadbay-mcp/quickstart.md | 105 ++++++++++++++++++++++++++ leadbay-mcp/what-is-leadbay-mcp.md | 24 +++++- 8 files changed, 258 insertions(+), 4 deletions(-) create mode 100644 fr/leadbay-mcp/quickstart.md create mode 100644 leadbay-mcp/quickstart.md diff --git a/SUMMARY.md b/SUMMARY.md index e109fc1..1e24ae0 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -20,6 +20,7 @@ ## 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) diff --git a/fr/SUMMARY.md b/fr/SUMMARY.md index 27c982b..dc55b8e 100644 --- a/fr/SUMMARY.md +++ b/fr/SUMMARY.md @@ -20,6 +20,7 @@ ## 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) diff --git a/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md index f290cc8..b32d28b 100644 --- a/fr/leadbay-mcp/installation.md +++ b/fr/leadbay-mcp/installation.md @@ -170,5 +170,6 @@ Pour l'extension `.dxt` manuelle (**Option C**), quand une nouvelle release sort | Le connecteur hébergé ne se connecte pas (« échec d'enregistrement » ou « compte introuvable ») | Vérifiez que l'URL correspond à votre instance — `/fr/mcp` pour UE/France, `/mcp` pour US | | 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 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..2421cef --- /dev/null +++ b/fr/leadbay-mcp/quickstart.md @@ -0,0 +1,105 @@ +# 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 Code, Claude Cowork, Cursor ou ChatGPT). C'est tout — aucun jeton d'API à copier ou coller. +{% endhint %} + +--- + +## Étape 1 — Installer + +Choisissez la voie qui correspond à votre client. (Les détails complets de chacune sont dans le guide d'[Installation](installation.md).) + +| Votre client | Voie la plus rapide | +|---|---| +| **Claude Desktop** ou **ChatGPT** | **Connecteur hébergé** — collez une URL, rien à installer | +| **Claude Code** ou **Cursor** | **Installateur en une commande** — `npx -y -p @leadbay/mcp@latest installer` | +| **Claude Cowork** | **Extension `.dxt` manuelle** — téléchargez depuis les releases et installez | + +**URL du connecteur hébergé** (Desktop / ChatGPT — ajoutez-la dans *Settings → Connectors → Add custom connector*) : + +| Instance | URL | +|---|---| +| UE / France | `https://leadbay-mcp-prod.fly.dev/fr/mcp` | +| US | `https://leadbay-mcp-prod.fly.dev/mcp` | + +**Installateur en une commande** (Code / Cursor — nécessite [Node.js](https://nodejs.org) 22+) : + +```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é. 🎉 + +{% hint style="warning" %} +**Liste vide ou « aucun lead » ?** Vous êtes connecté, mais Claude n'a rien trouvé à afficher. En général cela signifie que votre lens active n'a pas de leads frais pour l'instant, ou que vous êtes connecté sur la mauvaise instance (US vs UE). Essayez *« montre-moi mes lenses »* pour confirmer ce qui est actif, ou voyez le [Dépannage](installation.md#depannage). +{% endhint %} + +--- + +## É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="what-is-leadbay-mcp.md" %} +[Qu'est-ce que Leadbay MCP ?](what-is-leadbay-mcp.md) +{% endcontent-ref %} + +{% 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/what-is-leadbay-mcp.md b/fr/leadbay-mcp/what-is-leadbay-mcp.md index 145e5ed..08e2ddf 100644 --- a/fr/leadbay-mcp/what-is-leadbay-mcp.md +++ b/fr/leadbay-mcp/what-is-leadbay-mcp.md @@ -51,6 +51,22 @@ Leadbay MCP fonctionne avec tout assistant IA qui supporte le Model Context Prot --- +## 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, et Claude confirme avant toute action qui écrit. | + +Ces notions sont détaillées dans les guides produit [Lenses](../product-guides/lenses.md) et [AI Assistant](../product-guides/ai-assistant.md). + +--- + ## Comment fonctionne la connexion Vous n'avez jamais à copier, coller ou renouveler de jetons d'API. La première fois que Claude appelle un outil Leadbay, une page **Se connecter avec Leadbay** s'ouvre dans votre navigateur — vous vous connectez, cliquez sur **Approuver**, et Claude est relié à votre compte. Vous pouvez révoquer l'accès à tout moment depuis **Paramètres → Applications connectées** dans Leadbay. @@ -59,8 +75,12 @@ Vous n'avez jamais à copier, coller ou renouveler de jetons d'API. La première ## Étape suivante -Prêt à connecter ? Rendez-vous sur le guide d'installation. +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.md](installation.md) +[Installation](installation.md) {% endcontent-ref %} diff --git a/leadbay-mcp/installation.md b/leadbay-mcp/installation.md index 55bb314..f82cf1a 100644 --- a/leadbay-mcp/installation.md +++ b/leadbay-mcp/installation.md @@ -170,5 +170,6 @@ For the manual `.dxt` extension (**Option C**), when a new release ships, repeat | 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** | +| 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..b0d2bac --- /dev/null +++ b/leadbay-mcp/quickstart.md @@ -0,0 +1,105 @@ +# 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 Code, Claude Cowork, Cursor, or ChatGPT). That's it — no API tokens to copy or paste. +{% endhint %} + +--- + +## Step 1 — Install + +Pick the path that matches your client. (Full details for each are in the [Installation](installation.md) guide.) + +| Your client | Fastest path | +|---|---| +| **Claude Desktop** or **ChatGPT** | **Hosted connector** — paste a URL, nothing to install | +| **Claude Code** or **Cursor** | **One-command installer** — `npx -y -p @leadbay/mcp@latest installer` | +| **Claude Cowork** | **Manual `.dxt` extension** — download from releases and install | + +**Hosted connector URL** (Desktop / ChatGPT — add it under *Settings → Connectors → Add custom connector*): + +| Instance | URL | +|---|---| +| EU / France | `https://leadbay-mcp-prod.fly.dev/fr/mcp` | +| US | `https://leadbay-mcp-prod.fly.dev/mcp` | + +**One-command installer** (Code / Cursor — needs [Node.js](https://nodejs.org) 22+): + +```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. 🎉 + +{% hint style="warning" %} +**Got an empty list or "no leads"?** You're connected, but Claude found nothing to show. Usually that means your active lens has no fresh leads right now, or you're signed in to the wrong instance (US vs EU). Try *"show me my lenses"* to confirm what's active, or see [Troubleshooting](installation.md#troubleshooting). +{% endhint %} + +--- + +## 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="what-is-leadbay-mcp.md" %} +[What is Leadbay MCP?](what-is-leadbay-mcp.md) +{% endcontent-ref %} + +{% 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/what-is-leadbay-mcp.md b/leadbay-mcp/what-is-leadbay-mcp.md index 7861625..303db7f 100644 --- a/leadbay-mcp/what-is-leadbay-mcp.md +++ b/leadbay-mcp/what-is-leadbay-mcp.md @@ -51,6 +51,22 @@ Leadbay MCP works with any AI assistant that supports the Model Context Protocol --- +## 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, and Claude confirms before anything that writes. | + +These are covered in depth in the [Lenses](../product-guides/lenses.md) and [AI Assistant](../product-guides/ai-assistant.md) product guides. + +--- + ## How sign-in works You never copy, paste, or rotate API tokens. The first time Claude calls a Leadbay tool, a **Sign in with Leadbay** page opens in your browser — you log in, click **Approve**, and Claude is connected to your account. You can revoke access anytime from **Settings → Connected apps** in Leadbay. @@ -59,8 +75,12 @@ You never copy, paste, or rotate API tokens. The first time Claude calls a Leadb ## Next step -Ready to connect? Head to the installation guide. +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.md](installation.md) +[Installation](installation.md) {% endcontent-ref %} From 0b35355db85096d3423621dd937372295eacf9f6 Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Mon, 22 Jun 2026 11:41:34 -0700 Subject: [PATCH 04/14] docs(mcp): tighten the Leadbay MCP definition Lead with a one-line bold definition, then a short supporting sentence, instead of one dense clause-stacked paragraph (EN + FR). Co-Authored-By: Claude --- fr/leadbay-mcp/what-is-leadbay-mcp.md | 4 +++- leadbay-mcp/what-is-leadbay-mcp.md | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/fr/leadbay-mcp/what-is-leadbay-mcp.md b/fr/leadbay-mcp/what-is-leadbay-mcp.md index 08e2ddf..8528670 100644 --- a/fr/leadbay-mcp/what-is-leadbay-mcp.md +++ b/fr/leadbay-mcp/what-is-leadbay-mcp.md @@ -1,6 +1,8 @@ # Qu'est-ce que Leadbay MCP ? -Leadbay MCP donne à Claude un accès direct à votre compte Leadbay. Une fois connecté, vous pouvez demander à Claude — en langage naturel — de récupérer des leads, les qualifier, enrichir des contacts, rédiger des messages de prospection et journaliser vos actions. Claude effectue le travail avec **vos** vraies données et **vos** permissions, comme si vous l'aviez fait vous-même dans l'application. +**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). diff --git a/leadbay-mcp/what-is-leadbay-mcp.md b/leadbay-mcp/what-is-leadbay-mcp.md index 303db7f..10f65d9 100644 --- a/leadbay-mcp/what-is-leadbay-mcp.md +++ b/leadbay-mcp/what-is-leadbay-mcp.md @@ -1,6 +1,8 @@ # What is Leadbay MCP? -Leadbay MCP gives Claude direct access to your Leadbay account. Once connected, you can ask Claude — in plain language — to pull leads, qualify them, enrich contacts, draft outreach, and log activity. Claude does the work using **your** real data, with **your** permissions, the same as if you'd done it yourself in the app. +**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). From d8edc4009835a70cf3e097aa4baefcc97fad09ca Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Mon, 22 Jun 2026 11:42:52 -0700 Subject: [PATCH 05/14] =?UTF-8?q?docs(mcp):=20trim=20What-is=20=E2=80=94?= =?UTF-8?q?=20drop=20tools/sign-in=20sections,=20fix=20client=20list?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Remove "What Claude can do" (covered by Tools reference) and "How sign-in works" (covered by Quickstart). Update "Where it works" to Claude, Claude Code, Codex (EN + FR). Co-Authored-By: Claude --- fr/leadbay-mcp/what-is-leadbay-mcp.md | 29 ++------------------------- leadbay-mcp/what-is-leadbay-mcp.md | 29 ++------------------------- 2 files changed, 4 insertions(+), 54 deletions(-) diff --git a/fr/leadbay-mcp/what-is-leadbay-mcp.md b/fr/leadbay-mcp/what-is-leadbay-mcp.md index 8528670..3cb6691 100644 --- a/fr/leadbay-mcp/what-is-leadbay-mcp.md +++ b/fr/leadbay-mcp/what-is-leadbay-mcp.md @@ -24,32 +24,13 @@ Claude lit vos leads, vos lenses et votre profil de goût, raisonne dessus, et r --- -## Ce que Claude peut faire - -Leadbay expose ses capacités à Claude sous forme d'**outils**, regroupés en deux familles : - -| Famille | Ce qu'elle couvre | Exemples | -|--------|---------------|----------| -| **Lecture seule** | Récupère des données, ne modifie jamais rien | Récupérer des leads, parcourir les lenses, lire des profils de lead, rechercher des contacts, consulter le quota d'enrichissement | -| **Écriture / activation** | Effectue des actions sur votre compte | Qualifier des leads, enrichir des contacts, ajouter des notes, importer des leads, journaliser la prospection, affiner votre audience | - -Tout est **limité à votre compte** — il n'y a rien de destructeur au niveau de la plateforme, et toute action prise par Claude est une action que vous pourriez prendre vous-même dans l'application. - -{% hint style="info" %} -La liste complète et à jour des outils ainsi que les workflows recommandés se trouvent dans le [README LeadClaw](https://github.com/leadbay/leadclaw#tools). -{% endhint %} - ---- - ## Où ça fonctionne Leadbay MCP fonctionne avec tout assistant IA qui supporte le Model Context Protocol : -- **Claude Desktop** +- **Claude** - **Claude Code** -- **Claude Cowork** -- **Cursor** -- **ChatGPT** +- **Codex** --- @@ -69,12 +50,6 @@ Ces notions sont détaillées dans les guides produit [Lenses](../product-guides --- -## Comment fonctionne la connexion - -Vous n'avez jamais à copier, coller ou renouveler de jetons d'API. La première fois que Claude appelle un outil Leadbay, une page **Se connecter avec Leadbay** s'ouvre dans votre navigateur — vous vous connectez, cliquez sur **Approuver**, et Claude est relié à votre compte. Vous pouvez révoquer l'accès à tout moment depuis **Paramètres → Applications connectées** dans Leadbay. - ---- - ## Étape suivante Prêt à connecter ? Le Démarrage rapide vous amène à vos premiers leads en environ cinq minutes. diff --git a/leadbay-mcp/what-is-leadbay-mcp.md b/leadbay-mcp/what-is-leadbay-mcp.md index 10f65d9..443ef42 100644 --- a/leadbay-mcp/what-is-leadbay-mcp.md +++ b/leadbay-mcp/what-is-leadbay-mcp.md @@ -24,32 +24,13 @@ Claude reads your leads, lenses, and taste profile, reasons over them, and repli --- -## What Claude can do - -Leadbay exposes its capabilities to Claude as **tools**, grouped into two flavors: - -| Flavor | What it covers | Examples | -|--------|---------------|----------| -| **Read-only** | Pulls data, never changes anything | Pull leads, browse lenses, read lead profiles, look up contacts, check enrichment quota | -| **Write / activate** | Takes action on your account | Qualify leads, enrich contacts, add notes, import leads, report outreach, refine your audience | - -Everything is **scoped to your account** — there's nothing destructive at the platform level, and any action Claude takes is one you could take yourself in the app. - -{% hint style="info" %} -The full, current list of tools and recommended workflows lives in the [LeadClaw README](https://github.com/leadbay/leadclaw#tools). -{% endhint %} - ---- - ## Where it works Leadbay MCP works with any AI assistant that supports the Model Context Protocol: -- **Claude Desktop** +- **Claude** - **Claude Code** -- **Claude Cowork** -- **Cursor** -- **ChatGPT** +- **Codex** --- @@ -69,12 +50,6 @@ These are covered in depth in the [Lenses](../product-guides/lenses.md) and [AI --- -## How sign-in works - -You never copy, paste, or rotate API tokens. The first time Claude calls a Leadbay tool, a **Sign in with Leadbay** page opens in your browser — you log in, click **Approve**, and Claude is connected to your account. You can revoke access anytime from **Settings → Connected apps** in Leadbay. - ---- - ## Next step Ready to connect? The Quickstart gets you to your first leads in about five minutes. From 5a47df5d7a71b5cf02cbad03acdbce1bc3d0863f Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Mon, 22 Jun 2026 11:48:53 -0700 Subject: [PATCH 06/14] docs(mcp): drop empty-list warning from Quickstart step 4 (EN + FR) Co-Authored-By: Claude --- fr/leadbay-mcp/quickstart.md | 4 ---- leadbay-mcp/quickstart.md | 4 ---- 2 files changed, 8 deletions(-) diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md index 2421cef..45a31f5 100644 --- a/fr/leadbay-mcp/quickstart.md +++ b/fr/leadbay-mcp/quickstart.md @@ -70,10 +70,6 @@ Une première réponse réussie ressemble à un **tableau de leads classés**, p Si Claude répond avec des leads comme ça, vous êtes complètement connecté. 🎉 -{% hint style="warning" %} -**Liste vide ou « aucun lead » ?** Vous êtes connecté, mais Claude n'a rien trouvé à afficher. En général cela signifie que votre lens active n'a pas de leads frais pour l'instant, ou que vous êtes connecté sur la mauvaise instance (US vs UE). Essayez *« montre-moi mes lenses »* pour confirmer ce qui est actif, ou voyez le [Dépannage](installation.md#depannage). -{% endhint %} - --- ## Étape 5 — Continuez diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md index b0d2bac..512273c 100644 --- a/leadbay-mcp/quickstart.md +++ b/leadbay-mcp/quickstart.md @@ -70,10 +70,6 @@ A successful first response looks like a **ranked table of leads**, not a wall o If Claude replies with leads like that, you're fully connected. 🎉 -{% hint style="warning" %} -**Got an empty list or "no leads"?** You're connected, but Claude found nothing to show. Usually that means your active lens has no fresh leads right now, or you're signed in to the wrong instance (US vs EU). Try *"show me my lenses"* to confirm what's active, or see [Troubleshooting](installation.md#troubleshooting). -{% endhint %} - --- ## Step 5 — Keep going From 71178a35fcf0d639a58b18b344f98892e989e649 Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Mon, 22 Jun 2026 11:52:43 -0700 Subject: [PATCH 07/14] docs(mcp): make .dxt the primary install method, installer the alternative Drop the Option A/B/C framing. Lead Installation + Quickstart with the .dxt extension as the recommended method and present the one-command installer as an alternative; remove the hosted-connector section. Client list aligned to Claude / Claude Code / Codex (EN + FR). Co-Authored-By: Claude --- fr/leadbay-mcp/installation.md | 89 +++++++++++----------------------- fr/leadbay-mcp/quickstart.md | 16 ++---- leadbay-mcp/installation.md | 89 +++++++++++----------------------- leadbay-mcp/quickstart.md | 16 ++---- 4 files changed, 66 insertions(+), 144 deletions(-) diff --git a/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md index b32d28b..818cac0 100644 --- a/fr/leadbay-mcp/installation.md +++ b/fr/leadbay-mcp/installation.md @@ -1,10 +1,6 @@ # Installation -Connecter Leadbay à Claude prend environ une minute. Il y a trois façons de se connecter — choisissez celle qui correspond à votre client : - -- **Option A — Connecteur hébergé :** collez une URL, rien à installer. Idéal pour **Claude Desktop** et **ChatGPT**. -- **Option B — Installateur en une commande :** un assistant guidé. Idéal pour **Claude Desktop**, **Claude Code** et **Cursor**. -- **Option C — Extension `.dxt` manuelle :** téléchargez et installez à la main. Requis pour **Claude Cowork**. +Connecter Leadbay à Claude prend environ une minute. La méthode recommandée est l'**extension `.dxt`** — téléchargez un fichier et installez-le. Si vous préférez automatiser la configuration, l'**installateur en une commande** est une alternative. La configuration avancée et les autres clients sont couverts dans le [README Leadbay MCP](https://github.com/leadbay/leadclaw#install). @@ -17,60 +13,14 @@ Le serveur MCP utilise **votre** compte Leadbay, donc toute action prise par Cla ## 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 Desktop, Claude Cowork, Claude Code, Cursor ou ChatGPT +- Un assistant IA qui supporte MCP — Claude, Claude Code ou Codex - Une minute --- -## Option A — Connecteur hébergé (sans installation) - -La façon la plus rapide : Leadbay héberge un serveur MCP, vous ajoutez donc une URL de connecteur sans rien à télécharger, mettre à jour ou maintenir. Choisissez l'URL qui correspond à votre instance Leadbay : - -| Votre instance Leadbay | URL du connecteur | -|---|---| -| UE / France | `https://leadbay-mcp-prod.fly.dev/fr/mcp` | -| US | `https://leadbay-mcp-prod.fly.dev/mcp` | - -{% hint style="info" %} -Vous ne savez pas sur quelle instance vous êtes ? La plupart des comptes sont en UE/France — commencez par l'URL `/fr/mcp`. Si la connexion ne trouve pas votre compte, utilisez l'URL US. -{% endhint %} - -**Dans Claude Desktop :** - -1. Ouvrez **Settings → Connectors → Add custom connector**. -2. Collez l'URL de votre instance et confirmez. -3. La première fois que Claude utilise un outil Leadbay, une page **Se connecter avec Leadbay** s'ouvre dans votre navigateur — connectez-vous et cliquez sur **Approuver**. - -**Dans ChatGPT :** - -1. Ouvrez **Settings → Apps → Add app**. -2. Collez la même URL et suivez l'invite de connexion. - -Aucun jeton à copier ou renouveler. Vous pouvez révoquer l'accès à tout moment depuis **Paramètres → Applications connectées** dans Leadbay. - ---- - -## Option B — Installateur en une commande - -Vous préférez une installation locale, ou vous utilisez **Claude Code** ou **Cursor** ? Une seule commande installe Leadbay et vous connecte. 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), 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 -``` - ---- - -## Option C — Extension `.dxt` manuelle (Cowork) +## Installer l'extension `.dxt` (recommandé) -Claude Cowork installe les outils MCP à partir d'un fichier d'extension téléchargé. Utilisez cette méthode pour Cowork (elle fonctionne aussi pour Claude Desktop). +La configuration la plus simple : téléchargez un seul fichier d'extension et installez-le. ### Étape 1 — Télécharger la dernière extension @@ -80,9 +30,9 @@ Sauvegardez-le dans un endroit facile à retrouver — votre dossier Télécharg --- -### Étape 2 — Installer l'extension dans Cowork +### Étape 2 — Installer l'extension -Dans Claude Cowork, allez dans : +Dans Claude, allez dans : **Settings → Extensions → Advanced → Install extension** @@ -106,7 +56,7 @@ La première fois que Claude appelle un outil Leadbay, il déclenche un flux **S 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 dans Cowork et en vous reconnectant sur l'autre instance. +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 %} --- @@ -126,6 +76,24 @@ Pour configurer : dans l'écran **Configure** de l'extension Leadbay, réglez ** --- +## Alternative — installateur en une commande + +Vous préférez automatiser la configuration, ou vous utilisez **Claude Code** ou **Cursor** ? Une seule commande installe Leadbay et vous connecte. 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), 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 +``` + +--- + ## Essayez Ouvrez une conversation et demandez : @@ -156,9 +124,9 @@ Si votre premier message reçoit une réponse du type *« Je ne vois aucun outil ## Mise à jour -Le connecteur hébergé (**Option A**) exécute toujours la dernière version — il n'y a rien à mettre à 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. -Pour l'extension `.dxt` manuelle (**Option C**), quand une nouvelle release sort, répétez l'**Étape 1** (télécharger le nouveau `.dxt`) et l'**Étape 2** (Install extension). Cowork 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. --- @@ -167,8 +135,7 @@ Pour l'extension `.dxt` manuelle (**Option C**), quand une nouvelle release sort | 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** | -| Le connecteur hébergé ne se connecte pas (« échec d'enregistrement » ou « compte introuvable ») | Vérifiez que l'URL correspond à votre instance — `/fr/mcp` pour UE/France, `/mcp` pour US | -| Les outils n'apparaissent pas dans Cowork | Vérifiez que l'extension est bien sur **Enabled** dans Settings → Extensions | +| 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) | diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md index 45a31f5..ae1d44a 100644 --- a/fr/leadbay-mcp/quickstart.md +++ b/fr/leadbay-mcp/quickstart.md @@ -10,22 +10,16 @@ Il vous faut un [compte Leadbay](https://leadbay.ai/) et un assistant IA qui sup ## Étape 1 — Installer -Choisissez la voie qui correspond à votre client. (Les détails complets de chacune sont dans le guide d'[Installation](installation.md).) +La voie recommandée est l'**extension `.dxt`** — téléchargez un fichier et installez-le. (Les détails complets et les autres options sont dans le guide d'[Installation](installation.md).) -| Votre client | Voie la plus rapide | +| Votre client | Voie recommandée | |---|---| -| **Claude Desktop** ou **ChatGPT** | **Connecteur hébergé** — collez une URL, rien à installer | +| **Claude Desktop** ou **Claude Cowork** | **Extension `.dxt`** — téléchargez depuis les releases et installez | | **Claude Code** ou **Cursor** | **Installateur en une commande** — `npx -y -p @leadbay/mcp@latest installer` | -| **Claude Cowork** | **Extension `.dxt` manuelle** — téléchargez depuis les releases et installez | -**URL du connecteur hébergé** (Desktop / ChatGPT — ajoutez-la dans *Settings → Connectors → Add custom connector*) : +**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/), puis dans Claude ouvrez **Settings → Extensions → Advanced → Install extension** et sélectionnez le fichier. -| Instance | URL | -|---|---| -| UE / France | `https://leadbay-mcp-prod.fly.dev/fr/mcp` | -| US | `https://leadbay-mcp-prod.fly.dev/mcp` | - -**Installateur en une commande** (Code / Cursor — nécessite [Node.js](https://nodejs.org) 22+) : +**Installateur en une commande** (alternative — Code / Cursor, nécessite [Node.js](https://nodejs.org) 22+) : ```bash npx -y -p @leadbay/mcp@latest installer diff --git a/leadbay-mcp/installation.md b/leadbay-mcp/installation.md index f82cf1a..942cd99 100644 --- a/leadbay-mcp/installation.md +++ b/leadbay-mcp/installation.md @@ -1,10 +1,6 @@ # Installation -Connecting Leadbay to Claude takes about a minute. 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 `.dxt` extension:** download and install by hand. Required for **Claude Cowork**. +Connecting Leadbay to Claude takes about a minute. The recommended way is the **`.dxt` extension** — download one file and install it. If you'd rather automate the setup, the **one-command installer** is an alternative. Advanced setup and other clients are covered in the [Leadbay MCP README](https://github.com/leadbay/leadclaw#install). @@ -17,60 +13,14 @@ The MCP server uses **your** Leadbay account, so any action Claude takes is the ## 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 +- An AI assistant that supports MCP — Claude, Claude Code, or Codex - 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 `.dxt` extension (Cowork) +## Install the `.dxt` extension (recommended) -Claude Cowork installs MCP tools from a downloaded extension file. Use this method for Cowork (it also works for Claude Desktop). +The simplest setup: download a single extension file and install it. ### Step 1 — Download the latest extension @@ -80,9 +30,9 @@ Save it somewhere easy to find — your Downloads folder works. --- -### Step 2 — Install the extension in Cowork +### Step 2 — Install the extension -In Claude Cowork, go to: +In Claude, go to: **Settings → Extensions → Advanced → Install extension** @@ -106,7 +56,7 @@ The first time Claude calls a Leadbay tool, it triggers a one-tap **Sign in with 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. +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 %} --- @@ -126,6 +76,24 @@ To configure: in the Leadbay extension's **Configure** screen, set **Always allo --- +## Alternative — one-command installer + +Prefer to automate the 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 +``` + +--- + ## Try it Open a conversation and ask: @@ -156,9 +124,9 @@ If your first message gets a response like *"I don't see any Leadbay tools"* or ## Updating -The hosted connector (**Option A**) always runs the latest version — there's nothing to update. +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. -For the manual `.dxt` extension (**Option C**), when a new release ships, repeat **Step 1** (download the new `.dxt`) 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. +The **one-command installer** always runs the latest version — there's nothing to update. --- @@ -167,8 +135,7 @@ For the manual `.dxt` extension (**Option C**), when a new release ships, repeat | 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 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) | diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md index 512273c..5267329 100644 --- a/leadbay-mcp/quickstart.md +++ b/leadbay-mcp/quickstart.md @@ -10,22 +10,16 @@ You'll need a [Leadbay account](https://leadbay.ai/) and an AI assistant that su ## Step 1 — Install -Pick the path that matches your client. (Full details for each are in the [Installation](installation.md) guide.) +The recommended path is the **`.dxt` extension** — download one file and install it. (Full details and the other options are in the [Installation](installation.md) guide.) -| Your client | Fastest path | +| Your client | Recommended path | |---|---| -| **Claude Desktop** or **ChatGPT** | **Hosted connector** — paste a URL, nothing to install | +| **Claude Desktop** or **Claude Cowork** | **`.dxt` extension** — download from releases and install | | **Claude Code** or **Cursor** | **One-command installer** — `npx -y -p @leadbay/mcp@latest installer` | -| **Claude Cowork** | **Manual `.dxt` extension** — download from releases and install | -**Hosted connector URL** (Desktop / ChatGPT — add it under *Settings → Connectors → Add custom connector*): +**`.dxt` extension** (recommended): download the latest `leadbay-X.Y.Z.dxt` from the [LeadClaw releases page](https://github.com/leadbay/leadclaw/releases/), then in Claude open **Settings → Extensions → Advanced → Install extension** and pick the file. -| Instance | URL | -|---|---| -| EU / France | `https://leadbay-mcp-prod.fly.dev/fr/mcp` | -| US | `https://leadbay-mcp-prod.fly.dev/mcp` | - -**One-command installer** (Code / Cursor — needs [Node.js](https://nodejs.org) 22+): +**One-command installer** (alternative — Code / Cursor, needs [Node.js](https://nodejs.org) 22+): ```bash npx -y -p @leadbay/mcp@latest installer From 1f3383d6fe9c5960447c8651e8a98de13497485e Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Mon, 22 Jun 2026 11:58:06 -0700 Subject: [PATCH 08/14] docs(mcp): .dxt double-click install, add Codex to installer, trim quickstart links - .dxt: download from releases/latest, then double-click to install (in-app Settings path kept as a fallback hint). - One-command installer now lists Codex alongside Claude Code / Cursor. - Quickstart 'Where to next' drops the What-is link (it's the first page). EN + FR. Co-Authored-By: Claude --- fr/leadbay-mcp/installation.md | 24 +++++++++--------------- fr/leadbay-mcp/quickstart.md | 10 +++------- leadbay-mcp/installation.md | 24 +++++++++--------------- leadbay-mcp/quickstart.md | 10 +++------- 4 files changed, 24 insertions(+), 44 deletions(-) diff --git a/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md index 818cac0..2708734 100644 --- a/fr/leadbay-mcp/installation.md +++ b/fr/leadbay-mcp/installation.md @@ -20,27 +20,21 @@ Le serveur MCP utilise **votre** compte Leadbay, donc toute action prise par Cla ## Installer l'extension `.dxt` (recommandé) -La configuration la plus simple : téléchargez un seul fichier d'extension et installez-le. +La configuration la plus simple : téléchargez un seul fichier d'extension et double-cliquez dessus. ### É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 `.dxt` (cherchez un nom du type `leadbay-X.Y.Z.dxt` dans la section **Assets** de la release la plus récente). - -Sauvegardez-le dans un endroit facile à retrouver — votre dossier Téléchargements fonctionne. +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 — Installer l'extension - -Dans Claude, allez dans : - -**Settings → Extensions → Advanced → Install extension** +### Étape 2 — Double-cliquer pour installer -Sélectionnez le fichier `leadbay-X.Y.Z.dxt` que vous avez téléchargé à l'étape 1. +**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. -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**. +{% 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 %} --- @@ -78,13 +72,13 @@ Pour configurer : dans l'écran **Configure** de l'extension Leadbay, réglez ** ## Alternative — installateur en une commande -Vous préférez automatiser la configuration, ou vous utilisez **Claude Code** ou **Cursor** ? Une seule commande installe Leadbay et vous connecte. Il vous faut [Node.js](https://nodejs.org) 22 ou plus récent. +Vous préférez automatiser la configuration, ou vous utilisez **Claude Code**, **Cursor** ou **Codex** ? Une seule commande installe Leadbay et vous connecte. 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), ajoute Leadbay à ceux que vous choisissez, et lance le flux **Se connecter avec Leadbay**. +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 : diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md index ae1d44a..f5c7d1f 100644 --- a/fr/leadbay-mcp/quickstart.md +++ b/fr/leadbay-mcp/quickstart.md @@ -15,11 +15,11 @@ La voie recommandée est l'**extension `.dxt`** — téléchargez un fichier et | Votre client | Voie recommandée | |---|---| | **Claude Desktop** ou **Claude Cowork** | **Extension `.dxt`** — téléchargez depuis les releases et installez | -| **Claude Code** ou **Cursor** | **Installateur en une commande** — `npx -y -p @leadbay/mcp@latest installer` | +| **Claude Code**, **Cursor** ou **Codex** | **Installateur en une commande** — `npx -y -p @leadbay/mcp@latest installer` | -**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/), puis dans Claude ouvrez **Settings → Extensions → Advanced → Install extension** et sélectionnez le fichier. +**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. -**Installateur en une commande** (alternative — Code / Cursor, nécessite [Node.js](https://nodejs.org) 22+) : +**Installateur en une commande** (alternative — Code / Cursor / Codex, nécessite [Node.js](https://nodejs.org) 22+) : ```bash npx -y -p @leadbay/mcp@latest installer @@ -82,10 +82,6 @@ Claude se souvient des leads qu'il a fait remonter, vous pouvez donc continuer ## Et ensuite -{% content-ref url="what-is-leadbay-mcp.md" %} -[Qu'est-ce que Leadbay MCP ?](what-is-leadbay-mcp.md) -{% endcontent-ref %} - {% content-ref url="example-prompts.md" %} [Exemples de prompts](example-prompts.md) {% endcontent-ref %} diff --git a/leadbay-mcp/installation.md b/leadbay-mcp/installation.md index 942cd99..890976e 100644 --- a/leadbay-mcp/installation.md +++ b/leadbay-mcp/installation.md @@ -20,27 +20,21 @@ The MCP server uses **your** Leadbay account, so any action Claude takes is the ## Install the `.dxt` extension (recommended) -The simplest setup: download a single extension file and install it. +The simplest setup: download a single extension file and double-click it. ### Step 1 — Download the latest extension -Open the [LeadClaw releases page](https://github.com/leadbay/leadclaw/releases/) and grab the latest `.dxt` file (look for a name like `leadbay-X.Y.Z.dxt` under the most recent release's **Assets**). - -Save it somewhere easy to find — your Downloads folder works. +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 — Install the extension - -In Claude, go to: - -**Settings → Extensions → Advanced → Install extension** +### Step 2 — Double-click to install -Pick the `leadbay-X.Y.Z.dxt` file you downloaded in Step 1. +**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. -A dialog opens with the extension details. Click **Install**, then confirm with **Install** again. - -Once installed, toggle the extension to **Enabled**. +{% 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 %} --- @@ -78,13 +72,13 @@ To configure: in the Leadbay extension's **Configure** screen, set **Always allo ## Alternative — one-command installer -Prefer to automate the 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. +Prefer to automate the setup, or using **Claude Code**, **Cursor**, or **Codex**? 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. +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: diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md index 5267329..3ae53a1 100644 --- a/leadbay-mcp/quickstart.md +++ b/leadbay-mcp/quickstart.md @@ -15,11 +15,11 @@ The recommended path is the **`.dxt` extension** — download one file and insta | Your client | Recommended path | |---|---| | **Claude Desktop** or **Claude Cowork** | **`.dxt` extension** — download from releases and install | -| **Claude Code** or **Cursor** | **One-command installer** — `npx -y -p @leadbay/mcp@latest installer` | +| **Claude Code**, **Cursor**, or **Codex** | **One-command installer** — `npx -y -p @leadbay/mcp@latest installer` | -**`.dxt` extension** (recommended): download the latest `leadbay-X.Y.Z.dxt` from the [LeadClaw releases page](https://github.com/leadbay/leadclaw/releases/), then in Claude open **Settings → Extensions → Advanced → Install extension** and pick the file. +**`.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. -**One-command installer** (alternative — Code / Cursor, needs [Node.js](https://nodejs.org) 22+): +**One-command installer** (alternative — Code / Cursor / Codex, needs [Node.js](https://nodejs.org) 22+): ```bash npx -y -p @leadbay/mcp@latest installer @@ -82,10 +82,6 @@ Claude remembers the leads it surfaced, so you can keep referring to "the top on ## Where to next -{% content-ref url="what-is-leadbay-mcp.md" %} -[What is Leadbay MCP?](what-is-leadbay-mcp.md) -{% endcontent-ref %} - {% content-ref url="example-prompts.md" %} [Example prompts](example-prompts.md) {% endcontent-ref %} From cb79f449c95ed4d155231fdae8a1a9d35e3b982d Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Mon, 22 Jun 2026 12:04:51 -0700 Subject: [PATCH 09/14] docs(mcp): drop env-var/advanced-tools detail from Tools reference intro Users don't care about LEADBAY_MCP_WRITE / LEADBAY_MCP_ADVANCED. Collapse the two-group framing to one line; remove the advanced-tools hint (EN + FR). Co-Authored-By: Claude --- fr/leadbay-mcp/tools-reference.md | 9 +-------- leadbay-mcp/tools-reference.md | 9 +-------- 2 files changed, 2 insertions(+), 16 deletions(-) diff --git a/fr/leadbay-mcp/tools-reference.md b/fr/leadbay-mcp/tools-reference.md index 9be55ac..df0900a 100644 --- a/fr/leadbay-mcp/tools-reference.md +++ b/fr/leadbay-mcp/tools-reference.md @@ -2,14 +2,7 @@ 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. Toujours disponibles. -- **Écriture / activation** — effectuent une action sur votre compte. Activés par défaut ; un administrateur peut les désactiver avec `LEADBAY_MCP_WRITE=0`. - -{% hint style="info" %} -Cette page couvre les outils qu'un utilisateur normal voit. Il existe aussi un jeu d'outils **avancés**, de bas niveau (un appel API chacun), pour les intégrations et les utilisateurs experts, masqués derrière `LEADBAY_MCP_ADVANCED=1`. La plupart des gens n'en ont jamais besoin. La source de vérité à jour pour chaque outil est le [README LeadClaw](https://github.com/leadbay/leadclaw#tools). -{% endhint %} +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). --- diff --git a/leadbay-mcp/tools-reference.md b/leadbay-mcp/tools-reference.md index fab5783..c9ead6e 100644 --- a/leadbay-mcp/tools-reference.md +++ b/leadbay-mcp/tools-reference.md @@ -2,14 +2,7 @@ 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. Always available. -- **Write / activate** — take action on your account. On by default; an admin can disable them with `LEADBAY_MCP_WRITE=0`. - -{% hint style="info" %} -This page covers the tools a normal user sees. There's also an **advanced** set of low-level, single-API-call tools for integrations and power users, hidden behind `LEADBAY_MCP_ADVANCED=1`. Most people never need them. The current source of truth for every tool is the [LeadClaw README](https://github.com/leadbay/leadclaw#tools). -{% endhint %} +Tools come in two groups: **read-only** (pull data, never change anything) and **write / activate** (take action on your account). --- From e644c6f81f77adc8f4fc425e4168885865c6c8f5 Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Mon, 22 Jun 2026 12:07:50 -0700 Subject: [PATCH 10/14] docs(mcp): post-install, redirect to Quickstart instead of listing prompts Replace the 'Try it' prompt list (and the tool-name sentence) on the Installation page with a short 'You're connected' note that links to the Quickstart for the first prompt and expected result (EN + FR). Co-Authored-By: Claude --- fr/leadbay-mcp/installation.md | 18 +++++------------- leadbay-mcp/installation.md | 18 +++++------------- 2 files changed, 10 insertions(+), 26 deletions(-) diff --git a/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md index 2708734..edd4fc2 100644 --- a/fr/leadbay-mcp/installation.md +++ b/fr/leadbay-mcp/installation.md @@ -88,21 +88,13 @@ npx -y -p @leadbay/mcp@latest installer --uninstall --- -## Essayez +## Vous êtes connecté -Ouvrez une conversation et demandez : +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. -> *Récupère les meilleurs leads du jour et dis-moi lesquels valent la peine d'être ouverts ce matin.* - -Claude appellera `leadbay_pull_leads`, `leadbay_get_lead_profile`, et consorts — et répondra avec une liste courte et qualifiée. - -Quelques autres prompts qui fonctionnent d'emblée : - -- *Recherche acme.com — est-ce un bon fit pour nous ?* -- *Affine mon audience pour cibler les entreprises de l'UE 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 les workflows recommandés se trouvent dans le [README LeadClaw](https://github.com/leadbay/leadclaw#tools). +{% content-ref url="quickstart.md" %} +[Démarrage rapide](quickstart.md) +{% endcontent-ref %} --- diff --git a/leadbay-mcp/installation.md b/leadbay-mcp/installation.md index 890976e..135822f 100644 --- a/leadbay-mcp/installation.md +++ b/leadbay-mcp/installation.md @@ -88,21 +88,13 @@ npx -y -p @leadbay/mcp@latest installer --uninstall --- -## Try it +## You're connected -Open a conversation and ask: +That's it — Leadbay is set up. Head to the Quickstart for your first prompt and what a successful result looks like. -> *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). +{% content-ref url="quickstart.md" %} +[Quickstart](quickstart.md) +{% endcontent-ref %} --- From 37e262b1fd8945abd965f99a18b185eb82fd8282 Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Tue, 23 Jun 2026 10:45:25 -0700 Subject: [PATCH 11/14] =?UTF-8?q?docs(mcp):=20installer=20works=20for=20al?= =?UTF-8?q?l=20clients=20=E2=80=94=20drop=20per-client=20split?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The one-command installer also covers Claude / Claude Cowork, so the '.dxt for Claude, installer for Code/Cursor/Codex' framing was artificial. Present both methods as working for every client; drop the per-client table in Quickstart (EN + FR). Co-Authored-By: Claude --- fr/leadbay-mcp/installation.md | 2 +- fr/leadbay-mcp/quickstart.md | 9 ++------- leadbay-mcp/installation.md | 2 +- leadbay-mcp/quickstart.md | 9 ++------- 4 files changed, 6 insertions(+), 16 deletions(-) diff --git a/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md index edd4fc2..7b62b04 100644 --- a/fr/leadbay-mcp/installation.md +++ b/fr/leadbay-mcp/installation.md @@ -72,7 +72,7 @@ Pour configurer : dans l'écran **Configure** de l'extension Leadbay, réglez ** ## Alternative — installateur en une commande -Vous préférez automatiser la configuration, ou vous utilisez **Claude Code**, **Cursor** ou **Codex** ? Une seule commande installe Leadbay et vous connecte. Il vous faut [Node.js](https://nodejs.org) 22 ou plus récent. +Vous préférez automatiser la configuration ? Une seule commande installe Leadbay et vous connecte — elle fonctionne pour tous les clients supportés (Claude, Claude Code, Cursor, Codex). Il vous faut [Node.js](https://nodejs.org) 22 ou plus récent. ```bash npx -y -p @leadbay/mcp@latest installer diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md index f5c7d1f..43f6868 100644 --- a/fr/leadbay-mcp/quickstart.md +++ b/fr/leadbay-mcp/quickstart.md @@ -10,16 +10,11 @@ Il vous faut un [compte Leadbay](https://leadbay.ai/) et un assistant IA qui sup ## Étape 1 — Installer -La voie recommandée est l'**extension `.dxt`** — téléchargez un fichier et installez-le. (Les détails complets et les autres options sont dans le guide d'[Installation](installation.md).) - -| Votre client | Voie recommandée | -|---|---| -| **Claude Desktop** ou **Claude Cowork** | **Extension `.dxt`** — téléchargez depuis les releases et installez | -| **Claude Code**, **Cursor** ou **Codex** | **Installateur en une commande** — `npx -y -p @leadbay/mcp@latest installer` | +Deux façons de se connecter — les deux fonctionnent pour tous les clients supportés (Claude, Claude Code, Cursor, Codex). Les détails complets sont dans le guide d'[Installation](installation.md). **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. -**Installateur en une commande** (alternative — Code / Cursor / Codex, nécessite [Node.js](https://nodejs.org) 22+) : +**Installateur en une commande** (alternative, nécessite [Node.js](https://nodejs.org) 22+) : ```bash npx -y -p @leadbay/mcp@latest installer diff --git a/leadbay-mcp/installation.md b/leadbay-mcp/installation.md index 135822f..ad06473 100644 --- a/leadbay-mcp/installation.md +++ b/leadbay-mcp/installation.md @@ -72,7 +72,7 @@ To configure: in the Leadbay extension's **Configure** screen, set **Always allo ## Alternative — one-command installer -Prefer to automate the setup, or using **Claude Code**, **Cursor**, or **Codex**? One command installs Leadbay and signs you in. You'll need [Node.js](https://nodejs.org) 22 or newer. +Prefer to automate the setup? One command installs Leadbay and signs you in — it works for every supported client (Claude, Claude Code, Cursor, Codex). You'll need [Node.js](https://nodejs.org) 22 or newer. ```bash npx -y -p @leadbay/mcp@latest installer diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md index 3ae53a1..14eca9d 100644 --- a/leadbay-mcp/quickstart.md +++ b/leadbay-mcp/quickstart.md @@ -10,16 +10,11 @@ You'll need a [Leadbay account](https://leadbay.ai/) and an AI assistant that su ## Step 1 — Install -The recommended path is the **`.dxt` extension** — download one file and install it. (Full details and the other options are in the [Installation](installation.md) guide.) - -| Your client | Recommended path | -|---|---| -| **Claude Desktop** or **Claude Cowork** | **`.dxt` extension** — download from releases and install | -| **Claude Code**, **Cursor**, or **Codex** | **One-command installer** — `npx -y -p @leadbay/mcp@latest installer` | +Two ways to connect — both work for every supported client (Claude, Claude Code, Cursor, Codex). Full details are in the [Installation](installation.md) guide. **`.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. -**One-command installer** (alternative — Code / Cursor / Codex, needs [Node.js](https://nodejs.org) 22+): +**One-command installer** (alternative, needs [Node.js](https://nodejs.org) 22+): ```bash npx -y -p @leadbay/mcp@latest installer From b4c89745b95b853e6207eec2e39fed33db24d29f Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Tue, 23 Jun 2026 10:59:37 -0700 Subject: [PATCH 12/14] =?UTF-8?q?docs(mcp):=20fix=20review=20regressions?= =?UTF-8?q?=20=E2=80=94=20.dxt=20scope=20+=20legacy=20URL=20redirect?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit P2: scope the .dxt extension to Claude (Desktop/Cowork) and route Claude Code / Cursor / Codex to the one-command installer (which also covers Claude Desktop). Non-Claude users no longer get pointed at the Claude-only .dxt flow. EN + FR, Installation + Quickstart. P1: add .gitbook.yaml redirects so the moved product-guides/leadbay-mcp URL (and the FR path) forward to the new section instead of 404-ing for existing links and bookmarks. Co-Authored-By: Claude --- .gitbook.yaml | 5 +++++ fr/leadbay-mcp/installation.md | 15 +++++++++------ fr/leadbay-mcp/quickstart.md | 6 +++--- leadbay-mcp/installation.md | 15 +++++++++------ leadbay-mcp/quickstart.md | 6 +++--- 5 files changed, 29 insertions(+), 18 deletions(-) create mode 100644 .gitbook.yaml 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/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md index 7b62b04..a9a6f2d 100644 --- a/fr/leadbay-mcp/installation.md +++ b/fr/leadbay-mcp/installation.md @@ -1,6 +1,9 @@ # Installation -Connecter Leadbay à Claude prend environ une minute. La méthode recommandée est l'**extension `.dxt`** — téléchargez un fichier et installez-le. Si vous préférez automatiser la configuration, l'**installateur en une commande** est une alternative. +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). @@ -13,14 +16,14 @@ Le serveur MCP utilise **votre** compte Leadbay, donc toute action prise par Cla ## 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 ou Codex +- Un assistant IA qui supporte MCP — Claude, Claude Code, Cursor ou Codex - Une minute --- -## Installer l'extension `.dxt` (recommandé) +## Sur Claude — extension `.dxt` (recommandé) -La configuration la plus simple : téléchargez un seul fichier d'extension et double-cliquez dessus. +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 @@ -70,9 +73,9 @@ Pour configurer : dans l'écran **Configure** de l'extension Leadbay, réglez ** --- -## Alternative — installateur en une commande +## Installateur en une commande (Claude Code, Cursor, Codex) -Vous préférez automatiser la configuration ? Une seule commande installe Leadbay et vous connecte — elle fonctionne pour tous les clients supportés (Claude, Claude Code, Cursor, Codex). Il vous faut [Node.js](https://nodejs.org) 22 ou plus récent. +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 diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md index 43f6868..b0b0145 100644 --- a/fr/leadbay-mcp/quickstart.md +++ b/fr/leadbay-mcp/quickstart.md @@ -10,11 +10,11 @@ Il vous faut un [compte Leadbay](https://leadbay.ai/) et un assistant IA qui sup ## Étape 1 — Installer -Deux façons de se connecter — les deux fonctionnent pour tous les clients supportés (Claude, Claude Code, Cursor, Codex). Les détails complets sont dans le guide d'[Installation](installation.md). +Choisissez la voie qui correspond à votre client. Les détails complets sont dans le guide d'[Installation](installation.md). -**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 (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. -**Installateur en une commande** (alternative, nécessite [Node.js](https://nodejs.org) 22+) : +**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 diff --git a/leadbay-mcp/installation.md b/leadbay-mcp/installation.md index ad06473..c20e278 100644 --- a/leadbay-mcp/installation.md +++ b/leadbay-mcp/installation.md @@ -1,6 +1,9 @@ # Installation -Connecting Leadbay to Claude takes about a minute. The recommended way is the **`.dxt` extension** — download one file and install it. If you'd rather automate the setup, the **one-command installer** is an alternative. +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). @@ -13,14 +16,14 @@ The MCP server uses **your** Leadbay account, so any action Claude takes is the ## 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, or Codex +- An AI assistant that supports MCP — Claude, Claude Code, Cursor, or Codex - One minute --- -## Install the `.dxt` extension (recommended) +## On Claude — `.dxt` extension (recommended) -The simplest setup: download a single extension file and double-click it. +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 @@ -70,9 +73,9 @@ To configure: in the Leadbay extension's **Configure** screen, set **Always allo --- -## Alternative — one-command installer +## One-command installer (Claude Code, Cursor, Codex) -Prefer to automate the setup? One command installs Leadbay and signs you in — it works for every supported client (Claude, Claude Code, Cursor, Codex). You'll need [Node.js](https://nodejs.org) 22 or newer. +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 diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md index 14eca9d..1b05588 100644 --- a/leadbay-mcp/quickstart.md +++ b/leadbay-mcp/quickstart.md @@ -10,11 +10,11 @@ You'll need a [Leadbay account](https://leadbay.ai/) and an AI assistant that su ## Step 1 — Install -Two ways to connect — both work for every supported client (Claude, Claude Code, Cursor, Codex). Full details are in the [Installation](installation.md) guide. +Pick the path for your client. Full details are in the [Installation](installation.md) guide. -**`.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 (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. -**One-command installer** (alternative, needs [Node.js](https://nodejs.org) 22+): +**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 From c37070b70ba303b6a0c30cd2449dfec0aec41f1e Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Tue, 23 Jun 2026 11:04:08 -0700 Subject: [PATCH 13/14] =?UTF-8?q?docs(mcp):=20ChatGPT=20not=20supported=20?= =?UTF-8?q?yet=20=E2=80=94=20mark=20coming=20soon=20in=20Quickstart?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ChatGPT was listed as a supported client but has no install path in the new section (the hosted-connector flow was removed). Drop it from the supported list and add a 'coming soon' note instead (EN + FR). Co-Authored-By: Claude --- fr/leadbay-mcp/quickstart.md | 2 +- leadbay-mcp/quickstart.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md index b0b0145..07b5114 100644 --- a/fr/leadbay-mcp/quickstart.md +++ b/fr/leadbay-mcp/quickstart.md @@ -3,7 +3,7 @@ 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 Code, Claude Cowork, Cursor ou ChatGPT). C'est tout — aucun jeton d'API à copier ou coller. +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 %} --- diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md index 1b05588..9d1c776 100644 --- a/leadbay-mcp/quickstart.md +++ b/leadbay-mcp/quickstart.md @@ -3,7 +3,7 @@ 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 Code, Claude Cowork, Cursor, or ChatGPT). That's it — no API tokens to copy or paste. +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 %} --- From 45a1b91c9732a7412b5c89457e85cde18fbd73c3 Mon Sep 17 00:00:00 2001 From: ArtyETH06 <107058122+ArtyETH06@users.noreply.github.com> Date: Tue, 23 Jun 2026 11:11:23 -0700 Subject: [PATCH 14/14] docs(mcp): drop per-write confirmation promise, align client list P2: the recommended setup is Always-allow, so 'Claude confirms before anything that writes' was misleading. Reframe read-vs-write around account scoping + the client's tool-permission settings; same fix in the example-prompts intro and the outreach-logging note (EN + FR). P3: 'Where it works' now lists all five clients (Claude Desktop, Cowork, Code, Cursor, Codex) to match Quickstart/Installation (EN + FR). Co-Authored-By: Claude --- fr/leadbay-mcp/example-prompts.md | 4 ++-- fr/leadbay-mcp/what-is-leadbay-mcp.md | 6 ++++-- leadbay-mcp/example-prompts.md | 4 ++-- leadbay-mcp/what-is-leadbay-mcp.md | 6 ++++-- 4 files changed, 12 insertions(+), 8 deletions(-) diff --git a/fr/leadbay-mcp/example-prompts.md b/fr/leadbay-mcp/example-prompts.md index 1cbd5f7..4157358 100644 --- a/fr/leadbay-mcp/example-prompts.md +++ b/fr/leadbay-mcp/example-prompts.md @@ -3,7 +3,7 @@ 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 et vous demande de confirmer tout ce qui modifie votre compte. +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 %} --- @@ -74,7 +74,7 @@ Ces prompts s'affichent sur une carte là où votre client le permet, avec le me > *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, donc Claude confirme d'abord. +La rédaction est en lecture seule. La journalisation écrit l'activité sur votre compte. --- diff --git a/fr/leadbay-mcp/what-is-leadbay-mcp.md b/fr/leadbay-mcp/what-is-leadbay-mcp.md index 3cb6691..9660bdb 100644 --- a/fr/leadbay-mcp/what-is-leadbay-mcp.md +++ b/fr/leadbay-mcp/what-is-leadbay-mcp.md @@ -28,8 +28,10 @@ Claude lit vos leads, vos lenses et votre profil de goût, raisonne dessus, et r Leadbay MCP fonctionne avec tout assistant IA qui supporte le Model Context Protocol : -- **Claude** +- **Claude Desktop** +- **Claude Cowork** - **Claude Code** +- **Cursor** - **Codex** --- @@ -44,7 +46,7 @@ Quelques termes Leadbay reviennent dans les prompts et les réponses. Vous n'ave | **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, et Claude confirme avant toute action qui écrit. | +| **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). diff --git a/leadbay-mcp/example-prompts.md b/leadbay-mcp/example-prompts.md index 66000f2..f70c62e 100644 --- a/leadbay-mcp/example-prompts.md +++ b/leadbay-mcp/example-prompts.md @@ -3,7 +3,7 @@ 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 and asks you to confirm anything that changes your account. +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 %} --- @@ -74,7 +74,7 @@ These render on a map where your client supports it, with the best contact and a > *I called Acme this morning and left a voicemail — record that.* -Drafting is read-only. Logging writes the activity to your account, so Claude confirms first. +Drafting is read-only. Logging writes the activity to your account. --- diff --git a/leadbay-mcp/what-is-leadbay-mcp.md b/leadbay-mcp/what-is-leadbay-mcp.md index 443ef42..6d87c1e 100644 --- a/leadbay-mcp/what-is-leadbay-mcp.md +++ b/leadbay-mcp/what-is-leadbay-mcp.md @@ -28,8 +28,10 @@ Claude reads your leads, lenses, and taste profile, reasons over them, and repli Leadbay MCP works with any AI assistant that supports the Model Context Protocol: -- **Claude** +- **Claude Desktop** +- **Claude Cowork** - **Claude Code** +- **Cursor** - **Codex** --- @@ -44,7 +46,7 @@ A few Leadbay terms show up in prompts and responses. You don't need to manage a | **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, and Claude confirms before anything that writes. | +| **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.