Aller au contenu

Guide

Breeze dans votre assistant : le serveur MCP pour les agents

Bancs de sable et récif sous l’eau turquoise, vus du ciel

Si vous êtes agent immobilier avec un accès à Breeze, vous pouvez connecter votre compte à Claude ou à ChatGPT et gérer votre inventaire en parlant à votre assistant. Cette page explique ce qu'il peut faire, ce dont vous avez besoin et comment le connecter étape par étape.

Comment votre assistant se connecte
  1. Votre assistantClaude ou ChatGPT, avec l'option d'ajouter des connecteurs.

    demande l'autorisation une fois

  2. Votre compte BreezeVous vous connectez et approuvez les autorisations choisies.

    délivre un accès limité

  3. Serveur MCP de BreezeTraduit chaque demande de l'assistant vers l'API de Breeze.

    agit uniquement avec vos autorisations

  4. Votre inventaireVos biens, vos envois et Ma zone. Rien d'autres brokers.
  • Ce que l'assistant dépose passe en révision : rien n'est publié sans l'équipe Breeze.
  • Pour couper l'accès, retirez le connecteur ou demandez à l'équipe Breeze de le révoquer.

Qu'est-ce que MCP

MCP (Model Context Protocol) est une norme ouverte qui relie les assistants d'intelligence artificielle à des services externes. Breeze dispose d'un serveur MCP : une fois connecté, votre assistant peut consulter et mettre à jour votre compte Breeze quand vous le lui demandez.

Ce que l'assistant peut faire

Le serveur propose neuf outils. Inutile de les nommer : l'assistant choisit celui qui correspond à votre demande.

  • Rechercher dans l'inventaire : la même recherche publique que sur le site, sans données d'agents.
  • Mes biens : vos biens, avec leur statut et l'indication s'ils sont en cours de vérification ou ont été refusés.
  • Mettre à jour un bien : modifie le prix, la devise ou le statut d'un de vos biens. Avant de le modifier, l'assistant le consulte ; si quelqu'un l'a changé entre-temps, il vous demande de confirmer à nouveau.
  • Créer un envoi d'inventaire : ajoute un bien, qui passe en vérification.
  • Créer un brouillon de programme : à partir de la brochure que vous joignez, ajoute un programme avec ses typologies sous forme de brouillon.
  • Importer des photos depuis Google Drive : télécharge les photos d'un dossier partagé vers votre bien, votre envoi ou votre programme.
  • Lien de téléversement : vous donne un lien pour envoyer des photos depuis votre téléphone, sans Drive.
  • État de mes envois : où en est chaque envoi, brouillon et import, avec le motif en cas de refus.
  • Ma zone : le résumé agrégé de vos zones, si cette fonction est activée pour vous.

Quelques exemples de demandes : « Montre-moi mes biens sur Breeze », « Marque comme vendue la maison de telle rue », « Où en sont mes envois ? ». Précisez toujours la devise d'un prix, pesos ou dollars. Si vous travaillez avec plusieurs agences, l'assistant vous demandera pour laquelle.

