Desarrolladores y agentes de IA
NidoRaíz ofrece un servidor MCP público para consultar inventario y solicitar visitas con consentimiento, una conexión MCP al CRM autorizada por OAuth y una API REST con endpoints públicos y autenticados. Disponer de un modelo de IA no le concede acceso al CRM: necesita un cliente compatible y la autorización correspondiente.
Servidor MCP público — sin registro
Añade https://mcp.nidoraiz.co a un cliente compatible con servidores MCP remotos. Esta superficie no pide credenciales y consulta el inventario publicado. Lee la moneda y la unidad de área indicadas en los resultados; no conviertas divisas implícitamente. Usa la URL devuelta y comprueba la canónica efectiva de la página antes de citarla: puede corresponder al sitio de la inmobiliaria.
Herramientas de consulta y cálculo: buscar_inmuebles, ver_inmueble, calcular_financiacion, evaluar_inversion y listar_proyectos. Los límites precioMin y precioMax de buscar_inmuebles se documentan en COP. Los cálculos de financiación e inversión son estimaciones ilustrativas, no ofertas de crédito ni garantías de rendimiento. Antes de responder conviene leer nido://catalogo/municipios y nido://catalogo/tipos-y-negocios para comprobar cobertura y filtros.
agendar_visita tiene un efecto de escritura: registra una solicitud y comparte los datos de contacto de la persona con la inmobiliaria responsable. Requiere su nombre, teléfono y consentimiento explícito para ese contacto. No confirma un horario de visita; la inmobiliaria lo coordina con la persona.
Configurar el catálogo público en Claude
Abre el formulario de conector personalizado con el nombre NidoRaíz y la URL https://mcp.nidoraiz.co/ ya completados. Claude puede pedirte iniciar sesión; revisa los datos y confirma antes de añadirlo. La disponibilidad depende de tu cuenta y de la configuración de tu organización.
El conector consulta el inventario público. Para acceder al CRM se utiliza la conexión OAuth descrita abajo. Solicitar una visita requiere el consentimiento explícito de la persona; la inmobiliaria coordina después el horario.
Operar el CRM — OAuth 2.1 con alcances
Una inmobiliaria puede conectar un cliente MCP compatible a su propia cuenta en https://mcp.nidoraiz.co/crm: OAuth 2.1 con PKCE, registro dinámico de clientes, pantalla de consentimiento y alcances separados para inventario, CRM, conversaciones y arriendos. Los alcances aprobados no sustituyen los permisos del usuario ni los módulos requeridos; leer conversaciones y enviar mensajes son autorizaciones distintas. Las escrituras pueden exigir confirmación o aprobación adicional según la operación y su configuración.
Las claves de API son credenciales distintas de la autorización OAuth. Se administran desde la cuenta, en la sección de documentación de API de la aplicación, con los alcances que correspondan a la integración.
API REST
La documentación Swagger describe los endpoints y su autenticación. Consultar un endpoint público no autoriza a operar datos privados; los endpoints del CRM requieren las credenciales y permisos documentados. Esta consulta de ejemplo usa el buscador público, sin autenticación:
curl -s "https://www.nidoraiz.co/api/public-api/properties/search?limit=3" \
-H "Accept: application/json"
Para agentes que leen el sitio
Las páginas públicas sirven JSON-LD (RealEstateListing en cada ficha, Organization en la portada). Las rutas inexistentes devuelven 404 de verdad, y las páginas principales tienen variante markdown por negociación de contenido (Accept: text/markdown).
- llms.txt — guía completa para asistentes de IA, con cuándo usar la plataforma
- Documentación Swagger de la API
- Sitemap XML
- Cómo verifica nuestra IA — qué se comprueba antes de que un asistente responda