Passo 1
Crea la tua chiave HAVN MCP
- Apri HAVN su iPhone, iPad, Android o app web.
- Vai in Impostazioni e trova MCP access.
- Tocca Create key. HAVN mostra la chiave completa una sola volta per rivelarla e copiarla.
- Usa la chiave come Bearer token con l'endpoint HAVN MCP.
Passo 2
Collega i client IA comuni
Collega come connector ChatGPT
- Apri ChatGPT Settings e vai su Connectors.
- Attiva Developer Mode finché HAVN non è ancora elencata come app pubblica ufficiale.
- Aggiungi l'URL del server MCP.
- Quando ChatGPT apre l'autorizzazione HAVN, incolla la tua chiave MCP HAVN e approva.
Collega con Claude remote MCP
- Apri le impostazioni Claude per integrazioni o connettori.
- Aggiungi un'integrazione personalizzata che punta all'endpoint HAVN.
- Completa l'autorizzazione HAVN con la tua chiave MCP.
- Per Claude Code usa invece il comando HTTP qui sotto.
claude mcp add --transport http havn https://mcp.havnre.app/mcp \
--header "Authorization: Bearer YOUR_HAVN_MCP_API_KEY"Aggiungi il server HTTP MCP
- Apri la configurazione server MCP in VS Code.
- Aggiungi HAVN come server HTTP MCP.
- Imposta l'header Authorization su Bearer YOUR_HAVN_MCP_API_KEY.
{
"mcpServers": {
"havn": {
"type": "http",
"url": "https://mcp.havnre.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_HAVN_MCP_API_KEY"
}
}
}
}Usa lo schema remote MCP standard
La maggior parte degli assistenti di coding compatibili con MCP accetta un URL MCP remoto con header o una configurazione JSON mcpServers. Usa lo stesso endpoint e Bearer token.
{
"mcpServers": {
"havn": {
"type": "http",
"url": "https://mcp.havnre.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_HAVN_MCP_API_KEY"
}
}
}
}Cosa può chiedere l'IA
Strumenti HAVN disponibili
workspace_summary Una panoramica compatta del workspace HAVN dell'utente.
search_properties Trova le proprietà a cui l'utente può accedere.
get_property_media Recupera link immagini proprietà e metadati verificati per pagine HTML, brochure e bozze IA.
search_contacts Cerca contatti collegati al ruolo o all'agenzia dell'utente.
search_open_houses Trova open house e attività di visita.
search_leads Cerca lead per il contesto di follow-up.
search_tasks Cerca attività accessibili con collegamenti a proprietà, contatto, lead e open house.
search_seller_reports Cerca report venditore con contesto proprietà, metriche e riepilogo IA.
analytics_summary Recupera analytics autorizzate di agenzia, proprietà, conversione lead e open house.
search_files Cerca file caricati accessibili e restituisce URL firmati per allegati privati.
search_media Cerca foto proprietà, media contatti, avatar agenti, icone agenzia e asset contact pass.
Modello di sicurezza
Accesso limitato per ruolo, non login al database
Come HAVN limita l'accesso
- Ogni utente riceve una chiave MCP separata.
- HAVN valida le chiavi prima di qualsiasi lettura dati.
- I risultati sono limitati all'utente e al ruolo agenzia salvati in HAVN.
- I media delle proprietà sono restituiti solo per proprietà visibili a quell'utente.
- Gli allegati privati usano URL firmati di breve durata dopo la verifica HAVN.
- Le chiavi possono essere ruotate o revocate dalle Impostazioni.
Come gestire la chiave
- Tratta la chiave come una password.
- Non incollarla in chat pubbliche, ticket, screenshot o codice sorgente.
- Ruota la chiave se un dispositivo o account IA è condiviso.
- Rimuovi i connector inutilizzati in ogni client IA.
Legale e privacy
Termini importanti per l'accesso MCP
L'IA riceve tutto il mio database?
No. HAVN controlla chiave API, ruolo e accesso agenzia prima di restituire dati. Gli strumenti restituiscono risultati limitati.
Posso revocare l'accesso?
Sì. Apri Impostazioni in HAVN, revoca o ruota la chiave MCP, poi rimuovi il connector dal client IA.
La chiave API verrà mostrata di nuovo?
No. La chiave completa viene mostrata solo alla creazione. Poi HAVN conserva solo hash e breve prefisso.
MCP cambia il mio abbonamento HAVN?
No. MCP è un ponte di accesso. Può aumentare il normale uso dell'infrastruttura HAVN quando i client IA chiamano gli strumenti più spesso.
Collegando HAVN a un client IA autorizzi HAVN a inviare a quel client dati autorizzati di account, proprietà, contatti, visite, lead, attività, file, media, report e workspace quando chiedi di usare gli strumenti HAVN.
Il provider IA può elaborare quei dati secondo i propri termini, privacy policy e impostazioni workspace. Rivedi le policy HAVN e del provider prima di collegare dati cliente o agenzia di produzione.
Docs provider