Model Context Protocol

Prepojte HAVN s vaším AI pracoviskom.

HAVN MCP umožní ChatGPT, Claude, VS Code a ďalším kompatibilným klientom pýtať si oprávnený realitný kontext z HAVN bez priameho prístupu do databázy.

Endpoint https://mcp.havnre.app/mcp
Mobilná obrazovka HAVN Nastavenia s MCP prístupom a tlačidlom Create key

Krok 1

Vytvorte HAVN MCP kľúč

  1. Otvorte HAVN na iPhone, iPade, Androide alebo vo webovej appke.
  2. Prejdite do Nastavení a nájdite MCP access.
  3. Ťuknite na Create key. HAVN zobrazí celý kľúč iba raz, aby ste ho mohli odhaliť a skopírovať.
  4. Použite kľúč ako Bearer token s HAVN MCP endpointom.

Krok 2

Pripojte bežných AI klientov

ChatGPT

Pripojenie ako ChatGPT connector

  1. Otvorte ChatGPT Settings a prejdite do Connectors.
  2. Zapnite Developer Mode, kým HAVN ešte nie je oficiálne verejne uvedená appka.
  3. Pridajte URL MCP servera.
  4. Keď ChatGPT otvorí autorizáciu HAVN, vložte HAVN MCP kľúč a potvrďte.
Otvoriť ChatGPT Connectors
Claude

Pripojenie cez Claude remote MCP

  1. Otvorte nastavenia Claude pre integrácie alebo konektory.
  2. Pridajte vlastnú integráciu smerujúcu na HAVN endpoint.
  3. Dokončite autorizáciu HAVN pomocou MCP kľúča.
  4. Pre Claude Code použite HTTP príkaz nižšie.
claude mcp add --transport http havn https://mcp.havnre.app/mcp \
  --header "Authorization: Bearer YOUR_HAVN_MCP_API_KEY"
VS Code a GitHub Copilot

Pridajte HTTP MCP server

  1. Otvorte konfiguráciu MCP serverov vo VS Code.
  2. Pridajte HAVN ako HTTP MCP server.
  3. Nastavte Authorization header na 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 a ďalší klienti

Použite štandardný remote MCP vzor

Väčšina MCP klientov podporuje vzdialenú MCP URL s hlavičkami alebo JSON konfiguráciu mcpServers. Použite rovnaký endpoint a Bearer token.

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

Na čo sa môže AI pýtať

Dostupné HAVN nástroje

workspace_summary

Stručný prehľad používateľovho HAVN pracoviska.

search_properties

Vyhľadá nehnuteľnosti, ku ktorým má používateľ prístup.

get_property_media

Získa oprávnené odkazy na fotky nehnuteľností a metadáta pre HTML stránky, brožúry a AI návrhy.

search_contacts

Vyhľadá kontakty prepojené s používateľovou rolou alebo agentúrou.

search_open_houses

Vyhľadá obhliadky a aktivitu zo showingov.

search_leads

Vyhľadá leady pre kontext následnej práce.

search_tasks

Vyhľadá dostupné úlohy s väzbou na nehnuteľnosť, kontakt, lead a obhliadku.

search_seller_reports

Vyhľadá reporty pre predávajúcich s kontextom nehnuteľnosti, metrikami a AI súhrnom.

analytics_summary

Získa oprávnenú analytiku agentúry, nehnuteľností, konverzií leadov a obhliadok.

search_files

Vyhľadá dostupné nahrané súbory a vráti podpísané URL pre súkromné prílohy.

search_media

Vyhľadá fotky nehnuteľností, kontaktné médiá, avatary agentov, ikony agentúr a assety contact passov.

Bezpečnostný model

Prístup podľa roly, nie databázové prihlásenie

Ako HAVN obmedzuje prístup

  • Každý používateľ má samostatný MCP kľúč.
  • HAVN overí kľúč pred každým čítaním dát.
  • Výsledky sú obmedzené podľa používateľa a jeho roly v agentúre.
  • Médiá nehnuteľností sa vrátia iba pri nehnuteľnostiach, ku ktorým má používateľ prístup.
  • Súkromné prílohy používajú krátkodobé podpísané URL až po kontrole prístupu.
  • Kľúče je možné otočiť alebo zrušiť v Nastaveniach.

Ako narábať s kľúčom

  • Berte kľúč ako heslo.
  • Nevkladajte ho do verejných chatov, ticketov, screenshotov ani zdrojového kódu.
  • Otočte kľúč, ak je zariadenie alebo AI účet zdieľaný.
  • Odstráňte nepoužívané konektory v AI klientoch.

Dokumentácia poskytovateľov

Oficiálne odkazy