Cómo utilizar el Servidor MCP de AlterEstate

Resumen

AlterEstate ofrece un servidor MCP (Model Context Protocol) para conectar asistentes de IA con tu CRM. Una vez conectado, puedes pedirle a tu asistente que consulte y trabaje con datos de AlterEstate usando lenguaje natural, sin tener que navegar manualmente por el dashboard.

Puedes usarlo para buscar propiedades, crear contactos, crear o modificar negocios, registrar actividades, crear recordatorios, armar propuestas, consultar reportes, revisar estadísticas de agentes y más.

Un flujo típico se ve así:

1. Conectar: Autoriza tu asistente de IA con tu cuenta de AlterEstate.
2. Descubrir: Pregunta por contactos, propiedades, negocios, reportes o herramientas disponibles.
3. Actuar: Crea registros, actualiza negocios, agrega notas, asigna agentes o arma propuestas.
4. Iterar: Continúa refinando la solicitud en la misma conversación.

URL del servidor MCP

Usa este endpoint para conectar tu asistente:

Si tu empresa usa un subdominio dedicado para MCP, tu administrador puede darte una URL alternativa como:

https://mcp.alterestate.com/alterai/

Permisos y acceso

Cada usuario se autentica con sus propias credenciales de AlterEstate. El servidor MCP ejecuta las acciones como ese usuario, por lo que el acceso depende de su compañía, rol y permisos dentro del CRM.

El asistente puede ejecutar acciones de lectura y escritura. Por ejemplo, puede buscar inventario, pero también puede crear contactos, negocios, recordatorios, propuestas y propiedades.

Conecta AlterEstate MCP únicamente con clientes de IA en los que confíes, especialmente si tu CRM contiene datos personales, teléfonos, correos, requerimientos de clientes, notas privadas o inventario confidencial.

Herramientas disponibles

Cómo conectarlo

Claude

1. Abre la configuración de Claude.
2. Ve a Connectors.
3. Agrega un conector personalizado.
4. Usa la URL del servidor MCP:

https://secure.alterestate.com/api/v1/alterai/mcp/

1. Completa el login de AlterEstate.
2. Autoriza el acceso para que Claude pueda usar las herramientas del CRM en tu nombre.

Cursor

1. Ve a Settings -> Tools & MCP -> New MCP Server.
2. Agrega esta configuración en ~/.cursor/mcp.json   :

{
  "mcpServers": {
    "alterestate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://secure.alterestate.com/api/v1/alterai/mcp/"
      ]
    }
  }
}

1. Guarda el archivo.
2. Cursor te pedirá autenticarte con AlterEstate la primera vez que se conecte.

Codex CLI

Agrega el servidor MCP en ~/.codex/config.toml   :

[mcp_servers.alterestate]
url = "https://secure.alterestate.com/api/v1/alterai/mcp/"

Luego autoriza la conexión:

codex mcp login alterestate

Gemini CLI

Puedes agregarlo con:

gemini mcp add alterestate npx -y mcp-remote https://secure.alterestate.com/api/v1/alterai/mcp/

O editar manualmente tu configuración:

{
  "mcpServers": {
    "alterestate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://secure.alterestate.com/api/v1/alterai/mcp/"
      ]
    }
  }
}

Otros clientes compatibles con MCP

Si tu cliente permite configuración JSON, puedes usar el mismo patrón:

{
  "mcpServers": {
    "alterestate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://secure.alterestate.com/api/v1/alterai/mcp/"
      ]
    }
  }
}

Ejemplos de preguntas

Una vez conectado, prueba con preguntas como estas:

Entender tu CRM

• "Qué puedes hacer en AlterEstate?"
• "Muéstrame mis estadísticas de este mes."
• "Cuántos negocios gané esta semana?"
• "Dame un resumen de mi pipeline activo."

Trabajar con contactos y negocios

• "Crea un contacto llamado María Pérez con teléfono 829-555-1234."
• "Crea un negocio para Juan que busca un apartamento de 3 habitaciones en Piantini hasta USD 350,000."
• "Actualiza el negocio de María Pérez: sube el presupuesto a USD 420,000 y agrega gimnasio y piscina."
• "Asigna el negocio DEAL_UID    a Carlos Rodríguez."

Buscar propiedades

