Saltar al contenido

Guía

Breeze en tu asistente: el servidor MCP para brokers

Bancos de arena y arrecife bajo el agua turquesa, vistos desde arriba

Si eres broker con acceso a Breeze, puedes conectar tu cuenta a Claude o a ChatGPT y administrar tu inventario hablando con tu asistente. Esta página explica qué puede hacer, qué necesitas y cómo conectarlo paso a paso.

Cómo se conecta tu asistente
  1. Tu asistenteClaude o ChatGPT, con la opción de agregar conectores.

    pide permiso una vez

  2. Tu cuenta BreezeInicias sesión y apruebas los permisos que eliges.

    emite un acceso limitado

  3. Servidor MCP de BreezeTraduce cada pedido del asistente a la API de Breeze.

    actúa solo con tus permisos

  4. Tu inventarioTus unidades, tus envíos y Mi zona. Nada de otros brokers.
  • Lo que el asistente sube entra en revisión: nada se publica sin el equipo de Breeze.
  • Para cortar el acceso, quita el conector o pide al equipo de Breeze que lo revoque.

Qué es MCP

MCP (Model Context Protocol) es un estándar abierto para conectar asistentes de inteligencia artificial con servicios externos. Breeze tiene un servidor MCP: al conectarlo, tu asistente puede consultar y actualizar tu cuenta de Breeze cuando se lo pides.

Qué puede hacer el asistente

El servidor ofrece nueve herramientas. No necesitas nombrarlas: el asistente elige la que corresponde a lo que le pides.

  • Buscar inventario: la misma búsqueda pública del sitio, sin datos de brokers.
  • Mis unidades: tus unidades, con su estado y si están en revisión o fueron rechazadas.
  • Actualizar unidad: cambia el precio, la moneda o el estado de una unidad tuya. Antes de cambiarla, el asistente la consulta; si alguien la modificó mientras tanto, te pide confirmar otra vez.
  • Crear envío de inventario: da de alta una unidad, que entra en revisión.
  • Crear borrador de desarrollo: a partir del brochure que le adjuntes, da de alta un desarrollo con sus tipologías como borrador.
  • Importar fotos de Google Drive: descarga las fotos de una carpeta compartida a tu unidad, tu envío o tu desarrollo.
  • Enlace de subida: te da un enlace para subir fotos desde el celular, sin Drive.
  • Estado de mis envíos: en qué va cada envío, borrador e importación, con el motivo si algo se rechazó.
  • Mi zona: el resumen agregado de tus zonas, si tienes esa función activa.

Algunos ejemplos de lo que puedes decirle: «Muéstrame mis unidades en Breeze», «Marca como vendida la casa de la calle tal», «¿En qué van mis envíos?». Di siempre la moneda de los precios, pesos o dólares. Si trabajas con más de una agencia, el asistente te preguntará a nombre de cuál.

Qué necesitas

  • Una cuenta de Breeze con el correo confirmado y dada de alta como broker de tu agencia.
  • El acceso a la API y al asistente activado por el equipo de Breeze. Pídelo a tu contacto en Breeze y dile qué vas a usar: ver unidades, cambiar precios, dar de alta inventario o desarrollos, ver tu zona.
  • Claude (claude.ai, la app o Claude Code) o ChatGPT con la opción de agregar conectores.

Sin el acceso activo, al conectar verás una pantalla de «sin acceso».

La dirección del servidor

En todos los asistentes la dirección es la misma: https://www.breezerealestate.mx/mcp

Las pantallas de Claude y de ChatGPT cambian con frecuencia. Si un botón tiene otro nombre o está en otro lugar, busca la sección de conectores en la configuración.

En Claude (claude.ai o la app)

  1. Abre Configuración → Conectores.
  2. Elige Agregar conector personalizado.
  3. Nombre: Breeze. URL: https://www.breezerealestate.mx/mcp. Guarda.
  4. Pulsa Conectar. Se abre Breeze en el navegador: inicia sesión y pulsa Autorizar.
  5. En una conversación nueva, activa el conector Breeze desde el menú de herramientas o conectores.

En los planes de equipo o empresa, puede que el administrador de tu cuenta de Claude tenga que agregar el conector primero.

