Merge pull request #17 from leadbay/ArtyETH06/web-connector-prefilled-link

docs(mcp): terse install docs, one-click connector, region endpoints, FR parity

Author: ArtyETH06

fr/SUMMARY.md

@@ -21,6 +21,8 @@
 
 * [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)
+* [Configuration admin](leadbay-mcp/admin-setup.md)
 * [Référence des outils](leadbay-mcp/tools-reference.md)
 * [Exemples de prompts](leadbay-mcp/example-prompts.md)
 

fr/leadbay-mcp/admin-setup.md

@@ -0,0 +1,59 @@
+# Configuration admin
+
+**Pour les admins d'espace de travail et d'organisation.** Cette page vous guide pour ajouter le connecteur Leadbay une seule fois, pour toute votre organisation, afin que chaque membre puisse se connecter sans avoir besoin de droits admin lui-même.
+
+Si vous êtes arrivé ici parce qu'un collègue vous a demandé d'« ajouter le connecteur Leadbay » — vous êtes au bon endroit. Ça prend deux minutes, il n'y a aucun jeton d'API à distribuer, et chaque membre se connecte toujours avec **son propre** compte Leadbay.
+
+> **Êtes-vous sûr d'en avoir besoin ?** Seuls les plans **organisation** verrouillent les connecteurs personnalisés derrière un admin — **Claude** Team/Enterprise et **ChatGPT** Business/Enterprise. Sur un plan payant individuel (Claude Pro/Max, ChatGPT Plus/Pro), il n'y a pas d'étape admin ; ajoutez le connecteur vous-même via le guide [Démarrage rapide](quickstart.md) ou [Installation](installation.md).
+
+---
+
+## Claude (Team & Enterprise)
+
+En tant que **propriétaire principal ou admin**, ajoutez Leadbay comme connecteur personnalisé d'**organisation**. Une fois ajouté, il apparaît dans le répertoire de chaque membre et ils se connectent individuellement.
+
+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. (URL France : `https://mcp.leadbay.app/fr/mcp` ; sur l'instance US, utilisez `https://mcp.leadbay.app/mcp`.)
+2. Si Claude propose un choix de portée, choisissez **organisation** pour que chaque membre en bénéficie. Laissez les paramètres avancés tels quels (**Individual sign-in** — chaque membre utilise son propre identifiant Leadbay ; vous ne partagez pas un seul compte), puis cliquez sur **Add**.
+
+C'est fait côté admin — Leadbay apparaît maintenant dans le répertoire de connecteurs de vos membres. (Dans un espace Team/Enterprise, les membres n'ont pas l'option **Add custom connector** eux-mêmes, c'est pourquoi cette étape existe.)
+
+**Ce que font vos membres ensuite :** dans Claude, **Settings → Connectors → cherchez « Leadbay » → Connect**, puis connexion avec leur propre compte Leadbay. Guide complet dans le [Démarrage rapide](quickstart.md).
+
+---
+
+## ChatGPT (Business & Enterprise)
+
+Sur les espaces Business et Enterprise, les connecteurs MCP personnalisés sont désactivés jusqu'à ce qu'un **propriétaire ou admin d'espace de travail** les autorise. Vous n'ajoutez pas Leadbay pour tout le monde ici — vous débloquez la possibilité, et chaque membre l'ajoute ensuite lui-même.
+
+1. Ouvrez les **paramètres de votre espace de travail** (menu d'espace, en bas à gauche → **Settings**).
+2. Sous les contrôles de connecteurs / apps, **autorisez les connecteurs personnalisés** pour l'espace de travail (c'est l'interrupteur au niveau de l'espace qui débloque les apps personnalisées en Developer mode pour les membres).
+3. Prévenez vos membres qu'ils peuvent désormais ajouter Leadbay.
+
+### Ce que font vos membres ensuite
+
+Contrairement à Claude, les membres ChatGPT ajoutent l'application eux-mêmes une fois que vous avez autorisé les connecteurs personnalisés. Envoyez-leur la section **ChatGPT** du guide [Installation](installation.md) — chaque membre :
+
+1. Active le **Developer mode** (Settings → Apps → Advanced settings).
+2. Clique sur **Create app** et remplit **Name** `Leadbay MCP`, **Server URL** `https://mcp.leadbay.app/fr/mcp`, et **Authentication : OAuth**.
+3. Clique sur **Sign in with Leadbay MCP** et se connecte avec son propre compte Leadbay.
+4. Active l'application **Leadbay MCP** depuis le menu **+** / outils du composeur, puis demande des leads.
+
+{% hint style="info" %}
+La formulation et l'emplacement exacts du contrôle « autoriser les connecteurs personnalisés » évoluent avec la console admin de ChatGPT. Si vous ne le trouvez pas, cherchez **connectors** ou **apps** dans les paramètres de l'espace, ou consultez la documentation admin actuelle d'OpenAI.
+{% endhint %}
+
+{% hint style="info" %}
+**Claude Code et Codex ne nécessitent aucune étape admin** — ce sont des clients CLI par utilisateur, sans verrou d'organisation. Chaque membre lance simplement la commande d'ajout en une ligne du guide [Installation](installation.md) sur sa propre machine.
+{% endhint %}
+
+---
+
+## Et ensuite
+
+{% content-ref url="installation.md" %}
+[Installation](installation.md)
+{% endcontent-ref %}
+
+{% content-ref url="quickstart.md" %}
+[Démarrage rapide](quickstart.md)
+{% endcontent-ref %}

