Model Context Protocol

Conecta HAVN con tu espacio de trabajo de IA.

HAVN MCP permite que ChatGPT, Claude, VS Code y otros clientes compatibles pidan contexto inmobiliario autorizado desde HAVN sin exponer una conexión directa a la base de datos.

Endpoint https://mcp.havnre.app/mcp
Pantalla móvil de Ajustes HAVN con acceso MCP y botón Create key

Paso 1

Crea tu clave HAVN MCP

  1. Abre HAVN en iPhone, iPad, Android o en la app web.
  2. Ve a Ajustes y busca MCP access.
  3. Toca Create key. HAVN muestra la clave completa solo una vez para revelarla y copiarla.
  4. Usa la clave como Bearer token con el endpoint HAVN MCP.

Paso 2

Conecta clientes de IA comunes

ChatGPT

Conectar como connector de ChatGPT

  1. Abre ChatGPT Settings y ve a Connectors.
  2. Activa Developer Mode mientras HAVN aún no esté listada como app pública oficial.
  3. Añade la URL del servidor MCP.
  4. Cuando ChatGPT abra la autorización de HAVN, pega tu clave HAVN MCP y aprueba.
Abrir ChatGPT Connectors
Claude

Conectar con Claude remote MCP

  1. Abre los ajustes de Claude para integraciones o conectores.
  2. Añade una integración personalizada que apunte al endpoint HAVN.
  3. Completa la autorización HAVN con tu clave MCP.
  4. Para Claude Code usa el comando HTTP de abajo.
claude mcp add --transport http havn https://mcp.havnre.app/mcp \
  --header "Authorization: Bearer YOUR_HAVN_MCP_API_KEY"
VS Code y GitHub Copilot

Añadir el servidor HTTP MCP

  1. Abre la configuración de servidores MCP en VS Code.
  2. Añade HAVN como servidor HTTP MCP.
  3. Configura el encabezado Authorization como Bearer YOUR_HAVN_MCP_API_KEY.
{
  "mcpServers": {
    "havn": {
      "type": "http",
      "url": "https://mcp.havnre.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_HAVN_MCP_API_KEY"
      }
    }
  }
}
Cursor, Windsurf y otros clientes

Usa el patrón remote MCP estándar

La mayoría de asistentes de código compatibles con MCP aceptan una URL MCP remota con encabezados o una configuración JSON mcpServers. Usa el mismo endpoint y Bearer token.

{
  "mcpServers": {
    "havn": {
      "type": "http",
      "url": "https://mcp.havnre.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_HAVN_MCP_API_KEY"
      }
    }
  }
}

Qué puede pedir la IA

Herramientas HAVN disponibles

workspace_summary

Un resumen compacto del workspace HAVN del usuario.

search_properties

Encuentra propiedades a las que el usuario puede acceder.

get_property_media

Obtiene enlaces de imágenes de propiedades y metadatos autorizados para páginas HTML, folletos y borradores de IA.

search_contacts

Busca contactos conectados con el rol o la agencia del usuario.

search_open_houses

Encuentra open houses y actividad de visitas.

search_leads

Busca leads para contexto de seguimiento.

search_tasks

Busca tareas accesibles con enlaces a propiedad, contacto, lead y open house.

search_seller_reports

Busca reportes para vendedores con contexto de propiedad, métricas y resumen de IA.

analytics_summary

Obtiene analítica autorizada de agencia, propiedades, conversión de leads y open houses.

search_files

Busca archivos cargados accesibles y devuelve URLs firmadas para adjuntos privados.

search_media

Busca fotos de propiedades, medios de contactos, avatares de agentes, iconos de agencia y assets de contact pass.

Modelo de seguridad

Acceso por rol, no inicio de sesión a base de datos

Cómo HAVN limita el acceso

  • Cada usuario recibe una clave MCP separada.
  • HAVN valida las claves antes de que una herramienta lea datos.
  • Los resultados se limitan al usuario y al rol de agencia guardado en HAVN.
  • Los medios de propiedades se devuelven solo para propiedades visibles para ese usuario.
  • Los adjuntos privados usan URLs firmadas de corta duración después de la verificación HAVN.
  • Las claves pueden rotarse o revocarse desde Ajustes.

Cómo manejar tu clave

  • Trata la clave como una contraseña.
  • No la pegues en chats públicos, tickets, capturas ni código fuente.
  • Rota la clave si un dispositivo o cuenta de IA se comparte.
  • Elimina conectores no usados en cada cliente de IA.

Docs de proveedores

Referencias oficiales