MCP — para Claude y herramientas de desarrollo

LetsRealty ofrece un servidor remoto de Model Context Protocol, para que un asistente de IA pueda trabajar en tu CRM conversando: "¿a qué Leads calientes no hemos llamado esta semana?", "registra este chat de WhatsApp como nota en el Lead de Ana".

  • Con una clave de API: https://api.letsrealty.io/mcp (Streamable HTTP), con Authorization: Bearer lr_live_…
  • Con sesión de un usuario (OAuth): https://<tu-slug>.admin.letsrealty.io/mcp, la dirección de tu consola. Cada usuario encuentra la suya en Ajustes › Conexiones con IA.

Ambas siguen la especificación de MCP hasta la versión 2026-07-28. Las llamadas por MCP no le cuestan IA a LetsRealty y no cuentan para tu cupo de IA ni para las tareas mensuales del Asistente. Sí cuentan para tus límites de uso.

Inicia sesión como usuario (OAuth)

Los conectores de Claude y ChatGPT inician sesión con OAuth 2.1, como describe la especificación de autorización de MCP. Agrega la URL /mcp de tu consola como conector personalizado y la app hace el resto: un 401 de /mcp le indica los metadatos del recurso protegido (RFC 9728), que nombran a tu consola como servidor de autorización (metadatos RFC 8414 en /.well-known/oauth-authorization-server). La app se identifica con un Client ID Metadata Document (un client_id https) o se registra con Dynamic Client Registration (/oauth/register). El usuario inicia sesión en tu consola y la permite en una pantalla de consentimiento. La autorización usa PKCE (S256) y un redirect_uri exacto, y los tokens quedan ligados al /mcp de esa consola (resource de RFC 8707): no funcionan en ningún otro lugar. Los refresh tokens rotan en cada uso, y uno reutilizado termina la conexión.

Una app con sesión iniciada recibe las herramientas del Asistente de la consola para el rol de ese usuario, con exactamente sus permisos: un agente solo cambia sus propias propiedades y nunca ve las herramientas del sitio web. Cada herramienta define las cuatro pistas (hints); toda herramienta que cambia algo está marcada como destructiva, así que la app pregunta antes de ejecutarla. Un cambio se hace directamente, responde con enlaces a lo que cambió y queda registrado como "via <app>". El usuario puede deshacerlo desde Ajustes › Conexiones con IA durante 24 horas, y desconectar la app ahí en cualquier momento.

Clientes compatibles: Claude (todos los planes) y ChatGPT Business y Enterprise. Para automatizaciones como Zapier, usa una clave de API.

Claves de API: elige los permisos de la clave

Las herramientas que puede usar una clave dependen de sus permisos. Para un asistente que solo responde preguntas, dale leads:read, activities:read y properties:read. Agrega leads:write, activities:write y properties:write solo si debe cambiar cosas: las herramientas que cambian el estado, archivan o reasignan un Lead, o archivan una propiedad, están marcadas como destructivas, así que tu cliente te pide confirmación antes de ejecutarlas.

Herramientas

  • search_leads (leads:read) — Busca Leads por estado, nivel de Lead Score, responsable, updated_since y texto.
  • get_lead (leads:read) — Un Lead con sus consultas recientes y, con activities:read, sus actividades recientes.
  • list_inquiries (leads:read) — Consultas, opcionalmente de un Lead o sobre una propiedad.
  • list_open_activities (activities:read) — Actividades sin completar, las más próximas primero; overdue, today o week.
  • ingest_lead (leads:ingest) — Registra que alguien se puso en contacto, como POST /v1/leads:ingest.
  • add_note (activities:write) — Registra una nota en un Lead.
  • create_task (activities:write) — Agenda una tarea en un Lead.
  • complete_activity (activities:write) — Marca una actividad como hecha.
  • update_lead_status (leads:write) — Mueve un Lead a otra etapa (destructiva); a closed_lost necesita un lost_reason, y other un lost_reason_note.
  • archive_lead (leads:write) — Archiva un Lead (destructiva).
  • assign_owner (leads:write) — Asigna o quita el responsable del Lead (destructiva).
  • pin_lead_tier (leads:write) — Fija a mano el nivel de un Lead (Hot, Warm, Moderate o Cold); el Lead Score sigue calculándose por debajo y nunca lo cambia.
  • clear_lead_tier (leads:write) — Quita el nivel fijado de un Lead, para que vuelva a ser el de su Lead Score.
  • search_properties (properties:read) — Busca propiedades por texto, listing_type, place_code y updated_since, también las archivadas con include_archived, en un Idioma del Sitio con lang.
  • get_property (properties:read) — Una propiedad, en un Idioma del Sitio con lang.
  • find_matching_leads (leads:read) — Los Leads activos cuyos criterios guardados cumple una propiedad.
  • create_property (properties:write) — Crea una propiedad, como POST /v1/properties.
  • update_property (properties:write) — Cambia los campos de una propiedad.
  • add_property_image_from_url (properties:write) — Agrega una foto a una propiedad desde una URL https, como POST /v1/properties/{property_id}/images:import.
  • archive_property (properties:write) — Archiva una propiedad (destructiva).
  • market_answer (market:read) — Qué piden los anuncios en el mercado para un Lugar, tipo de propiedad, habitaciones y baños, como GET /v1/market/answer; place acepta un código de Lugar o el nombre de un cantón o distrito. Consulta Respuestas de mercado.

Una clave solo ve las herramientas que sus permisos permiten. Los resultados usan las mismas estructuras que la referencia de la API. Cada solicitud MCP cuenta para tus límites de uso como cualquier llamada a la API, ingest_lead usa además el cupo de ingesta, y market_answer el de las respuestas de mercado. ingest_lead, add_note, create_task, create_property y update_property aceptan un idempotency_key opcional: un reintento con la misma clave y los mismos argumentos devuelve el primer resultado en vez de escribir dos veces.

Claude Code

claude mcp add --transport http letsrealty https://api.letsrealty.io/mcp \
  --header "Authorization: Bearer $LETSREALTY_API_KEY"

Claude Desktop, Claude.ai y ChatGPT

Agrega un conector personalizado con la URL de tu consola, https://<tu-slug>.admin.letsrealty.io/mcp, e inicia sesión cuando te lo pida, como se describe arriba. No necesitas una clave.

Cursor y otros clientes

Funciona cualquier cliente que acepte headers estáticos. Para Cursor, en .cursor/mcp.json:

{
  "mcpServers": {
    "letsrealty": {
      "url": "https://api.letsrealty.io/mcp",
      "headers": { "Authorization": "Bearer lr_live_…" }
    }
  }
}

Nunca disponible

El historial de navegación y las transcripciones del chat del sitio web nunca están disponibles por MCP ni por la API.