diff --git a/.gitbook/assets/mcp-teaser-leads.png b/.gitbook/assets/mcp-teaser-leads.png new file mode 100644 index 0000000..b9ab3a5 Binary files /dev/null and b/.gitbook/assets/mcp-teaser-leads.png differ diff --git a/.gitbook/assets/mcp-teaser-outreach.png b/.gitbook/assets/mcp-teaser-outreach.png new file mode 100644 index 0000000..fb4bfdf Binary files /dev/null and b/.gitbook/assets/mcp-teaser-outreach.png differ diff --git a/SUMMARY.md b/SUMMARY.md index 1e24ae0..f64ebe8 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -21,7 +21,6 @@ * [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 dc55b8e..8fea19d 100644 --- a/fr/SUMMARY.md +++ b/fr/SUMMARY.md @@ -21,7 +21,6 @@ * [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/example-prompts.md b/fr/leadbay-mcp/example-prompts.md index 4157358..0e186df 100644 --- a/fr/leadbay-mcp/example-prompts.md +++ b/fr/leadbay-mcp/example-prompts.md @@ -164,6 +164,6 @@ Nouveau ici ? Commencez par l'aperçu, puis connectez-vous. [Qu'est-ce que Leadbay MCP ?](what-is-leadbay-mcp.md) {% endcontent-ref %} -{% content-ref url="installation.md" %} -[Installation](installation.md) +{% content-ref url="quickstart.md" %} +[Démarrage rapide](quickstart.md) {% endcontent-ref %} diff --git a/fr/leadbay-mcp/installation.md b/fr/leadbay-mcp/installation.md deleted file mode 100644 index a9a6f2d..0000000 --- a/fr/leadbay-mcp/installation.md +++ /dev/null @@ -1,131 +0,0 @@ -# Installation - -Connecter Leadbay prend environ une minute. Choisissez la voie qui correspond à votre client : - -- **Sur Claude (Desktop / Cowork) :** l'**extension `.dxt`** — téléchargez un fichier et double-cliquez pour l'installer. Recommandé. -- **Sur Claude Code, Cursor ou Codex :** l'**installateur en une commande**. Il fonctionne aussi pour Claude Desktop. - -La configuration avancée et les autres clients sont couverts dans le [README Leadbay MCP](https://github.com/leadbay/leadclaw#install). - -{% hint style="info" %} -Le serveur MCP utilise **votre** compte Leadbay, donc toute action prise par Claude est équivalente à ce que vous auriez fait vous-même dans l'application. -{% endhint %} - ---- - -## Ce dont vous avez besoin - -- Un compte Leadbay ([inscrivez-vous ici](https://leadbay.ai/) si vous n'en avez pas) -- Un assistant IA qui supporte MCP — Claude, Claude Code, Cursor ou Codex -- Une minute - ---- - -## Sur Claude — extension `.dxt` (recommandé) - -Pour **Claude Desktop et Claude Cowork**, la configuration la plus simple est de télécharger un seul fichier d'extension et de double-cliquer dessus. (Vous utilisez Claude Code, Cursor ou Codex ? Passez à l'[installateur en une commande](#installateur-en-une-commande-claude-code-cursor-codex) ci-dessous.) - -### Étape 1 — Télécharger la dernière extension - -Ouvrez la [page des releases LeadClaw](https://github.com/leadbay/leadclaw/releases/latest) et téléchargez le dernier fichier `.dxt` (cherchez un nom du type `leadbay-X.Y.Z.dxt` dans la section **Assets** de la release). - ---- - -### Étape 2 — Double-cliquer pour installer - -**Double-cliquez sur le fichier `.dxt` téléchargé.** Claude s'ouvre avec les détails de l'extension — cliquez sur **Install** pour confirmer, puis basculez l'extension sur **Enabled**. C'est tout. - -{% hint style="info" %} -Vous préférez installer depuis l'application ? Allez dans **Settings → Extensions → Advanced → Install extension** et sélectionnez le fichier `.dxt` au lieu de double-cliquer. -{% endhint %} - ---- - -### Étape 3 — Se connecter avec Leadbay - -La première fois que Claude appelle un outil Leadbay, il déclenche un flux **Se connecter avec Leadbay** en un clic : - -1. Une page de connexion Leadbay s'ouvre dans votre navigateur -2. Connectez-vous (ou confirmez votre session existante) -3. Cliquez sur **Approuver** pour accorder à Claude l'accès à votre compte -4. L'onglet du navigateur se ferme tout seul et Claude poursuit la conversation - -C'est tout — aucun jeton à générer, copier, coller ou renouveler. La connexion est limitée à votre compte et vous pouvez la révoquer à tout moment depuis **Paramètres → Applications connectées** dans Leadbay. - -{% hint style="info" %} -Si vous avez accès aux instances US et UE de Leadbay, connectez-vous sur l'instance que vous voulez que Claude utilise. Vous pouvez changer plus tard en vous déconnectant de l'extension Leadbay et en vous reconnectant sur l'autre instance. -{% endhint %} - ---- - -### Étape 4 — Autoriser les outils - -Leadbay propose deux familles d'outils : - -| Famille | Ce qu'elle contient | Permission recommandée | -|--------|--------------|------------------------| -| **Lecture seule** | Récupère leads, lenses, profils, contacts, profil de goût, quota d'enrichissement — ne modifie jamais rien | **Toujours autoriser** | -| **Écriture / suppression** | Qualifie des leads, enrichit des contacts, ajoute des notes, importe des leads, journalise la prospection, affine l'audience | **Toujours autoriser** | - -Les deux familles peuvent être autorisées en permanence sans risque, car le Leadbay MCP est **limité à votre compte** — il n'y a rien de destructeur au niveau de la plateforme. Régler les deux sur « toujours autoriser » permet à Claude de travailler en continu sans vous interrompre à chaque appel. - -Pour configurer : dans l'écran **Configure** de l'extension Leadbay, réglez **Always allow** pour le groupe d'outils en lecture seule et pour le groupe en écriture/suppression. - ---- - -## Installateur en une commande (Claude Code, Cursor, Codex) - -Pour **Claude Code, Cursor ou Codex**, une seule commande installe Leadbay et vous connecte. Elle fonctionne aussi pour **Claude Desktop** si vous préférez automatiser la configuration plutôt qu'installer le `.dxt` à la main. Il vous faut [Node.js](https://nodejs.org) 22 ou plus récent. - -```bash -npx -y -p @leadbay/mcp@latest installer -``` - -Cela ouvre un assistant guidé qui détecte vos clients installés (Claude Desktop, Claude Code, Cursor, Codex), ajoute Leadbay à ceux que vous choisissez, et lance le flux **Se connecter avec Leadbay**. - -Pour retirer Leadbay plus tard de tous les clients configurés par l'installateur : - -```bash -npx -y -p @leadbay/mcp@latest installer --uninstall -``` - ---- - -## Vous êtes connecté - -C'est tout — Leadbay est configuré. Rendez-vous sur le Démarrage rapide pour votre premier prompt et voir à quoi ressemble un résultat réussi. - -{% content-ref url="quickstart.md" %} -[Démarrage rapide](quickstart.md) -{% endcontent-ref %} - ---- - -## Utiliser Leadbay avec Claude Desktop - -Claude Desktop charge les outils MCP plus lentement que Cowork, donc quelques précautions supplémentaires aident. - -Après avoir installé l'extension Leadbay, **quittez complètement et relancez Claude Desktop** (Cmd-Q sur Mac, puis rouvrez — pas seulement fermer la fenêtre). Ouvrez un nouveau chat et attendez environ **30 secondes** avant d'envoyer votre premier message. Cela laisse à Claude le temps de charger les outils Leadbay. - -Si votre premier message reçoit une réponse du type *« Je ne vois aucun outil Leadbay »* ou *« Je ne trouve pas Leadbay dans votre configuration »*, pas d'inquiétude — les outils sont encore en train de se charger. Envoyez n'importe quel deuxième message (même juste *« réessaie »*) et Claude les détectera. À partir de là, le reste de votre session fonctionne normalement. - ---- - -## Mise à jour - -Pour l'**extension `.dxt`**, quand une nouvelle release sort, répétez l'**Étape 1** (télécharger le nouveau `.dxt`) et l'**Étape 2** (Install extension). Claude remplace l'ancienne version sur place ; votre connexion reste valide, vous n'avez donc pas à vous ré-authentifier. - -L'**installateur en une commande** exécute toujours la dernière version — il n'y a rien à mettre à jour. - ---- - -## Dépannage - -| Symptôme | Solution | -|---------|-----| -| Claude dit « non authentifié » ou erreurs 401 | Votre connexion a peut-être expiré ou été révoquée. Déclenchez n'importe quel outil Leadbay à nouveau et Claude relancera le flux **Se connecter avec Leadbay** | -| Les outils n'apparaissent pas après l'installation | Vérifiez que l'extension est bien sur **Enabled** dans Settings → Extensions | -| Les outils apparaissent mais Claude ne les appelle pas | Ouvrez **Configure** et basculez les groupes d'outils sur **Always allow** | -| Connecté, mais « montre-moi les leads » renvoie une liste vide | Vous êtes bien connecté — il n'y a simplement rien à afficher pour l'instant. Demandez *« montre-moi mes lenses »* pour confirmer quelle audience est active et basculer si besoin, ou vérifiez que vous êtes sur la bonne instance (US vs UE) | -| Mauvaise instance (aucun lead / erreurs 404) | Déconnectez-vous de l'extension Leadbay et reconnectez-vous sur la bonne instance (US ou UE) | -| Autre problème | Signalez un bug sur [github.com/leadbay/leadclaw/issues](https://github.com/leadbay/leadclaw/issues) | diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md index 07b5114..43532f5 100644 --- a/fr/leadbay-mcp/quickstart.md +++ b/fr/leadbay-mcp/quickstart.md @@ -1,6 +1,6 @@ # 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). +Connectez Leadbay à Claude et obtenez vos premiers leads qualifiés en environ cinq minutes. Choisissez votre client, installez, connectez-vous, et demandez — sans coder, sans jeton à copier. {% hint style="info" %} Il vous faut un [compte Leadbay](https://leadbay.ai/) et un assistant IA qui supporte MCP (Claude Desktop, Claude Cowork, Claude Code ou Cursor — Codex aussi). C'est tout — aucun jeton d'API à copier ou coller. _Le support de ChatGPT arrive bientôt._ @@ -10,16 +10,23 @@ 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 sont dans le guide d'[Installation](installation.md). +**Sur Claude (Desktop / Cowork) — extension `.dxt`** (recommandé) : -**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. +1. **[⬇ Télécharger l'extension Leadbay (.dxt)](https://github.com/leadbay/leadclaw/releases/latest/download/leadbay-latest.dxt)** — ceci télécharge directement la dernière version. +2. **Double-cliquez sur le `.dxt` téléchargé.** Claude s'ouvre avec les détails de l'extension — cliquez sur **Install**, puis basculez l'extension sur **Enabled**. -**Sur Claude Code, Cursor ou Codex — installateur en une commande** (nécessite [Node.js](https://nodejs.org) 22+). Il fonctionne aussi pour Claude Desktop : +{% hint style="info" %} +Claude ne s'ouvre pas ? Installez-la depuis l'application : **Settings → Extensions → Advanced → Install extension**, puis sélectionnez le fichier `.dxt`. +{% endhint %} + +**Sur Claude Code, Cursor ou Codex — installateur en une commande** (nécessite [Node.js](https://nodejs.org) 22+). Il fonctionne aussi pour Claude Desktop si vous préférez automatiser la configuration : ```bash npx -y -p @leadbay/mcp@latest installer ``` +Cela ouvre un assistant guidé qui détecte vos clients installés, ajoute Leadbay à ceux que vous choisissez, et lance le flux de connexion. + --- ## Étape 2 — Se connecter (cela se fait automatiquement) @@ -31,7 +38,7 @@ Vous ne configurez rien à la main. Dès que vous installez — ou la première 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**. +C'est toute la connexion. Aucun jeton, aucun fichier de config. Claude est désormais relié à **votre** compte, avec tous les leads 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. @@ -75,6 +82,37 @@ Claude se souvient des leads qu'il a fait remonter, vous pouvez donc continuer --- +## Utiliser Leadbay avec Claude Desktop + +Claude Desktop charge les outils MCP plus lentement que Cowork, donc quelques précautions supplémentaires aident. + +Après avoir installé l'extension Leadbay, **quittez complètement et relancez Claude Desktop** (Cmd-Q sur Mac, puis rouvrez — pas seulement fermer la fenêtre). Ouvrez un nouveau chat et attendez environ **30 secondes** avant d'envoyer votre premier message. Cela laisse à Claude le temps de charger les outils Leadbay. + +Si votre premier message reçoit une réponse du type *« Je ne vois aucun outil Leadbay »* ou *« Je ne trouve pas Leadbay dans votre configuration »*, pas d'inquiétude — les outils sont encore en train de se charger. Envoyez n'importe quel deuxième message (même juste *« réessaie »*) et Claude les détectera. À partir de là, le reste de votre session fonctionne normalement. + +--- + +## Mise à jour + +Pour l'**extension `.dxt`**, quand une nouvelle release sort, répétez l'**Étape 1** (téléchargez le nouveau `.dxt`, double-cliquez, Install). Claude remplace l'ancienne version sur place ; votre connexion reste valide, vous n'avez donc pas à vous ré-authentifier. + +L'**installateur en une commande** exécute toujours la dernière version — il n'y a rien à mettre à jour. + +--- + +## Dépannage + +| Symptôme | Solution | +|---------|-----| +| Claude dit « non authentifié » ou erreurs 401 | Votre connexion a peut-être expiré ou été révoquée. Déclenchez n'importe quel outil Leadbay à nouveau et Claude relancera le flux **Se connecter avec Leadbay** | +| Les outils n'apparaissent pas après l'installation | Vérifiez que l'extension est bien sur **Enabled** dans Settings → Extensions | +| Les outils apparaissent mais Claude ne les appelle pas | Ouvrez **Configure** et basculez les groupes d'outils sur **Always allow** | +| Connecté, mais « montre-moi les leads » renvoie une liste vide | Vous êtes bien connecté — il n'y a simplement rien à afficher pour l'instant. Demandez *« montre-moi mes lenses »* pour confirmer quelle audience est active et basculer si besoin, ou vérifiez que vous êtes sur la bonne instance (US vs UE) | +| Mauvaise instance (aucun lead / erreurs 404) | Déconnectez-vous de l'extension Leadbay et reconnectez-vous sur la bonne instance (US ou UE) | +| Autre problème | Signalez un bug sur [github.com/leadbay/leadclaw/issues](https://github.com/leadbay/leadclaw/issues) | + +--- + ## Et ensuite {% content-ref url="example-prompts.md" %} diff --git a/fr/leadbay-mcp/what-is-leadbay-mcp.md b/fr/leadbay-mcp/what-is-leadbay-mcp.md index 9660bdb..828ba61 100644 --- a/fr/leadbay-mcp/what-is-leadbay-mcp.md +++ b/fr/leadbay-mcp/what-is-leadbay-mcp.md @@ -20,7 +20,7 @@ Au lieu de basculer entre l'application Leadbay et votre flux de travail, vous t > *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. +Claude fait remonter les bonnes entreprises, raisonne dessus, et répond avec une analyse courte et qualifiée — puis effectue l'action que vous demandez. --- @@ -36,30 +36,27 @@ Leadbay MCP fonctionne avec tout assistant IA qui supporte le Model Context Prot --- -## Concepts clés +## En action -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 : +Demandez en langage naturel — Claude répond avec une liste classée de leads qualifiés : -| Terme | Ce que ça veut dire | -|------|---------------| -| **Lens** | Votre audience enregistrée — le secteur, la taille d'entreprise et les critères qui définissent quels leads Leadbay fait remonter. Vous pouvez en avoir plusieurs et basculer entre elles (« bascule sur ma lens Joinery »). | -| **Score** | Un score de fit firmographique de 0 à 100 sur chaque lead — à quel point il correspond à votre audience. Affiché sous forme de barre dans les tableaux de leads. | -| **Score IA** | Un score de qualification plus poussé sur les meilleurs leads de chaque lot, issu d'une recherche web ciblée par rapport à vos questions de qualification. La plupart des leads ont le score de base ; les meilleurs sont qualifiés par l'IA. | -| **Profil de goût** | Ce que Leadbay apprend de vos likes, dislikes et actions de prospection — il ajuste le scoring futur à votre jugement. Aimer un lead dans le chat l'entraîne. | -| **Lecture vs écriture** | Les outils en **lecture** récupèrent seulement des données (leads, profils, contacts) et ne changent jamais rien. Les outils en **écriture** effectuent une action (qualifier, enrichir, journaliser la prospection, modifier des lenses). Les deux sont limités à votre compte — chaque écriture est une action que vous pourriez faire vous-même dans l'application, sans rien de destructeur au niveau de la plateforme. Vous contrôlez ce que votre client demande avant chaque action via ses réglages d'autorisation des outils. | +
Claude renvoie un tableau de leads qualifiés classés dans le chat
« Montre-moi les leads du jour » — une liste classée avec score de fit et le meilleur contact.
+ +…puis rédige la prospection pour vous : + +
Claude rédige un email de prospection personnalisé
« Rédige un email d'intro » — des variantes prêtes à envoyer en quelques secondes.
+ + -Ces notions sont détaillées dans les guides produit [Lenses](../product-guides/lenses.md) et [AI Assistant](../product-guides/ai-assistant.md). --- -## Étape suivante +## Pour commencer -Prêt à connecter ? Le Démarrage rapide vous amène à vos premiers leads en environ cinq minutes. +Connectez Leadbay à Claude et obtenez vos premiers leads en environ cinq minutes — sans coder, sans jeton à copier. {% content-ref url="quickstart.md" %} [Démarrage rapide](quickstart.md) {% endcontent-ref %} - -{% content-ref url="installation.md" %} -[Installation](installation.md) -{% endcontent-ref %} diff --git a/fr/news/changelog.md b/fr/news/changelog.md index 48c7721..0887c6c 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](../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. +- **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/quickstart.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/quickstart.md) pour les étapes mises à jour. ## Avril 2026 diff --git a/leadbay-mcp/example-prompts.md b/leadbay-mcp/example-prompts.md index f70c62e..cabe9f8 100644 --- a/leadbay-mcp/example-prompts.md +++ b/leadbay-mcp/example-prompts.md @@ -164,6 +164,6 @@ New here? Start with the overview, then connect. [What is Leadbay MCP?](what-is-leadbay-mcp.md) {% endcontent-ref %} -{% content-ref url="installation.md" %} -[Installation](installation.md) +{% content-ref url="quickstart.md" %} +[Quickstart](quickstart.md) {% endcontent-ref %} diff --git a/leadbay-mcp/installation.md b/leadbay-mcp/installation.md deleted file mode 100644 index c20e278..0000000 --- a/leadbay-mcp/installation.md +++ /dev/null @@ -1,131 +0,0 @@ -# Installation - -Connecting Leadbay takes about a minute. Pick the path that matches your client: - -- **On Claude (Desktop / Cowork):** the **`.dxt` extension** — download one file and double-click to install. Recommended. -- **On Claude Code, Cursor, or Codex:** the **one-command installer**. It also works for Claude Desktop. - -Advanced setup and other clients are covered in the [Leadbay MCP README](https://github.com/leadbay/leadclaw#install). - -{% hint style="info" %} -The MCP server uses **your** Leadbay account, so any action Claude takes is the same as if you'd done it yourself in the app. -{% endhint %} - ---- - -## What you'll need - -- A Leadbay account ([sign up here](https://leadbay.ai/) if you don't have one) -- An AI assistant that supports MCP — Claude, Claude Code, Cursor, or Codex -- One minute - ---- - -## On Claude — `.dxt` extension (recommended) - -For **Claude Desktop and Claude Cowork**, the simplest setup is to download a single extension file and double-click it. (Using Claude Code, Cursor, or Codex instead? Skip to the [one-command installer](#one-command-installer-claude-code-cursor-codex) below.) - -### Step 1 — Download the latest extension - -Open the [LeadClaw releases page](https://github.com/leadbay/leadclaw/releases/latest) and download the latest `.dxt` file (look for a name like `leadbay-X.Y.Z.dxt` under the release's **Assets**). - ---- - -### Step 2 — Double-click to install - -**Double-click the downloaded `.dxt` file.** Claude opens with the extension details — click **Install** to confirm, then toggle the extension to **Enabled**. That's it. - -{% hint style="info" %} -Prefer to install from inside the app? Go to **Settings → Extensions → Advanced → Install extension** and pick the `.dxt` file instead of double-clicking. -{% endhint %} - ---- - -### Step 3 — Sign in with Leadbay - -The first time Claude calls a Leadbay tool, it triggers a one-tap **Sign in with Leadbay** flow: - -1. A Leadbay login page opens in your browser -2. Log in (or confirm your existing session) -3. Click **Approve** to grant Claude access to your account -4. The browser tab closes itself and Claude continues the conversation - -That's it — no tokens to mint, copy, paste, or rotate. The connection is scoped to your account and you can revoke it anytime from **Settings → Connected apps** in Leadbay. - -{% hint style="info" %} -If you have access to both the US and EU instances of Leadbay, sign in on the instance you want Claude to use. You can switch later by signing out from the Leadbay extension and signing back in on the other instance. -{% endhint %} - ---- - -### Step 4 — Allow the tools - -Leadbay ships two flavors of tools: - -| Flavor | What's in it | Recommended permission | -|--------|--------------|------------------------| -| **Read-only** | Pulls leads, lenses, profiles, contacts, taste profile, enrichment quota — never changes anything | **Always allow** | -| **Write / delete** | Qualifies leads, enriches contacts, adds notes, imports leads, reports outreach, refines audience | **Always allow** | - -Both flavors are safe to always-allow because the Leadbay MCP is **scoped to your account** — there's nothing destructive at the platform level. Setting both to "always allow" makes Claude flow without interrupting you for permission on every call. - -To configure: in the Leadbay extension's **Configure** screen, set **Always allow** for both the read-only tool group and the write/delete tool group. - ---- - -## One-command installer (Claude Code, Cursor, Codex) - -For **Claude Code, Cursor, or Codex**, one command installs Leadbay and signs you in. It also works for **Claude Desktop** if you'd rather automate the setup than install the `.dxt` by hand. You'll need [Node.js](https://nodejs.org) 22 or newer. - -```bash -npx -y -p @leadbay/mcp@latest installer -``` - -This opens a guided wizard that detects your installed clients (Claude Desktop, Claude Code, Cursor, Codex), adds Leadbay to the ones you pick, and runs the **Sign in with Leadbay** flow. - -To remove Leadbay later from every client the installer set up: - -```bash -npx -y -p @leadbay/mcp@latest installer --uninstall -``` - ---- - -## You're connected - -That's it — Leadbay is set up. Head to the Quickstart for your first prompt and what a successful result looks like. - -{% content-ref url="quickstart.md" %} -[Quickstart](quickstart.md) -{% endcontent-ref %} - ---- - -## Using Leadbay with Claude Desktop - -Claude Desktop is slower than Cowork to load MCP tools, so a couple of extra precautions help. - -After installing the Leadbay extension, **fully quit and relaunch Claude Desktop** (Cmd-Q on Mac, then reopen — not just closing the window). Open a new chat and wait about **30 seconds** before sending your first message. This gives Claude time to load the Leadbay tools. - -If your first message gets a response like *"I don't see any Leadbay tools"* or *"I can't find Leadbay in your setup"*, don't worry — the tools are still loading. Send any second message (even just *"try again"*) and Claude will pick them up. From that point on, the rest of your session works normally. - ---- - -## Updating - -For the **`.dxt` extension**, when a new release ships, repeat **Step 1** (download the new `.dxt`) and **Step 2** (Install extension). Claude replaces the old version in place; your sign-in stays valid, so you don't need to re-authenticate. - -The **one-command installer** always runs the latest version — there's nothing to update. - ---- - -## Troubleshooting - -| Symptom | Fix | -|---------|-----| -| Claude says "not authenticated" or 401 errors | Your sign-in may have expired or been revoked. Trigger any Leadbay tool again and Claude will re-prompt the **Sign in with Leadbay** flow | -| Tools don't appear after install | Make sure the extension toggle is **Enabled** in Settings → Extensions | -| Tools appear but Claude won't call them | Open **Configure** and switch the tool groups to **Always allow** | -| Connected, but "show me leads" returns an empty list | You're signed in fine — there's just nothing to show right now. Ask *"show me my lenses"* to confirm which audience is active and switch if needed, or check you're on the right instance (US vs EU) | -| Wrong instance (no leads / 404s) | Sign out from the Leadbay extension and sign back in on the right instance (US or EU) | -| Other issue | File a bug at [github.com/leadbay/leadclaw/issues](https://github.com/leadbay/leadclaw/issues) | diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md index 9d1c776..314df89 100644 --- a/leadbay-mcp/quickstart.md +++ b/leadbay-mcp/quickstart.md @@ -1,6 +1,6 @@ # 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. +Connect Leadbay to Claude and get your first qualified leads in about five minutes. Pick your client, install, sign in, and ask — no coding, no tokens to copy. {% hint style="info" %} You'll need a [Leadbay account](https://leadbay.ai/) and an AI assistant that supports MCP (Claude Desktop, Claude Cowork, Claude Code, or Cursor — Codex too). That's it — no API tokens to copy or paste. _ChatGPT support is coming soon._ @@ -10,16 +10,23 @@ You'll need a [Leadbay account](https://leadbay.ai/) and an AI assistant that su ## Step 1 — Install -Pick the path for your client. Full details are in the [Installation](installation.md) guide. +**On Claude (Desktop / Cowork) — `.dxt` extension** (recommended): -**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. +1. **[⬇ Download the Leadbay extension (.dxt)](https://github.com/leadbay/leadclaw/releases/latest/download/leadbay-latest.dxt)** — this downloads the latest version directly. +2. **Double-click the downloaded `.dxt`.** Claude opens with the extension details — click **Install**, then toggle the extension to **Enabled**. -**On Claude Code, Cursor, or Codex — one-command installer** (needs [Node.js](https://nodejs.org) 22+). It also works for Claude Desktop: +{% hint style="info" %} +Doesn't open Claude? Install it from inside the app: **Settings → Extensions → Advanced → Install extension**, then pick the `.dxt` file. +{% endhint %} + +**On Claude Code, Cursor, or Codex — one-command installer** (needs [Node.js](https://nodejs.org) 22+). It also works for Claude Desktop if you'd rather automate the setup: ```bash npx -y -p @leadbay/mcp@latest installer ``` +This opens a guided wizard that detects your installed clients, adds Leadbay to the ones you pick, and runs the sign-in flow. + --- ## Step 2 — Sign in (this happens automatically) @@ -31,7 +38,7 @@ You don't set anything up by hand. The moment you install — or the first time 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**. +That's the whole connection. No tokens, no config files. Claude is now linked to **your** account, with all the leads 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. @@ -75,6 +82,37 @@ Claude remembers the leads it surfaced, so you can keep referring to "the top on --- +## Using Leadbay with Claude Desktop + +Claude Desktop is slower than Cowork to load MCP tools, so a couple of extra precautions help. + +After installing the Leadbay extension, **fully quit and relaunch Claude Desktop** (Cmd-Q on Mac, then reopen — not just closing the window). Open a new chat and wait about **30 seconds** before sending your first message. This gives Claude time to load the Leadbay tools. + +If your first message gets a response like *"I don't see any Leadbay tools"* or *"I can't find Leadbay in your setup"*, don't worry — the tools are still loading. Send any second message (even just *"try again"*) and Claude will pick them up. From that point on, the rest of your session works normally. + +--- + +## Updating + +For the **`.dxt` extension**, when a new release ships, repeat **Step 1** (download the new `.dxt`, double-click, Install). Claude replaces the old version in place; your sign-in stays valid, so you don't need to re-authenticate. + +The **one-command installer** always runs the latest version — there's nothing to update. + +--- + +## Troubleshooting + +| Symptom | Fix | +|---------|-----| +| Claude says "not authenticated" or 401 errors | Your sign-in may have expired or been revoked. Trigger any Leadbay tool again and Claude will re-prompt the **Sign in with Leadbay** flow | +| Tools don't appear after install | Make sure the extension toggle is **Enabled** in Settings → Extensions | +| Tools appear but Claude won't call them | Open **Configure** and switch the tool groups to **Always allow** | +| Connected, but "show me leads" returns an empty list | You're signed in fine — there's just nothing to show right now. Ask *"show me my lenses"* to confirm which audience is active and switch if needed, or check you're on the right instance (US vs EU) | +| Wrong instance (no leads / 404s) | Sign out from the Leadbay extension and sign back in on the right instance (US or EU) | +| Other issue | File a bug at [github.com/leadbay/leadclaw/issues](https://github.com/leadbay/leadclaw/issues) | + +--- + ## Where to next {% content-ref url="example-prompts.md" %} diff --git a/leadbay-mcp/what-is-leadbay-mcp.md b/leadbay-mcp/what-is-leadbay-mcp.md index 6d87c1e..ce009f6 100644 --- a/leadbay-mcp/what-is-leadbay-mcp.md +++ b/leadbay-mcp/what-is-leadbay-mcp.md @@ -20,7 +20,7 @@ Instead of switching between the Leadbay app and your workflow, you work convers > *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. +Claude pulls the right companies, reasons over them, and replies with a short, qualified answer — then takes the follow-up action you ask for. --- @@ -36,30 +36,27 @@ Leadbay MCP works with any AI assistant that supports the Model Context Protocol --- -## Key concepts +## See it in action -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: +Ask in plain language — Claude replies with a ranked shortlist of qualified leads: -| Term | What it means | -|------|---------------| -| **Lens** | Your saved audience — the sector, company size, and criteria that define which leads Leadbay surfaces. You can have several and switch between them ("switch to my Joinery lens"). | -| **Score** | A 0–100 firmographic fit score on every lead — how well it matches your audience. Shown as a bar in lead tables. | -| **AI score** | A deeper qualification score on the top leads in each batch, from targeted web research against your qualification questions. Most leads ship with the basic score; the best get AI-qualified. | -| **Taste profile** | What Leadbay learns from your likes, dislikes, and outreach — it tunes future scoring to your judgement. Liking a lead in chat teaches it. | -| **Read vs write** | **Read** tools only pull data (leads, profiles, contacts) and never change anything. **Write** tools take action (qualify, enrich, log outreach, edit lenses). Both are scoped to your account — every write is something you could do yourself in the app, with nothing destructive at the platform level. You control how much your client asks before each action through its tool-permission settings. | +
Claude returning a ranked table of qualified leads in chat
"Show me today's leads" — a ranked shortlist with fit score and the best contact.
+ +…then drafts the outreach for you: + +
Claude drafting a personalized outreach email
"Draft an intro email" — ready-to-send variants in seconds.
+ + -These are covered in depth in the [Lenses](../product-guides/lenses.md) and [AI Assistant](../product-guides/ai-assistant.md) product guides. --- -## Next step +## Get started -Ready to connect? The Quickstart gets you to your first leads in about five minutes. +Connect Leadbay to Claude and get to your first leads in about five minutes — no coding, no tokens to copy. {% content-ref url="quickstart.md" %} [Quickstart](quickstart.md) {% endcontent-ref %} - -{% content-ref url="installation.md" %} -[Installation](installation.md) -{% endcontent-ref %} diff --git a/news/changelog.md b/news/changelog.md index 17c0fb3..6505ddc 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](../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. +- **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/quickstart.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/quickstart.md) for the refreshed steps. ## April 2026