En Claude Code

  1. En la terminal, agrega el servidor: claude mcp add --transport http breeze https://www.breezerealestate.mx/mcp
  2. Dentro de Claude Code, escribe /mcp, elige breeze y sigue la opción para autenticarte. Se abre Breeze en el navegador: inicia sesión y pulsa Autorizar.
  3. Pídele, por ejemplo, «lista mis unidades en Breeze».

En ChatGPT

  1. Abre Configuración → Apps y conectores.
  2. Si no ves cómo agregar uno propio, activa el modo desarrollador en la configuración avanzada de esa misma sección.
  3. Elige Crear o Agregar conector, pega la URL https://www.breezerealestate.mx/mcp y elige OAuth como autenticación.
  4. Se abre Breeze en el navegador: inicia sesión y pulsa Autorizar.
  5. En una conversación, elige el conector Breeze en el menú de herramientas.

La autorización

Tu asistente nunca recibe tu contraseña. Inicias sesión en la propia página de Breeze, que te muestra los permisos que estás concediendo y a qué servicio regresas. Al pulsar Autorizar, Breeze le da al asistente un acceso temporal que se renueva solo mientras lo uses.

Si la conexión se cae, por ejemplo porque Breeze cambió tus permisos o pasó más de un mes sin usarlo, el asistente te pedirá que vuelvas a conectar: repite el paso de Conectar.

Fotos desde Google Drive o desde el celular

Pon las fotos en formato JPG, PNG o WebP en una carpeta de Drive y compártela como «Cualquier persona con el enlace», con permiso de lector. Si prefieres no hacerla pública, compártela solo con el correo de la cuenta de servicio de Breeze, que te damos al activar tu acceso. Pásale el enlace al asistente y dile a qué unidad, envío o desarrollo van.

Las fotos HEIC del iPhone todavía no se aceptan: expórtalas como JPG. Los videos, las subcarpetas y los documentos de Google se ignoran.

Sin Drive, pide «un enlace para subir fotos». El enlace vale 24 horas, no pide iniciar sesión y queda ligado al primer navegador o celular con el que subas, así que no lo compartas.

Qué pasa después

  • Inventario: la unidad se crea al momento, en revisión. La ves en tus unidades y en una vista previa privada, pero no es pública hasta que el equipo de Breeze la aprueba, con al menos una foto aprobada.
  • Desarrollos: quedan como borrador. El equipo revisa cada campo contra el brochure antes de publicarlo y quita las cifras de plusvalía, rendimiento u ocupación.
  • Fotos: quedan pendientes y entran a la ficha cuando el equipo las aprueba.
  • Precio y estado de tus unidades publicadas: el cambio se aplica al momento y queda en el historial de precio.

Qué ve el asistente y qué no

El asistente actúa con los permisos de tu cuenta y nada más. Ve tus unidades y las de tu agencia que tu cuenta puede ver, tus envíos, borradores e importaciones, y los datos agregados de «Mi zona».

No puede:

  • Ver ni editar unidades, leads o datos de otros brokers.
  • Darte datos personales ni de contacto de compradores o clientes.
  • Publicar nada sin la revisión de Breeze, ni activar por primera vez una unidad.
  • Borrar unidades, fotos publicadas o envíos.
  • Inventar cifras de mercado: si no hay datos suficientes, responde «Sin datos».

Lo que las herramientas devuelven lo lee tu asistente, y queda en tu conversación según las condiciones de Claude o de ChatGPT. Aparte de lo que das de alta, Breeze no guarda en sus registros técnicos el contenido de tus peticiones ni de las respuestas.

Tu tope de unidades, una cuenta en pausa y las funciones que tengas activas aplican igual que en el portal. Si algo no está permitido, el asistente te dice por qué.

Cómo revocar el acceso

  • Quita el conector Breeze en la configuración de tu asistente.
  • O pide al equipo de Breeze que revoque tu acceso. Al revocarlo, todas las conexiones de tu cuenta dejan de funcionar en menos de un minuto, en cualquier asistente.

Escríbenos con tus dudas

Te respondemos con información para tu caso.

Escríbenos