Le serveur MCP d’Hippobilier permet à un assistant IA (Claude.ai, Claude Code, ChatGPT, Cursor, Le Chat…) de consulter votre parc : biens, locations, baux, paiements, quittances, candidatures, agenda, d’obtenir des liens vers vos documents, et, avec les droits correspondants, d’agir : créer un bien ou un paiement, relancer un loyer, écrire aux locataires, inviter un candidat, préparer un solde de tout compte, valider un paiement avec envoi de la quittance. L’IA propose, vous décidez : les lectures sont libres, les écritures sont approuvées dans votre assistant, les actions sensibles se confirment en deux temps (§4).
Adresse du serveur : https://www.hippobilier.com/mcp (protocole MCP 2026-07-28, transport HTTP sans état ; l’ancienne poignée de main initialize est aussi acceptée).
hpb_… : il n’est affiché qu’une fois. La page vous donne la configuration prête à coller pour chaque client.Droits d’un jeton (ou d’une connexion OAuth) : Lecture (toujours), Écriture (biens, paiements, brouillons de solde), Envois (relances, messages, invitations, validation d’un paiement avec quittance). Un outil appelé sans le droit voulu renvoie insufficient_scope ; un client OAuth redemande l’autorisation.
Un jeton par client. Révoquez-le depuis la même page ; « Suspendre toutes les connexions IA » coupe tout d’un coup.
| Client | Comment |
|---|---|
| Claude Code | claude mcp add --transport http hippobilier https://www.hippobilier.com/mcp --header "Authorization: Bearer hpb_…" puis /mcp pour vérifier. |
| Cursor, VS Code, Gemini CLI | Dans mcp.json : {"mcpServers":{"hippobilier":{"url":"https://www.hippobilier.com/mcp","headers":{"Authorization":"Bearer hpb_…"}}}} |
| Claude.ai, Claude Desktop, Claude mobile | Customize → Connectors → Add custom connector → nom « Hippobilier », URL https://www.hippobilier.com/mcp → Connect. Hippobilier vous demande de vous connecter puis d’autoriser l’assistant (droits affichés). Aucun jeton à copier. |
| ChatGPT | Settings → Apps → Developer mode → Connectors → Create : nom, URL ci-dessus, authentification OAuth. Même écran d’autorisation Hippobilier. |
| Mistral Le Chat | Connecteurs → Ajouter un connecteur MCP personnalisé → URL ci-dessus → Authentification OAuth (ou « Bearer » avec un jeton). |
| Ligne de commande | npx hippobilier login ouvre le navigateur pour autoriser la CLI sur Hippobilier (OAuth, jeton renouvelé automatiquement) ; npx hippobilier login --token pour coller un jeton. Puis npx hippobilier payments list --state pending, npx hippobilier payments validate 1234, --json pour les scripts. npx hippobilier --help liste les commandes. |
| Claude Code sans jeton | claude mcp add --transport http hippobilier https://www.hippobilier.com/mcp puis /mcp : la connexion OAuth s’ouvre dans le navigateur. |
Vérification en ligne de commande : npx @modelcontextprotocol/inspector --cli https://www.hippobilier.com/mcp --transport http --header "Authorization: Bearer hpb_…" --method tools/list.
| Outil | Usage |
|---|---|
get_me |
Votre compte, votre plan, les droits du jeton, la taille du parc, les consignes. Appelé en premier. |
get_dashboard |
Occupation, loyers du mois attendus / perçus, impayés, assurances et candidatures en attente, prochains événements. |
search |
Trouver un locataire, un bien ou un immeuble par son nom pour obtenir ses identifiants. |
list_properties, get_property |
Biens, lots, pièces, équipements, lignes de charges, locations en cours. |
list_rentals, get_rental |
Locations par statut (à venir, en cours, à traiter, archivées) et détail (bail, dépôt, assurance, solde, paiements). |
get_rent_roll |
État locatif d’un mois : attendu, perçu, retard par location. |
list_payments, list_rent_receipts |
Paiements (un paiement n’est perçu que s’il est payé) et quittances. |
list_leases, get_lease, compute_rent_revision |
Baux, signatures, IRL figé ; simulation de révision de loyer (aucune écriture). |
list_tenant_applications |
Candidatures avec score d’analyse ; les pièces ne sont jamais transmises, seulement leur présence. |
list_upcoming_events |
Entrées, sorties, états des lieux, fins de bail, anniversaires. |
get_document_link |
Lien de 10 minutes vers un PDF (bail, quittance, caution, état des lieux, solde) ou une pièce, à ouvrir connecté à Hippobilier. |
get_payment, list_ai_actions |
Détail d’un paiement ; journal des actions faites par vos assistants (« qu’as-tu fait hier ? »). |
Outils d’écriture (droit Écriture, approuvés par votre assistant avant chaque appel) :
| Outil | Effet |
|---|---|
create_property, update_property |
Créer ou modifier un bien (type, surface, loyer, charges, adresse, immeuble). |
create_payment, update_payment, mark_payment_overdue |
Créer un loyer attendu (jamais de doublon de mois), corriger un paiement en attente, marquer un loyer impayé. Rien n’est envoyé au locataire. |
create_final_statement, update_final_statement |
Brouillon de solde de tout compte pré-rempli (caution, impayés, charges du bien au prorata, provisions), totaux calculés par Hippobilier. L’envoi au locataire se fait sur Hippobilier. |
Outils d’envoi (droit Envois) :
| Outil | Effet |
|---|---|
send_payment_reminder |
Email de rappel de paiement d’Hippobilier au locataire, copie à vous. Une relance par paiement tous les 3 jours. |
send_message |
Message dans la messagerie Hippobilier (notification sur l’application du locataire). Le texte est envoyé tel quel. |
create_tenant_invitation |
Invitation d’un candidat à déposer son dossier (email avec le lien du formulaire). |
validate_payment |
Action sensible : le paiement passe à payé, la quittance PDF est générée et envoyée par email. Confirmation en deux temps (§4). |
send_final_statement |
Sensible : finalise le solde de tout compte et l’envoie par email avec le PDF (RIB joint si le locataire vous doit de l’argent). |
finish_rental |
Sensible : déclare le départ du locataire ; loyer du mois de sortie proratisé, emails de fin de location, abonnement ajusté. |
accept_tenant_application, refuse_tenant_application |
Sensibles : acceptation (compte locataire créé, email avec lien pour définir son mot de passe) ou refus (email au candidat). |
validate_check_in_inventory |
Sensible : validation de l’état des lieux d’entrée et envoi du PDF au locataire et à vous. |
Autres outils (droit Écriture) : validate_insurance, analyze_tenant_application (lance l’analyse de dossier, asynchrone, une fois par 24 h), create_room, update_room, create_gear, update_gear, upsert_charge_line (pièces, équipements et lignes de charges d’un bien), update_rental, update_lease (bail en attente seulement), update_profile (téléphone, raison sociale, SIRET, adresse) ; envois : resend_tenant_invitation (un rappel par 24 h), resend_rent_receipt, send_signature_reminder (un rappel par 48 h) ; sensibles : close_rental (archivage sans solde), reject_insurance (fichier supprimé), cancel_payment (quittance détruite), delete_room, delete_gear, delete_charge_line, delete_tenant_invitation, delete_property (bien sans aucun historique). Lectures complémentaires : get_final_statement, list_final_statements, get_tenant_application, list_tenant_invitations, list_tenants, list_conversations, get_conversation, list_inventories, get_inventory, get_room, list_rent_reference_indexes, get_subscription, prepare_lease (lien du formulaire de bail pré-rempli : la création et la signature du bail restent sur le web).
Des demandes types à copier figurent sur la page Intégrations IA. Prompts prêts à l’emploi (menu des prompts de votre client) : bilan_mensuel, point_hebdo, relance_impayes, preparer_solde, revision_loyer, rapport_annuel_fiscal, onboarding_locataire.
Exemples : « Quels loyers de septembre ne sont pas encore reçus ? », « Taux d’occupation de l’immeuble Ramus ? », « Prépare le solde de la location 472, je vérifierai avant l’envoi », « Révise le loyer du bail 12 avec l’IRL du T2 2026 ».
Une action sensible (valider ou annuler un paiement, envoyer un solde, terminer ou clôturer une location, accepter ou refuser une candidature, refuser une assurance, valider un état des lieux) ne s’exécute jamais au premier appel. L’assistant reçoit un récapitulatif rédigé par Hippobilier (paiement, montant, date, locataires, conséquences : quittance générée et emailée, irréversible) qu’il doit vous restituer tel quel.
https://www.hippobilier.com/integrations/confirmations/…, valable 5 minutes, usage unique. Vous l’ouvrez connecté à Hippobilier, relisez, cliquez « Confirmer et exécuter ». L’assistant ne peut pas confirmer à votre place ; il relit ensuite l’état avec un outil de lecture ou list_ai_actions.confirm reçu (5 minutes, usage unique, mêmes arguments, même jeton d’accès). Vous recevez un email à chaque action ainsi confirmée (désactivable).Garde-fous communs : 60 écritures et 20 actions sensibles par heure, 200 envois par jour par compte ; les créations acceptent une idempotency_key (un nouvel essai avec la même clé sous 24 h renvoie le premier résultat, sans doublon) ; chaque action est inscrite au journal avec ses arguments (textes de messages masqués) ; « Suspendre toutes les connexions IA » coupe tout.
Alertes par email, toujours envoyées : création d’un jeton, première connexion d’un assistant par OAuth, et retour automatique en mode prudent après trois confirmations en échec (jeton expiré, réutilisé ou incohérent) en 24 heures. Le journal s’exporte en CSV ou JSON depuis la page Journal ; il est conservé 12 mois.
401 : jeton absent, révoqué ou expiré → créez-en un nouveau. 429 : trop de requêtes, réessayez après le délai indiqué.isError) porte un code : forbidden (pas votre ressource), not_found, insufficient_scope (droit manquant sur le jeton), invalid_argument, validation_error, invalid_state (ex. paiement déjà payé), duplicate_period, already_exists, too_soon (relance récente), quota_exceeded (avec retry_after_seconds), confirmation_expired / confirmation_mismatch / confirmation_used / web_confirmation_required (confirmation en deux temps), idempotency_conflict./.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server ; enregistrement des clients par document de métadonnées (client_id en URL) ou POST /oauth/register.https://www.hippobilier.com/docs/api, description brute https://www.hippobilier.com/api/v1/openapi.json. Les jetons hpb_… y sont acceptés (GET = Lecture, écritures = Écriture) ; elle sert notamment aux GPT Actions.https://www.hippobilier.com/docs/ia.Signer un bail (pour vous, le locataire ou le garant), payer ou gérer l’abonnement, supprimer un compte, changer votre email ou votre RIB, envoyer un email libre, lire le contenu des pièces justificatives. Ces actes se font sur Hippobilier.
Tableaux interactifs dans les assistants qui les supportent, connecteur pour les locataires, assistant intégré à Hippobilier.
Référence de l'API REST :/docs/api · Métadonnées OAuth :/.well-known/oauth-authorization-server