SmartHome

SmartHome MCP — Documentación

Conecta Claude (u otro cliente compatible con Model Context Protocol) a la plataforma SmartHome para consultar y gestionar prospectos, clientes, ventas, inventario inmobiliario, mensajería y soporte usando lenguaje natural.

Cómo conectarse

Claude (individual, plan Pro o superior)

  1. En Claude, ve a Configuración > Conectores > Agregar conector personalizado.
  2. Pega la URL del conector que necesites (por ejemplo https://mcp.smart-home.com.co/mcp/smarthome).
  3. Claude abrirá la página de inicio de sesión: ingresa tu usuario y contraseña de SmartHome.
  4. Listo — las herramientas quedan disponibles en tus conversaciones.

Claude Team / Enterprise (toda la organización)

  1. Un Owner agrega la URL en Configuración de organización > Conectores > Agregar.
  2. Cada miembro conecta su propia cuenta al usarlo por primera vez; Claude solo accede a los datos que ese usuario puede ver en SmartHome.

Autenticación y seguridad

SmartHome CRM 28 herramientas

Gestión comercial de proyectos inmobiliarios: prospectos, clientes, ventas, pagos, eventos y campos personalizados.

URL del conector: https://mcp.smart-home.com.co/mcp/smarthome

HerramientaTipoDescripción
get_customer_detail
Detalle de cliente		LecturaObtiene el detalle completo de un cliente/prospecto.
get_customer_by_criteria
Buscar clientes		LecturaBusca clientes por nombre, documento o criterios específicos.
get_prospects
Consultar prospectos		LecturaConsulta paginada de prospectos y seguimientos comerciales. Permite filtrar por proyecto, fechas, probabilidad, etapa, vendedor o fuente de ubicación.
add_prospect
Registrar prospecto		EscrituraRegistra un nuevo prospecto en un proyecto y módulo específico.
change_customer_module
Cambiar módulo del cliente		EscrituraCambia a un cliente de módulo dentro del proyecto.
get_digitalProfile
Perfiles digitales		LecturaConsulta de perfiles del cliente digital. Obtiene el detalle de registros digitales y campos del perfil con paginación.
get_sales
Consultar ventas		LecturaObtiene el listado de ventas de un proyecto.
get_customer_overdue_payments
Pagos vencidos del cliente		LecturaConsulta pagos vencidos (mora) de un prospecto.
get_customer_scheduled_payments
Pagos programados del cliente		LecturaConsulta la programación de pagos futuros/agendados de un prospecto.
get_customer_payments
Pagos del cliente		LecturaObtiene el historial completo de pagos realizados por un prospecto.
get_prospect_history
Historial del prospecto		LecturaObtiene el historial general de un prospecto.
get_prospect_history_paged
Historial del prospecto (paginado)		LecturaConsulta paginada del historial de un prospecto filtrado por fechas.
get_prospect_events
Eventos del prospecto		LecturaObtiene la lista de eventos e interacciones vinculadas a un prospecto.
post_event
Registrar evento		EscrituraRegistra una nueva actividad o evento (comentario, llamada, visita).
post_calendar_event
Agendar evento de calendario		EscrituraAgenda un evento en el calendario para un prospecto.
get_projects
Consultar proyectos		LecturaLista todos los proyectos disponibles. Utiliza code del proyecto para los demás llamados.
get_units
Consultar unidades		LecturaObtiene las unidades (aptos/casas) de un proyecto.
get_sale_cycle
Ciclo de venta		LecturaObtiene las etapas del ciclo de venta configuradas.
get_users
Consultar usuarios		LecturaLista los usuarios/vendedores asignados al proyecto.
get_actions
Consultar acciones		LecturaObtiene el catálogo de acciones disponibles para la empresa.
get_custom_fields
Campos personalizados		LecturaObtiene la lista y estructura de campos personalizados definidos para la empresa.
set_prospect_custom_field
Actualizar campo personalizado		EscrituraActualiza o asigna campos personalizados a un prospecto específico mediante su ID.
get_project_summary
Resumen del proyecto		LecturaRetorna un resumen agregado de disponibilidad de unidades por proyecto.
get_bank_summary
Resumen bancario		LecturaRetorna un resumen agregado de las ventas, detalle de clientes, pagos y edades de mora.
change_prospect_stage
Cambiar etapa del prospecto		EscrituraActualiza la etapa comercial de un seguimiento.
change_prospect_user
Reasignar prospecto		EscrituraActualiza el asesor comercial asignado a un seguimiento.
update_prospect
Actualizar prospecto		EscrituraActualiza la información completa de un prospecto o seguimiento.
get_message_insight
Análisis de mensajes		LecturaRetorna análisis avanzado e insights semánticos de interacciones de chat.

SmartInbox 14 herramientas

Mensajería y seguimiento comercial: conversaciones, contactos, eventos, reuniones y registros digitales.

URL del conector: https://mcp.smart-home.com.co/mcp/smartinbox

HerramientaTipoDescripción
get_prospects
Consultar prospectos		LecturaObtiene detalles de prospectos con filtros avanzados (fechas, probabilidad, etapas, etc).
get_prospect_details
Detalle del prospecto		LecturaObtiene detalles de un prospecto específico por su ID.
get_message_contacts
Contactos de mensajería		LecturaObtiene contactos con actividad de mensajes en un rango de fechas.
get_sales
Consultar ventas		LecturaObtiene las ventas confirmadas (prospectos con probabilidad 100%).
get_projects
Consultar proyectos		LecturaObtiene el listado de los proyecto con sus codigos correspondientes (Project Code).
get_events
Consultar eventos		LecturaObtiene el listado de eventos de una empresa específica, permitiendo filtrar por rango de fechas y manejar paginación.
get_meetings
Consultar reuniones		LecturaObtiene el listado de reuniones programadas en un rango de fechas.
get_message_insight
Análisis de mensajes		LecturaRetorna un análisis avanzado e insights semánticos de las interacciones con los prospectos. Incluye resúmenes automáticos de IA, precisión del bot, preguntas sin responder, siguientes pasos y el historial estructurado de mensajes del chat (cliente vs asesor).
get_digital_records
Registros digitales		LecturaObtiene los registros digitales de la empresa en un rango de fechas determinado.
get_users
Consultar usuarios		LecturaObtiene el listado de usuarios o asesores registrados para la empresa.
get_actions
Consultar acciones		LecturaObtiene el catálogo de acciones disponibles para la empresa.
get_custom_fields
Campos personalizados		LecturaObtiene la lista y estructura de campos personalizados definidos para la empresa.
set_prospect_custom_field
Actualizar campo personalizado		EscrituraActualiza o asigna campos personalizados a un prospecto específico mediante su ID.
post_event
Registrar evento		EscrituraRegistra/crea un nuevo evento o nota asociada a un prospecto específico.

SmartInmobiliario 16 herramientas

Inventario inmobiliario: unidades, categorías, tipos, ubicaciones y ciclo de venta.

URL del conector: https://mcp.smart-home.com.co/mcp/inmobiliario

HerramientaTipoDescripción
get_units
Consultar unidades		LecturaObtiene el listado de unidades inmobiliarias con su detalle respectivo (disponibilidad, área, precios).
get_unit_detail
Detalle de unidad		LecturaObtiene la información técnica y comercial detallada de una unidad específica usando su código. (Estados: 1:Disponible, 2:Separado, 3:Vendido, 4:Reservado, etc.)
search_units_by_criteria
Buscar unidades		LecturaBusca unidades inmobiliarias aplicando filtros avanzados como precios, áreas, habitaciones, baños y ubicación específica. En el caso de no contar con algun campo, no enviarlo.
get_projects
Consultar proyectos		LecturaObtiene el listado de todos los proyectos inmobiliarios disponibles para la compañía.
get_unit_categories
Categorías de unidades		LecturaObtiene el listado de categorias y con los codigos respectivos. (Ej. Arriendo, Venta, Arriendo y Venta, etc)
get_unit_types
Tipos de unidades		LecturaObtiene el listado de tipos de unidades con los codigos respectivos. (Ej. Apartamento, Local, Oficinam, etc)
get_unit_location
Ubicación de unidades		LecturaObtiene el listado de ubicaciones, como pais, ciudad, barrio, localidad, de unidades con los codigos respectivos. (Ej. Bogota, Barrio Chico, etc)
get_prospect_detail_records
Registros del prospecto		LecturaObtiene el listado detallado de registros de prospectos incluyendo requerimientos del cliente, información del proyecto y paginación (total de registros y páginas).
add_prospect
Registrar prospecto		EscrituraRegistra un nuevo prospecto en un proyecto y módulo específico.
change_customer_module
Cambiar módulo del cliente		EscrituraCambia a un cliente de módulo dentro del proyecto.
get_sale_cycle
Ciclo de venta		LecturaObtiene las etapas del ciclo de venta configuradas.
get_prospect_history
Historial del prospecto		LecturaObtiene el historial general de un prospecto.
post_event
Registrar evento		EscrituraRegistra una nueva actividad o evento (comentario, llamada, visita).
post_calendar_event
Agendar evento de calendario		EscrituraAgenda un evento en el calendario para un prospecto.
change_prospect_stage
Cambiar etapa del prospecto		EscrituraActualiza la etapa comercial de un seguimiento.
change_prospect_user
Reasignar prospecto		EscrituraActualiza el asesor comercial de un seguimiento.

Tickets de Soporte 2 herramientas

Consulta de tickets de soporte técnico y documentación de la empresa.

URL del conector: https://mcp.smart-home.com.co/mcp/tickets

HerramientaTipoDescripción
get_tickets
Consultar tickets		LecturaObtiene el listado resumido de tickets de soporte técnico filtrado por un rango de fechas.
get_smartHome_getCompanyDocuments
Documentos de la empresa		LecturaObtiene los detalles de la empresa, con el listado de los documentos y codigos, para buscar en el GIT.