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), conAuthorization: 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_sincey texto.get_lead(leads:read) — Un Lead con sus consultas recientes y, conactivities: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,todayoweek.ingest_lead(leads:ingest) — Registra que alguien se puso en contacto, comoPOST /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); aclosed_lostnecesita unlost_reason, yotherunlost_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_codeyupdated_since, también las archivadas coninclude_archived, en un Idioma del Sitio conlang.get_property(properties:read) — Una propiedad, en un Idioma del Sitio conlang.find_matching_leads(leads:read) — Los Leads activos cuyos criterios guardados cumple una propiedad.create_property(properties:write) — Crea una propiedad, comoPOST /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, comoPOST /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, comoGET /v1/market/answer;placeacepta 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.