Hugo MCP × Claude Code

Pilotez votre activité immobilière depuis le terminal en connectant Hugo à Claude Code via le protocole MCP.

Qu'est-ce que le MCP ?

Le Model Context Protocol au service de l'immobilier

Le MCP (Model Context Protocol) est un protocole ouvert créé par Anthropic qui permet aux assistants IA comme Claude Code de se connecter à des sources de données et des outils externes. C'est la passerelle entre l'intelligence artificielle et vos données métier.

MonHubImmo expose un serveur MCP qui donne accès à plus de 20 outils spécialisés : données immobilières publiques (DVF, DPE, cadastre, risques), biens de la plateforme, alertes de surveillance, publication de contenus et bien plus. Le tout directement depuis votre terminal Claude Code.

Comment ça fonctionne

Claude Code est l'agent IA d'Anthropic qui fonctionne dans votre terminal. En configurant le serveur MCP MonHubImmo, Claude Code obtient la capacité d'interroger les données immobilières, de consulter vos biens, de créer des alertes et de publier du contenu — le tout par de simples instructions en langage naturel.

Vous demandez par exemple : "Quelles sont les transactions DVF à Lyon 3e en 2024 pour des appartements T3 ?" et Claude Code utilise automatiquement le bon outil MCP pour vous fournir la réponse.

Installation et configuration

1

Installez Claude Code

Si ce n'est pas déjà fait, installez Claude Code depuis le terminal :

npm install -g @anthropic-ai/claude-code
2

Récupérez votre clé API MonHubImmo

Connectez-vous à votre compte MonHubImmo, rendez-vous dans Tableau de bord → Hugo → Paramètres et copiez votre clé API personnelle. Cette clé authentifie vos requêtes MCP.

3

Configurez le serveur MCP

Ajoutez le serveur MonHubImmo dans votre configuration Claude Code (~/.claude/settings.json) :

{ "mcpServers": { "monhubimmo": { "url": "https://api.monhubimmo.fr/mcp", "headers": { "Authorization": "Bearer mhi_VOTRE_CLE_API" } } } }

Votre clé commence par mhi_. Elle n'est affichée qu'une seule fois lors de sa génération — copiez-la immédiatement.

4

C'est prêt !

Lancez claude dans votre terminal. Les outils MonHubImmo sont automatiquement disponibles. Demandez simplement ce dont vous avez besoin en langage naturel.

Outils d'accès aux données publiques

Interrogez les bases de données immobilières officielles françaises directement depuis Claude Code. Toutes les données sont en temps réel et géolocalisées.

search_dvf

Recherchez les transactions immobilières DVF (Demandes de Valeurs Foncières) par commune, type de bien et période.

search_dpe

Accédez aux diagnostics de performance énergétique (DPE) pour identifier passoires thermiques et performances.

search_sitadel

Consultez les permis de construire (base Sitadel/DiDo) pour anticiper les projets immobiliers à venir.

search_bodacc

Explorez les annonces BODACC : liquidations judiciaires, cessions de fonds de commerce, créations d'entreprises.

get_contexte_local

Obtenez le contexte local complet autour d'une adresse : écoles, commerces, transports, médecins, restaurants.

succession_search

Recherchez les successions récentes par département pour identifier des opportunités de prospection.

Outils plateforme MonHubImmo

Accédez directement aux données de la plateforme MonHubImmo : biens en vente, recherches d'acquéreurs et collaborations en cours.

search_biens_mhi

Recherchez les biens immobiliers publiés sur MonHubImmo avec filtres par ville, type, prix et surface.

get_property_details

Récupérez les détails complets d'un bien : description, prix, photos CDN, lien vers l'annonce et infos du propriétaire.

search_recherches_mhi

Consultez les annonces de recherche d'acquéreurs publiées sur la plateforme pour identifier des matchings.

get_my_collaborations

Visualisez toutes vos collaborations en cours : statut, partenaire, bien concerné.