fr/leadbay-mcp/installation.md

@@ -0,0 +1,131 @@
+# Installation
+
+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é.
+
+Partout où une URL de serveur est demandée, utilisez celle de votre région :
+
+| Région | URL du serveur |
+|---|---|
+| 🇫🇷 France / UE | `https://mcp.leadbay.app/fr/mcp` |
+| 🇺🇸 US | `https://mcp.leadbay.app/mcp` |
+
+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`.
+
+Il vous faut un [compte Leadbay](https://leadbay.ai/) (le même identifiant que l'application web) et l'un des assistants ci-dessous.
+
+---
+
+## Claude.ai (web)
+
+Ajoutez Leadbay comme **connecteur personnalisé**.
+
+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**.
+2. Ouvrez le connecteur **Leadbay** dans le répertoire (cherchez « Leadbay » sous **Custom connectors**), cliquez sur **Connect** et connectez-vous.
+
+Les outils Leadbay deviennent disponibles dans vos chats. Vous pouvez les cadrer par projet dans Claude Projects.
+
+> **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).
+
+---
+
+## Claude Desktop
+
+Même **connecteur personnalisé** que Claude.ai, même URL.
+
+1. **Settings → Connectors → + → Add custom connector**
+2. **Name :** `Leadbay` · **URL :** `https://mcp.leadbay.app/fr/mcp` → cliquez sur **Add**
+3. Ouvrez le connecteur **Leadbay**, cliquez sur **Connect**, connectez-vous.
+
+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.
+
+### Solution de repli : installer l'extension
+
+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.
+
+1. **[⬇ Télécharger l'extension Leadbay (.dxt)](https://github.com/leadbay/mcp/releases/latest/download/leadbay-latest.dxt)**
+2. Double-cliquez dessus → **Install** → basculez sur **Enabled**.
+3. Ouvrez un nouveau chat, cliquez sur **Connect** sur l'extension, connectez-vous.
+
+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.
+
+---
+
+## Claude Code
+
+Une seule commande enregistre Leadbay pour tous vos projets :
+
+```bash
+claude mcp add --scope user --transport http leadbay https://mcp.leadbay.app/fr/mcp
+```
+
+1. Lancez `/mcp` dans Claude Code.
+2. Sélectionnez **leadbay → Authenticate** — votre navigateur s'ouvre pour la connexion.
+3. Connectez-vous et approuvez. Le statut passe à **connected** et les outils se chargent.
+
+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`.
+
+---
+
+## Codex
+
+Codex a une commande intégrée pour les serveurs MCP distants :
+
+```bash
+codex mcp add leadbay --url https://mcp.leadbay.app/fr/mcp
+```
+
+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`.
+
+---
+
+## ChatGPT
+
+Ajoutez Leadbay comme application personnalisée (connecteur MCP).
+
+1. **Settings → Apps → Advanced settings → activez Developer mode** (depuis le menu d'espace de travail en bas à gauche).
+2. De retour sur **Apps**, cliquez sur **Create app**.
+3. **Name :** `Leadbay MCP` · **Connection :** Server URL `https://mcp.leadbay.app/fr/mcp` · **Authentication :** OAuth. Cochez **I understand and want to continue** → **Create**.
+4. Cliquez sur **Sign in with Leadbay MCP**, connectez-vous et approuvez.
+
+Dans un chat, activez l'application **Leadbay MCP** depuis le menu **+** / outils du composeur pour que ChatGPT puisse appeler ses outils.
+
+> 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.
+
+---
+
+## Après la connexion — vos premiers leads
+
+Quel que soit le client utilisé, ouvrez une nouvelle conversation et essayez :
+
+> _Montre-moi les leads du jour et dis-moi lesquels valent la peine d'être ouverts en premier._
+
+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é. 🎉
+
+{% content-ref url="example-prompts.md" %}
+[Exemples de prompts](example-prompts.md)
+{% endcontent-ref %}
+
+---
+
+## Dépannage
+
+| Symptôme | Solution |
+|---------|-----|
+| 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**. |
+| 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. |
+| 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. |
+| 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). |
+| 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). |
+| Autre problème | Signalez un bug sur [github.com/leadbay/mcp/issues](https://github.com/leadbay/mcp/issues). |
+
+---
+
+## 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="tools-reference.md" %}
+[Référence des outils](tools-reference.md)
+{% endcontent-ref %}