Installation dans Claude
Le serveur s'ajoute comme connecteur personnalisé. Il vous faut un compte Claude et un compte LyBox.
-
Ouvrir les connecteurs
Dans Claude, ouvrez Paramètres puis Connecteurs.
-
Ajouter un connecteur personnalisé
Cliquez sur + Ajouter puis Ajouter un connecteur personnalisé et renseignez :
- Nom : LyBox
- URL : https://api.lybox.fr/mcp
Cliquez sur Continuer.
-
Laisser l'authentification par défaut
Claude détecte automatiquement la configuration du serveur. Conservez les options marquées Détecté :
- Authentification : Se connecter maintenant
- Client OAuth : S'enregistrer automatiquement
- En-têtes de requête : aucun
Validez pour ajouter le connecteur.
-
Se connecter à LyBox
Sur la fiche du connecteur LyBox, cliquez sur Connecter, puis identifiez-vous avec votre compte LyBox et autorisez l'accès.
-
Choisir les autorisations des outils
Une fois connecté, la fiche affiche les outils disponibles. Les outils en lecture seule peuvent être réglés sur Toujours autoriser. Pour les outils qui modifient votre compte (favoris, recherches, alertes…), vous pouvez choisir de valider chaque action.
Installation dans Claude Code
En ligne de commande :
Lancez ensuite /mcp dans Claude Code pour vous authentifier auprès de LyBox.
Autres clients MCP
Tout client compatible avec le transport HTTP « Streamable » et l'authentification OAuth (avec enregistrement dynamique des clients) peut se connecter à l'URL https://api.lybox.fr/mcp.
Outils disponibles
Outils en lecture seule : ils consultent les données sans rien modifier.
| Outil | Description |
|---|---|
| search_ads | Rechercher des annonces à vendre avec filtres (localisation, prix, surface, rendement…) et calculs d'investissement |
| analyse_ad_url | Analyser une annonce à partir de son URL |
| find_city | Rechercher une localisation (commune, code postal, département, région) |
| search_cities | Trouver des villes par critères : tension locative, rendement moyen, démographie, prix |
| get_city | Fiche complète d'une ville : démographie, loyers, prix, tension |
| get_favorite | Ouvrir un favori et sa simulation |
| get_historic | Derniers biens consultés |
| get_user_settings | Préférences de simulation de l'utilisateur |
| list_favorite_lists | Lister mes listes de favoris |
| list_favorites | Lister les favoris d'une liste |
| list_saved_searches | Lister mes recherches sauvegardées |
| list_sectors | Lister mes secteurs |
Outils d'action : ils modifient votre compte LyBox.
| Outil | Description |
|---|---|
| add_favorite | Ajouter une annonce en favori |
| create_favorite_list | Créer une liste de favoris |
| add_favorite_to_list | Ajouter un favori à une liste |
| update_favorite | Modifier les données d'un favori (LyBox recalcule rendement et cash-flow) |
| update_favorite_status | Changer le statut d'un favori |
| delete_favorite | Supprimer un favori |
| create_project | Créer une simulation de zéro (à partir d'un PDF, d'un mail d'agence…) |
| run_ai_analysis | Lancer l'analyse IA LyBox d'un favori (1 crédit IA, 1 à 3 minutes) |
| save_sector | Enregistrer un secteur |
| save_search | Sauvegarder une recherche |
| update_search | Modifier une recherche sauvegardée |
| set_search_alert | Activer une alerte mail sur une recherche sauvegardée |
Exemples de demandes
- Trouve-moi des T2 à moins de 120 000 € à Saint-Étienne avec un rendement brut supérieur à 8 %.
- Quelles villes de plus de 20 000 habitants en Nouvelle-Aquitaine ont une forte tension locative et des prix bas ?
- Analyse cette annonce et dis-moi si le loyer estimé est cohérent avec le marché.
- Ajoute les trois meilleures annonces dans une nouvelle liste « Lille – colocation ».
- Sauvegarde cette recherche et active une alerte mail.