get_random_properties_for_game

Récupérez des biens aléatoires avec photos et prix pour créer des jeux interactifs et du contenu engageant.

Outils de publication et de contenu

Créez et publiez du contenu professionnel directement depuis votre terminal : posts texte/HTML stylés, rapports de présentation, pages HTML hébergées et widgets interactifs sur le réseau social Hubie.

Posts Hubie

publish_post_to_hubie — publication immédiate dans le fil social, sans validation admin.

Idéal pour memes, anecdotes, citations, actualités. Accepte du HTML stylé (titres, couleurs, listes) et les hashtags sont extraits automatiquement.

Widgets Hubie

publish_widget_to_hubie — outils interactifs HTML/JS dans une iframe sandboxée.

Calculettes, jeux, simulateurs avec accès aux API DVF/DPE/permis, système de scores et proxy images. Validation admin avant publication au catalogue.

Rapports

Publiez, listez et supprimez des rapports de présentation avec URLs publiques partageables.

Pages HTML

Hébergez des pages HTML interactives avec URL publique. Idéal pour des outils, calculettes ou présentations.

Alertes et surveillance automatisée

Surveillance proactive du marché

Créez des alertes depuis Claude Code pour surveiller automatiquement les nouvelles transactions DVF, les DPE publiés, les permis de construire déposés, les annonces BODACC et les successions. Vous êtes notifié dès qu'un nouvel élément correspond à vos critères.

create_alertCréer une alerte sur un type de donnée et une zone géographique

list_alertsLister toutes vos alertes actives

check_alertDéclencher manuellement une vérification immédiate

delete_alertSupprimer une alerte devenue inutile

Exemples concrets d'utilisation

Analyse de marché express

"Analyse le marché immobilier de Bordeaux Caudéran : prix DVF 2024, DPE moyen, permis de construire récents et contexte local."

Claude Code enchaîne automatiquement search_dvf, search_dpe, search_sitadel et get_contexte_local pour vous fournir un rapport complet.

Matching acquéreur

"Trouve les biens sur MonHubImmo qui correspondent à un acquéreur cherchant un T3 à Lyon entre 200k et 300k€."

Utilise search_biens_mhi avec les critères et get_property_details pour les résultats pertinents.

Veille automatique

"Crée une alerte DVF sur le 16e arrondissement de Paris pour les ventes d'appartements au-dessus de 500k€."

Utilise create_alert pour configurer une surveillance automatique. Vous serez notifié à chaque nouvelle transaction correspondante.

Publication de contenu

"Crée un widget interactif 'Quiz immobilier' avec des biens aléatoires de MonHubImmo et publie-le sur Hubie."

Combine get_random_properties_for_game et publish_widget_to_hubie pour créer du contenu engageant.

Post texte ou meme sur Hubie

"Publie un meme immobilier sur Hubie sur le thème des clients qui veulent 200m² à Paris pour 300k€."

Utilise publish_post_to_hubie pour poster du contenu textuel ou HTML stylé (titres colorés, emojis, listes). Publication immédiate, sans validation admin, avec extraction automatique des hashtags.

Pourquoi utiliser le MCP MonHubImmo ?

Rapidité

Une seule instruction remplace des dizaines de clics. Obtenez une analyse de marché complète en quelques secondes.

Données officielles

Accédez à DVF, DPE, BODACC, Sitadel, cadastre et GéoRisques — les sources de référence du marché immobilier français.

Langage naturel

Pas de syntaxe à apprendre. Demandez en français ce que vous voulez, Claude Code choisit et appelle les bons outils automatiquement.

Sécurisé

Authentification par clé API personnelle. Vos données restent privées et chaque requête est tracée et sécurisée.

Prêt à piloter votre immobilier depuis le terminal ?

Créez votre compte MonHubImmo, récupérez votre clé API et connectez Hugo à Claude Code en 5 minutes.