Aller au contenu principal
Aller au contenu principal
Connecteur MCP

Brik dans Claude, ChatGPT ou Cursor

Le connecteur MCP de Brik relie votre compte à l'assistant IA que vous utilisez déjà. Après votre autorisation, l'assistant lit vos baux, vos loyers, vos impayés, vos documents et vos transactions, avec vos droits et rien de plus. La connexion est en lecture par défaut ; l'écriture dans votre propre portefeuille ne s'ouvre que si vous l'autorisez au moment de la connexion.

Adresse du serveur

https://app.brik.com/api/mcp

À copier depuis Mon compte › MCP, puis à ajouter comme connecteur personnalisé dans votre assistant. OAuth 2.1, identifiants Brik, révocable à tout moment.

ClaudeChatGPTCursor

Ce qui circule

Quelles données passent entre Brik et votre assistant, et dans quel sens.

  • De Brik vers l'assistant, en lecture : biens, baux, locataires, avis de loyer et quittances, impayés, documents, transactions bancaires et pré-comptabilité, selon les produits activés sur votre compte et vos droits.
  • De l'assistant vers Brik, seulement avec votre consentement (portée account.write) : créer une location à partir d'un bail que vous lui transmettez, après un récapitulatif ; chaque action préparée est confirmée avant d'être exécutée.
  • Les documents (avis de loyer, quittances, pièces jointes) sont transmis par des liens signés valables 15 minutes, jamais copiés chez l'assistant.
  • Rien d'autre : l'assistant ne voit que votre compte, et toutes les IA connectées ont les mêmes droits que vous.

Comment l'activer

Trois minutes, depuis Mon compte › MCP.

  1. 1Ouvrez le menu profil → Paramètres du compte → onglet MCP, et copiez l'adresse https://app.brik.com/api/mcp.
  2. 2Claude : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, collez l'adresse.
  3. 3ChatGPT : Paramètres → Applications connectées → Ajouter une application (MCP), collez l'adresse.
  4. 4Cursor ou tout autre client compatible MCP : ajoutez un serveur MCP distant avec la même adresse ; la découverte OAuth et l'enregistrement du client sont automatiques.
  5. 5Authentifiez-vous avec vos identifiants Brik (et, le cas échéant, votre code de vérification), puis répondez à la question « Autoriser les modifications ? » : « Non » pour une connexion en lecture, « Oui » pour permettre à l'assistant de créer une location depuis un bail.
  6. 6Revenez dans l'onglet MCP pour suivre les accès autorisés, la consommation (24 heures, 7 jours, 30 jours, erreurs, répartition par outil) et révoquer un accès à tout moment : la coupure est immédiate.

Pour ouvrir l'écriture sur une connexion déjà créée en lecture : révoquez-la, puis reconnectez l'assistant en répondant « Oui ». Le pas à pas illustré est dans le centre d'aide.

Formule requise

Suit l'abonnement du compte

Le connecteur n'est pas une option payante : il sert ce que votre abonnement ouvre. Les lectures de gestion locative demandent une formule Gestion Locative (Basic ou Complète) ou un essai actif ; celles du patrimoine demandent Gestion Locative + Patrimoine ou un essai ; les encaissements de la pré-comptabilité demandent la Complète, et la pré-comptabilité complète demande la Complète et le Patrimoine. Sans abonnement ni essai actif, aucune donnée n'est servie. Brik Pro utilise le même connecteur, avec les produits et les droits du compte. Voir les formules.

Ce que l'intégration ne fait pas

Ce qui est annoncé ici est ce qui existe dans l'application : voici les limites, assumées.

  • Il ne modifie ni ne supprime rien d'existant, même avec l'écriture autorisée : la seule création possible est une location à partir d'un bail, après récapitulatif. Émettre une quittance, attribuer une transaction ou envoyer une relance se fait dans l'application.
  • Il n'envoie aucun e-mail à vos locataires et n'active aucune automatisation.
  • Ce n'est pas une API REST publique ni un flux de webhooks : l'accès programmatique à votre compte passe par ce connecteur et par les exports (FEC, CSV).
  • Il ne remplace pas l'Assistant IA Brik ni l'agent Communication locataire, qui vivent dans l'application avec le contexte de vos écrans.
  • Il ne donne accès qu'à vos données : celles auxquelles votre compte a droit, dans la limite de vos produits activés.
  • Il est limité à 100 requêtes par minute et par compte ; au-delà, l'assistant reçoit une erreur temporaire (429).

Points techniques

  • Point d'entrée : https://app.brik.com/api/mcp (POST, jeton OAuth 2.1 ; GET /api/mcp/health est public)
  • Découverte OAuth : https://app.brik.com/api/mcp/.well-known/oauth-protected-resource (RFC 9728) et https://app.brik.com/api/mcp/.well-known/oauth-authorization-server (RFC 8414)
  • Enregistrement dynamique du client (RFC 7591) sur /api/mcp/oauth/register ; autorisation sur /api/mcp/oauth/authorize (connexion Brik et consentement) ; jeton sur /api/mcp/oauth/token
  • OAuth 2.1 : code d'autorisation avec PKCE (S256), client public (token_endpoint_auth_methods none), jeton d'accès valable 1 heure, jeton de rafraîchissement
  • Portées : read (par défaut) et account.write (sur consentement)

À propos du protocole MCP

Le MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA d'accéder de manière sécurisée à des données externes. Claude, ChatGPT, Cursor et les autres clients compatibles parlent le même protocole : un serveur MCP comme celui de Brik se branche une fois et sert tous ces assistants de la même façon, avec OAuth pour l'identité et le consentement. Brik publie son serveur à l'adresse ci-dessus ; la liste des clients compatibles n'est pas limitative.

Trois questions à poser à votre assistant

Vous écrivez en français, l'assistant appelle les outils du serveur et répond avec vos chiffres.

  • « Quels loyers d'octobre ne sont pas encore encaissés, et depuis combien de jours ? »

    L'assistant lit vos avis de loyer et vos encaissements, puis liste les retards avec le locataire et le montant.

  • « Quels baux arrivent à échéance dans les six prochains mois ? »

    Il parcourt vos baux et vous rend la liste, bien par bien, avec la date de fin et le type de bail.

  • « Envoie-moi la quittance de septembre du 12 rue des Lilas. »

    Il retrouve le document et vous donne un lien signé, valable 15 minutes, vers le PDF.

Chaque appel est journalisé et visible dans Mon compte › MCP (répartition par outil, statut, durée, date). Vous révoquez un accès en un clic ; l'assistant perd la connexion immédiatement.

Questions fréquentes sur le connecteur MCP

Cette fiche décrit ce qui existe dans l'application au moment de sa relecture (octobre 2026). Les autres connexions sont listées sur la page Intégrations.