|
| 1 | +# Installation |
| 2 | + |
| 3 | +Choisissez votre client ci-dessous. Chacun prend deux minutes et **aucun ne nécessite de jeton d'API** — vous ajoutez une URL de serveur, vous vous connectez une fois avec votre compte Leadbay dans le navigateur, et c'est relié. |
| 4 | + |
| 5 | +Partout où une URL de serveur est demandée, utilisez celle de votre région : |
| 6 | + |
| 7 | +| Région | URL du serveur | |
| 8 | +|---|---| |
| 9 | +| 🇫🇷 France / UE | `https://mcp.leadbay.app/fr/mcp` | |
| 10 | +| 🇺🇸 US | `https://mcp.leadbay.app/mcp` | |
| 11 | + |
| 12 | +Utilisez l'URL correspondant à l'instance Leadbay sur laquelle se trouve votre compte. Les étapes ci-dessous montrent l'URL France — sur l'instance US, remplacez simplement par `/mcp`. |
| 13 | + |
| 14 | +Il vous faut un [compte Leadbay](https://leadbay.ai/) (le même identifiant que l'application web) et l'un des assistants ci-dessous. |
| 15 | + |
| 16 | +--- |
| 17 | + |
| 18 | +## Claude.ai (web) |
| 19 | + |
| 20 | +Ajoutez Leadbay comme **connecteur personnalisé**. |
| 21 | + |
| 22 | +1. **[Ajouter le connecteur Leadbay →](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Leadbay&connectorUrl=https%3A%2F%2Fmcp.leadbay.app%2Ffr%2Fmcp)** — le formulaire s'ouvre avec le nom et l'URL pré-remplis. Laissez les paramètres avancés tels quels, puis cliquez sur **Add**. |
| 23 | +2. Ouvrez le connecteur **Leadbay** dans le répertoire (cherchez « Leadbay » sous **Custom connectors**), cliquez sur **Connect** et connectez-vous. |
| 24 | + |
| 25 | +Les outils Leadbay deviennent disponibles dans vos chats. Vous pouvez les cadrer par projet dans Claude Projects. |
| 26 | + |
| 27 | +> **Pas admin de l'organisation ?** Les membres ne peuvent pas ajouter un connecteur personnalisé — votre admin l'ajoute une fois (étape 1), puis vous faites **Connect** (étape 2). Voir [Configuration admin](admin-setup.md). Les connecteurs personnalisés nécessitent un plan Claude payant (Pro, Max, Team ou Enterprise). |
| 28 | +
|
| 29 | +--- |
| 30 | + |
| 31 | +## Claude Desktop |
| 32 | + |
| 33 | +Même **connecteur personnalisé** que Claude.ai, même URL. |
| 34 | + |
| 35 | +1. **Settings → Connectors → + → Add custom connector** |
| 36 | +2. **Name :** `Leadbay` · **URL :** `https://mcp.leadbay.app/fr/mcp` → cliquez sur **Add** |
| 37 | +3. Ouvrez le connecteur **Leadbay**, cliquez sur **Connect**, connectez-vous. |
| 38 | + |
| 39 | +Si votre premier message reçoit _« Je ne vois aucun outil Leadbay »_, les outils sont encore en train de se charger — envoyez n'importe quel deuxième message et Claude les détectera. Pas admin de l'organisation ? L'admin ajoute le connecteur d'abord (voir [Configuration admin](admin-setup.md)), ou utilisez la solution de repli par extension ci-dessous. |
| 40 | + |
| 41 | +### Solution de repli : installer l'extension |
| 42 | + |
| 43 | +Pas d'option **Add custom connector**, ou pas admin de l'organisation ? Contournez le connecteur et installez Leadbay comme **extension `.dxt`** — une installation par utilisateur en double-clic, sans droits admin. |
| 44 | + |
| 45 | +1. **[⬇ Télécharger l'extension Leadbay (.dxt)](https://github.com/leadbay/mcp/releases/latest/download/leadbay-latest.dxt)** |
| 46 | +2. Double-cliquez dessus → **Install** → basculez sur **Enabled**. |
| 47 | +3. Ouvrez un nouveau chat, cliquez sur **Connect** sur l'extension, connectez-vous. |
| 48 | + |
| 49 | +Le double-clic n'ouvre pas Claude ? Installez depuis l'application : **Settings → Extensions → Advanced → Install extension**, puis sélectionnez le `.dxt` téléchargé. À chaque nouvelle release, téléchargez et réinstallez — Claude remplace l'ancienne version sur place et votre connexion reste valide. |
| 50 | + |
| 51 | +--- |
| 52 | + |
| 53 | +## Claude Code |
| 54 | + |
| 55 | +Une seule commande enregistre Leadbay pour tous vos projets : |
| 56 | + |
| 57 | +```bash |
| 58 | +claude mcp add --scope user --transport http leadbay https://mcp.leadbay.app/fr/mcp |
| 59 | +``` |
| 60 | + |
| 61 | +1. Lancez `/mcp` dans Claude Code. |
| 62 | +2. Sélectionnez **leadbay → Authenticate** — votre navigateur s'ouvre pour la connexion. |
| 63 | +3. Connectez-vous et approuvez. Le statut passe à **connected** et les outils se chargent. |
| 64 | + |
| 65 | +Vous avez lancé `add` dans une session ouverte ? Redémarrez-la une fois pour que le serveur apparaisse dans `/mcp`. Supprimez-le à tout moment avec `claude mcp remove leadbay -s user`. |
| 66 | + |
| 67 | +--- |
| 68 | + |
| 69 | +## Codex |
| 70 | + |
| 71 | +Codex a une commande intégrée pour les serveurs MCP distants : |
| 72 | + |
| 73 | +```bash |
| 74 | +codex mcp add leadbay --url https://mcp.leadbay.app/fr/mcp |
| 75 | +``` |
| 76 | + |
| 77 | +Codex détecte OAuth automatiquement et ouvre votre navigateur pour le flux **Se connecter avec Leadbay** — connectez-vous et approuvez. Vérifiez avec `codex mcp list` (vous devriez voir `leadbay` avec **Status: enabled**, **Auth: OAuth**). Supprimez-le avec `codex mcp remove leadbay`. |
| 78 | + |
| 79 | +--- |
| 80 | + |
| 81 | +## ChatGPT |
| 82 | + |
| 83 | +Ajoutez Leadbay comme application personnalisée (connecteur MCP). |
| 84 | + |
| 85 | +1. **Settings → Apps → Advanced settings → activez Developer mode** (depuis le menu d'espace de travail en bas à gauche). |
| 86 | +2. De retour sur **Apps**, cliquez sur **Create app**. |
| 87 | +3. **Name :** `Leadbay MCP` · **Connection :** Server URL `https://mcp.leadbay.app/fr/mcp` · **Authentication :** OAuth. Cochez **I understand and want to continue** → **Create**. |
| 88 | +4. Cliquez sur **Sign in with Leadbay MCP**, connectez-vous et approuvez. |
| 89 | + |
| 90 | +Dans un chat, activez l'application **Leadbay MCP** depuis le menu **+** / outils du composeur pour que ChatGPT puisse appeler ses outils. |
| 91 | + |
| 92 | +> Les connecteurs MCP personnalisés nécessitent un plan ChatGPT payant (Plus, Pro, Business ou Enterprise). Sur Business/Enterprise, un admin peut devoir autoriser les connecteurs personnalisés d'abord. Si l'application se déconnecte, reconnectez-la : **Settings → Apps → Leadbay MCP → ⋯ → Reconnect**, puis reconnectez-vous. |
| 93 | +
|
| 94 | +--- |
| 95 | + |
| 96 | +## Après la connexion — vos premiers leads |
| 97 | + |
| 98 | +Quel que soit le client utilisé, ouvrez une nouvelle conversation et essayez : |
| 99 | + |
| 100 | +> _Montre-moi les leads du jour et dis-moi lesquels valent la peine d'être ouverts en premier._ |
| 101 | +
|
| 102 | +Une réponse réussie est une **liste classée** — chaque lead avec un score de fit, une raison en une ligne « pourquoi ça correspond », et le meilleur contact. Si vous voyez ça, vous êtes complètement connecté. 🎉 |
| 103 | + |
| 104 | +{% content-ref url="example-prompts.md" %} |
| 105 | +[Exemples de prompts](example-prompts.md) |
| 106 | +{% endcontent-ref %} |
| 107 | + |
| 108 | +--- |
| 109 | + |
| 110 | +## Dépannage |
| 111 | + |
| 112 | +| Symptôme | Solution | |
| 113 | +|---------|-----| |
| 114 | +| Erreurs « Non authentifié » / 401 | Votre connexion a expiré ou a été révoquée. Déclenchez n'importe quel outil Leadbay à nouveau et approuvez l'invite **Se connecter avec Leadbay**. | |
| 115 | +| 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 vérifier quelle audience est active. | |
| 116 | +| Les outils n'apparaissent pas après la connexion | Ouvrez un nouveau chat et attendez quelques secondes ; envoyez un deuxième message et les outils finissent de se charger. | |
| 117 | +| Les outils apparaissent mais l'assistant ne les appelle pas | Ouvrez les paramètres du connecteur et réglez les groupes d'outils Leadbay sur **Always allow** (Claude) ou activez le connecteur dans le composeur (ChatGPT). | |
| 118 | +| Option de connecteur personnalisé absente (Claude.ai / Claude Desktop / ChatGPT) | Les connecteurs personnalisés nécessitent un plan payant, et votre admin d'organisation peut devoir les activer — voir [Configuration admin](admin-setup.md). Sur **Claude Desktop**, vous pouvez contourner le connecteur avec la [solution de repli par extension `.dxt`](#solution-de-repli-installer-lextension). | |
| 119 | +| Autre problème | Signalez un bug sur [github.com/leadbay/mcp/issues](https://github.com/leadbay/mcp/issues). | |
| 120 | + |
| 121 | +--- |
| 122 | + |
| 123 | +## Et ensuite |
| 124 | + |
| 125 | +{% content-ref url="what-is-leadbay-mcp.md" %} |
| 126 | +[Qu'est-ce que Leadbay MCP ?](what-is-leadbay-mcp.md) |
| 127 | +{% endcontent-ref %} |
| 128 | + |
| 129 | +{% content-ref url="tools-reference.md" %} |
| 130 | +[Référence des outils](tools-reference.md) |
| 131 | +{% endcontent-ref %} |
0 commit comments