Model Context Protocol

Connectez HAVN à votre espace de travail IA.

HAVN MCP permet à ChatGPT, Claude, VS Code et d'autres clients compatibles de demander un contexte immobilier autorisé depuis HAVN sans exposer de connexion directe à la base de données.

Endpoint https://mcp.havnre.app/mcp
Écran Paramètres mobile HAVN montrant l'accès MCP et le bouton Create key

Étape 1

Créer votre clé MCP HAVN

  1. Ouvrez HAVN sur iPhone, iPad, Android ou l'app web.
  2. Allez dans Paramètres et trouvez MCP access.
  3. Touchez Create key. HAVN affiche la clé complète une seule fois pour la révéler et la copier.
  4. Utilisez la clé comme Bearer token avec l'endpoint HAVN MCP.

Étape 2

Connecter les clients IA courants

ChatGPT

Connecter comme connector ChatGPT

  1. Ouvrez ChatGPT Settings et allez dans Connectors.
  2. Activez Developer Mode tant que HAVN n'est pas encore listée comme app publique officielle.
  3. Ajoutez l'URL du serveur MCP.
  4. Quand ChatGPT ouvre l'autorisation HAVN, collez votre clé MCP HAVN et approuvez.
Ouvrir ChatGPT Connectors
Claude

Connecter avec Claude remote MCP

  1. Ouvrez les paramètres Claude pour intégrations ou connecteurs.
  2. Ajoutez une intégration personnalisée pointant vers l'endpoint HAVN.
  3. Terminez l'autorisation HAVN avec votre clé MCP.
  4. Pour Claude Code, utilisez plutôt la commande HTTP ci-dessous.
claude mcp add --transport http havn https://mcp.havnre.app/mcp \
  --header "Authorization: Bearer YOUR_HAVN_MCP_API_KEY"
VS Code et GitHub Copilot

Ajouter le serveur HTTP MCP

  1. Ouvrez la configuration des serveurs MCP dans VS Code.
  2. Ajoutez HAVN comme serveur HTTP MCP.
  3. Définissez l'en-tête Authorization sur 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 et autres clients

Utiliser le schéma remote MCP standard

La plupart des assistants de code compatibles MCP acceptent soit une URL MCP distante avec en-têtes, soit une configuration JSON mcpServers. Utilisez le même endpoint et Bearer token.

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

Ce que l'IA peut demander

Outils HAVN disponibles

workspace_summary

Un aperçu compact de l'espace de travail HAVN de l'utilisateur.

search_properties

Trouve les biens auxquels l'utilisateur peut accéder.

get_property_media

Récupère les liens d'images de biens et métadonnées autorisés pour pages HTML, brochures et brouillons IA.

search_contacts

Recherche les contacts liés au rôle ou à l'agence de l'utilisateur.

search_open_houses

Trouve les visites ouvertes et l'activité de showing.

search_leads

Recherche les leads pour le contexte de suivi.

search_tasks

Recherche les tâches accessibles avec liens vers bien, contact, lead et visite ouverte.

search_seller_reports

Recherche les rapports vendeur avec contexte du bien, métriques et résumé IA.

analytics_summary

Récupère l'analytique autorisée d'agence, biens, conversion de leads et visites ouvertes.

search_files

Recherche les fichiers téléversés accessibles et renvoie des URL signées pour les pièces jointes privées.

search_media

Recherche photos de biens, médias de contacts, avatars d'agents, icônes d'agence et assets de contact pass.

Modèle de sécurité

Accès limité par rôle, pas une connexion base de données

Comment HAVN limite l'accès

  • Chaque utilisateur reçoit une clé MCP distincte.
  • HAVN valide les clés avant toute lecture de données.
  • Les résultats sont limités à l'utilisateur et au rôle d'agence stockés dans HAVN.
  • Les médias des biens ne sont retournés que pour les biens visibles par l'utilisateur.
  • Les pièces jointes privées utilisent des URL signées de courte durée après validation HAVN.
  • Les clés peuvent être renouvelées ou révoquées dans Paramètres.

Comment gérer votre clé

  • Traitez la clé comme un mot de passe.
  • Ne la collez pas dans des chats publics, tickets, captures ou code source.
  • Renouvelez la clé si un appareil ou compte IA est partagé.
  • Supprimez les connecteurs inutilisés dans chaque client IA.

Docs fournisseurs

Références officielles