Model Context Protocol

Verbinden Sie HAVN mit Ihrem AI-Arbeitsbereich.

HAVN MCP ermöglicht ChatGPT, Claude, VS Code und anderen kompatiblen Clients, berechtigten Immobilienkontext aus HAVN anzufragen, ohne eine direkte Datenbankverbindung offenzulegen.

Endpoint https://mcp.havnre.app/mcp
HAVN Mobileinstellungen mit MCP-Zugriff und Create-key-Taste

Schritt 1

HAVN MCP-Schlüssel erstellen

  1. Öffnen Sie HAVN auf iPhone, iPad, Android oder in der Web-App.
  2. Gehen Sie zu Einstellungen und suchen Sie MCP access.
  3. Tippen Sie auf Create key. HAVN zeigt den vollständigen Schlüssel nur einmal an, damit Sie ihn einblenden und kopieren können.
  4. Verwenden Sie den Schlüssel als Bearer Token mit dem HAVN MCP Endpoint.

Schritt 2

Gängige AI-Clients verbinden

ChatGPT

Als ChatGPT Connector verbinden

  1. Öffnen Sie ChatGPT Settings und gehen Sie zu Connectors.
  2. Aktivieren Sie Developer Mode, solange HAVN noch nicht als offizielle öffentliche App gelistet ist.
  3. Fügen Sie die MCP-Server-URL hinzu.
  4. Wenn ChatGPT die HAVN-Autorisierung öffnet, fügen Sie Ihren HAVN MCP-Schlüssel ein und bestätigen Sie.
ChatGPT Connectors öffnen
Claude

Mit Claude Remote MCP verbinden

  1. Öffnen Sie die Claude-Einstellungen für Integrationen oder Connectors.
  2. Fügen Sie eine benutzerdefinierte Integration hinzu, die auf den HAVN Endpoint zeigt.
  3. Schließen Sie die HAVN-Autorisierung mit Ihrem MCP-Schlüssel ab.
  4. Für Claude Code verwenden Sie den HTTP-Befehl unten.
claude mcp add --transport http havn https://mcp.havnre.app/mcp \
  --header "Authorization: Bearer YOUR_HAVN_MCP_API_KEY"
VS Code und GitHub Copilot

HTTP MCP Server hinzufügen

  1. Öffnen Sie die MCP-Server-Konfiguration in VS Code.
  2. Fügen Sie HAVN als HTTP MCP Server hinzu.
  3. Setzen Sie den Authorization Header auf 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 und andere Clients

Standard Remote-MCP-Muster verwenden

Die meisten MCP-fähigen Coding-Assistenten akzeptieren entweder eine Remote-MCP-URL mit Headern oder eine JSON mcpServers-Konfiguration. Nutzen Sie denselben Endpoint und Bearer Token.

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

Was AI abfragen kann

Verfügbare HAVN Tools

workspace_summary

Eine kompakte Übersicht über den HAVN-Arbeitsbereich des Nutzers.

search_properties

Findet Immobilien, auf die der Nutzer zugreifen kann.

get_property_media

Ruft berechtigungsgeprüfte Immobilienbilder und Metadaten für HTML-Seiten, Broschüren und AI-Entwürfe ab.

search_contacts

Durchsucht Kontakte, die mit Nutzerrolle oder Agentur verbunden sind.

search_open_houses

Findet Open Houses und Besichtigungsaktivität.

search_leads

Durchsucht Leads für Nachfasskontext.

search_tasks

Durchsucht zugängliche Aufgaben mit Immobilien-, Kontakt-, Lead- und Open-House-Bezügen.

search_seller_reports

Durchsucht Verkäuferberichte mit Immobilienkontext, Kennzahlen und AI-Zusammenfassung.

analytics_summary

Ruft berechtigte Agentur-, Immobilien-, Lead-Konversions- und Open-House-Analysen ab.

search_files

Durchsucht zugängliche hochgeladene Dateien und liefert signierte URLs für private Anhänge.

search_media

Durchsucht Immobilienfotos, Kontaktmedien, Agenten-Avatare, Agentur-Icons und Contact-Pass-Assets.

Sicherheitsmodell

Rollenbasierter Zugriff, kein Datenbank-Login

Wie HAVN den Zugriff begrenzt

  • Jeder Nutzer erhält einen eigenen MCP-Schlüssel.
  • HAVN prüft Schlüssel, bevor ein Tool Daten liest.
  • Ergebnisse sind auf Nutzer und Agenturrolle in HAVN begrenzt.
  • Immobilienmedien werden nur für sichtbare Immobilien zurückgegeben.
  • Private Anhänge nutzen kurzlebige signierte URLs erst nach HAVN-Zugriffsprüfung.
  • Schlüssel können in Einstellungen rotiert oder widerrufen werden.

Umgang mit dem Schlüssel

  • Behandeln Sie den Schlüssel wie ein Passwort.
  • Fügen Sie ihn nicht in öffentliche Chats, Tickets, Screenshots oder Quellcode ein.
  • Rotieren Sie den Schlüssel, wenn ein Gerät oder AI-Konto geteilt wird.
  • Entfernen Sie nicht genutzte Connectors in jedem AI-Client.

Anbieter-Dokumentation

Offizielle Referenzen