• "Busca apartamentos en venta en Naco entre USD 200,000 y USD 350,000 con al menos 2 habitaciones."
• "Busca propiedades que encajen con los requerimientos del negocio DEAL_UID   ."
• "Muéstrame las mejores 5 opciones de alquiler en Punta Cana por debajo de USD 2,000."
• "Dame más información de la propiedad con código PROPERTY_CODE   ."

Crear propuestas

• "Crea una propuesta para el negocio DEAL_UID    con estas propiedades: Torre Azul, Vista Cana 302 y Naco Loft."
• "Agrega estas dos propiedades a la propuesta PROPOSAL_SLUG   ."

Dar seguimiento a clientes

• "Agrega una nota al último negocio: el cliente prefiere visitas en la mañana y quiere opciones con financiamiento."
• "Crea un recordatorio para llamar a María mañana a las 10am."
• "Registra una reunión para el negocio DEAL_UID   : al cliente le gustó la opción 2 pero quiere menor mantenimiento."

Analizar rendimiento

• "Cómo van mis agentes este mes?"
• "Muéstrame leads por etapa esta semana."
• "Qué Round Robin generó mejor tasa de seguimiento?"
• "Genera un resumen del Round Robin llamado Facebook Leads Santo Domingo."

Mejorar contenido de propiedades

• "Crea una propiedad para un apartamento de 2 habitaciones en Bella Vista por USD 180,000."
• "Actualiza la descripción de la propiedad PROPERTY_UID    para hacerla más atractiva para inversionistas."
• "Estima el precio de mercado para apartamentos de 2 habitaciones en Piantini."

Consideraciones de seguridad

Cuando conectas AlterEstate MCP, el asistente puede acceder a datos del CRM y ejecutar acciones usando tu cuenta.

Controles de acceso:

• Cada usuario debe autenticarse con sus credenciales de AlterEstate.
• Las acciones se ejecutan como el usuario autenticado.
• El acceso debe respetar la compañía, rol y permisos del usuario.
• OAuth usa el scope mcp   .
• El registro dinámico de clientes solo acepta URLs de redirección confiables.

Consideraciones de datos:

• Tus prompts y resultados del CRM pueden ser enviados al proveedor de IA que estés usando, como Claude, Cursor, Codex, Gemini u otro cliente compatible con MCP.
• Evita compartir información altamente sensible de clientes si tu empresa no ha aprobado ese proveedor de IA.
• Si usas un workspace compartido, otros administradores podrían tener acceso al historial de conversaciones según las políticas del proveedor.
• Revisa tus obligaciones de privacidad, incluyendo GDPR, CCPA o regulación local, antes de conectar datos de producción.

OAuth para integraciones personalizadas

AlterEstate MCP soporta OAuth discovery para clientes compatibles con MCP.

Protected Resource Metadata

Usa este endpoint para descubrir el recurso MCP protegido:

https://secure.alterestate.com/.well-known/oauth-protected-resource

Authorization Server Metadata

Usa este endpoint para descubrir los endpoints de autorización, token y registro:

https://secure.alterestate.com/.well-known/oauth-authorization-server

Endpoints OAuth

Flujo OAuth

AlterEstate MCP usa Authorization Code con PKCE:

• Grant types: authorization_code   , refresh_token   
• Response type: code   
• Code challenge method: S256   
• Token endpoint auth methods: none   , client_secret_post   
• Scope requerido: mcp   

Solución de problemas

• El cliente dice que el servidor MCP no está autorizado: Asegúrate de completar el login y autorización de AlterEstate.
• La autorización falla después de cambiar la configuración: Reinicia el cliente MCP y autentícate otra vez.
• El asistente no ve la data esperada del CRM: Confirma que iniciaste sesión con el usuario y compañía correctos.
• El asistente dice que una herramienta no está disponible: Pide al cliente refrescar las herramientas MCP o reinicia la aplicación.
• El login falla repetidamente: Verifica tus credenciales y que tu usuario esté activo.
• El registro dinámico falla: El cliente MCP puede estar usando una URL de redirección no permitida.
• La app de escritorio no detecta cambios en la configuración: Guarda el archivo de configuración y reinicia la app.

Límites de uso

Los endpoints de OAuth tienen protección contra abuso:

• Intentos de login limitados por IP.
• Registros dinámicos de clientes limitados por IP.

Usa MCP de forma responsable. Si planeas ejecutar flujos automatizados de alto volumen contra datos de producción, revisa el caso con AlterEstate antes de activarlo.