Ce dont vous avez besoin

  • Un compte Breeze avec une adresse électronique confirmée, enregistré comme agent de votre agence.
  • L'accès à l'API et à l'assistant activé par l'équipe Breeze. Demandez-le à votre contact chez Breeze en précisant l'usage prévu : consulter vos biens, modifier des prix, ajouter de l'inventaire ou des programmes, consulter votre zone.
  • Claude (claude.ai, l'application ou Claude Code) ou ChatGPT avec la possibilité d'ajouter des connecteurs.

Sans accès actif, vous verrez un écran « sans accès » au moment de la connexion.

L'adresse du serveur

L'adresse est la même dans tous les assistants : https://www.breezerealestate.mx/mcp

Les écrans de Claude et de ChatGPT changent souvent. Si un bouton porte un autre nom ou se trouve ailleurs, cherchez la section des connecteurs dans les paramètres.

Dans Claude (claude.ai ou l'application)

  1. Ouvrez Paramètres → Connecteurs.
  2. Choisissez Ajouter un connecteur personnalisé.
  3. Nom : Breeze. URL : https://www.breezerealestate.mx/mcp. Enregistrez.
  4. Cliquez sur Connecter. Breeze s'ouvre dans votre navigateur : connectez-vous et cliquez sur Autoriser.
  5. Dans une nouvelle conversation, activez le connecteur Breeze depuis le menu des outils ou des connecteurs.

Avec les offres équipe ou entreprise, l'administrateur de votre compte Claude devra peut-être ajouter le connecteur d'abord.

Dans Claude Code

  1. Dans le terminal, ajoutez le serveur : claude mcp add --transport http breeze https://www.breezerealestate.mx/mcp
  2. Dans Claude Code, tapez /mcp, choisissez breeze et suivez l'option d'authentification. Breeze s'ouvre dans votre navigateur : connectez-vous et cliquez sur Autoriser.
  3. Demandez-lui par exemple « liste mes biens sur Breeze ».

Dans ChatGPT

  1. Ouvrez Paramètres → Applications et connecteurs.
  2. Si vous ne voyez pas comment ajouter le vôtre, activez le mode développeur dans les paramètres avancés de cette même section.
  3. Choisissez Créer ou Ajouter un connecteur, collez l'URL https://www.breezerealestate.mx/mcp et choisissez OAuth comme authentification.
  4. Breeze s'ouvre dans votre navigateur : connectez-vous et cliquez sur Autoriser.
  5. Dans une conversation, sélectionnez le connecteur Breeze dans le menu des outils.

L'autorisation

Votre assistant ne reçoit jamais votre mot de passe. Vous vous connectez sur la page même de Breeze, qui affiche les autorisations que vous accordez et le service vers lequel vous revenez. En cliquant sur Autoriser, Breeze donne à l'assistant un accès temporaire, qui ne se renouvelle que tant que vous l'utilisez.

Si la connexion tombe, par exemple parce que Breeze a modifié vos autorisations ou que vous ne l'avez pas utilisée depuis plus d'un mois, l'assistant vous demandera de vous reconnecter : refaites l'étape Connecter.

Des photos depuis Google Drive ou votre téléphone

Placez vos photos, au format JPG, PNG ou WebP, dans un dossier Drive et partagez-le avec « Tous les utilisateurs disposant du lien », en lecture seule. Si vous préférez ne pas le rendre public, partagez-le uniquement avec l'adresse du compte de service de Breeze, que nous vous communiquons à l'activation de votre accès. Donnez le lien à l'assistant et indiquez-lui à quel bien, envoi ou programme les photos sont destinées.

Les photos HEIC de l'iPhone ne sont pas encore acceptées : exportez-les en JPG. Les vidéos, les sous-dossiers et les documents Google sont ignorés.

Sans Drive, demandez « un lien pour envoyer des photos ». Le lien est valable 24 heures, ne demande pas de connexion et reste lié au premier navigateur ou téléphone depuis lequel vous envoyez : ne le partagez pas.

Ce qui se passe ensuite

  • Inventaire : le bien est créé immédiatement, en cours de vérification. Vous le voyez dans vos biens et dans un aperçu privé, mais il n'est public qu'après l'approbation de l'équipe Breeze, avec au moins une photo approuvée.
  • Programmes : ils restent à l'état de brouillon. L'équipe vérifie chaque champ par rapport à la brochure avant de publier et retire les chiffres de plus-value, de rendement ou d'occupation.
  • Photos : elles restent en attente et apparaissent sur la fiche une fois approuvées par l'équipe.
  • Prix et statut de vos biens publiés : le changement s'applique immédiatement et entre dans l'historique des prix.

Ce que l'assistant voit et ne voit pas

L'assistant agit avec les autorisations de votre compte, rien de plus. Il voit vos biens et ceux de votre agence que votre compte peut consulter, vos envois, brouillons et imports, ainsi que les données agrégées de « Ma zone ».

Il ne peut pas :

  • Consulter ni modifier les biens, prospects ou données d'autres agents.
  • Vous donner les données personnelles ou les coordonnées d'acheteurs ou de clients.
  • Publier quoi que ce soit sans la vérification de Breeze, ni activer un bien pour la première fois.
  • Supprimer des biens, des photos publiées ou des envois.
  • Inventer des chiffres de marché : faute de données suffisantes, il répond « Aucune donnée ».

Ce que renvoient les outils est lu par votre assistant et reste dans votre conversation selon les conditions de Claude ou de ChatGPT. En dehors de ce que vous soumettez, Breeze ne conserve dans ses journaux techniques ni le contenu de vos demandes ni celui des réponses.

Votre plafond de biens, une mise en pause du compte et les fonctions activées s'appliquent comme dans le portail. Si une action n'est pas permise, l'assistant vous explique pourquoi.

Comment révoquer l'accès

  • Retirez le connecteur Breeze dans les paramètres de votre assistant.
  • Ou demandez à l'équipe Breeze de révoquer votre accès. Une fois l'accès révoqué, toutes les connexions de votre compte cessent de fonctionner en moins d'une minute, dans tous les assistants.

Envoyez-nous vos questions

Nous vous répondrons avec des informations adaptées à votre cas.

Écrivez-nous