Casafari MCP in Claude, ChatGPT e Gemini: dati immobiliari reali nell'assistente IA
I server di Casafari MCP collegano assistenti IA come Claude, ChatGPT, Gemini CLI, Claude Code e Cursor al grafo immobiliare di CASAFARI, esteso a 16 paesi (Stati Uniti: ingresso in corso, Stati selezionati, solo immobili commerciali, con Claro AI) con un record unico per ogni immobile e la relativa cronologia dei prezzi. Ogni prodotto dispone di un server remoto dedicato accessibile tramite autorizzazione OAuth 2.1 dal browser. Il piano Free offre 1.000 token per 30 giorni senza inserire la carta di credito.
Un’agente immobiliare a Milano, nel quartiere Isola, chiede a Claude quanto vale al metro quadro un trilocale ristrutturato. Senza dati verificati, l’assistente risponde basandosi su stime generiche lette sul web. Quando si collega il connettore CASAFARI, la stessa richiesta attiva una sequenza precisa: le ricerche di località tramite Location Lookup, l’analisi di zona tramite Area Insights e il confronto puntuale con le valutazioni e studio di mercato con i comparabili. L’assistente restituisce valori storici, stock disponibile e giorni medi sul mercato, indicando la fonte e la data del rilievo.
Nel mercato immobiliare italiano, dove i dati provengono da portali differenti e da fonti frammentate, la credibilità dell’agente si gioca sulla precisione delle cifre presentate al proprietario o all’acquirente. Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti IA di interrogare direttamente strumenti esterni specializzati. CASAFARI mette a disposizione cinque server MCP: Location Lookup, Area Insights, Comparables, AgentGraph e Claro.
Cosa si può chiedere, in concreto
Ogni server MCP di CASAFARI risponde a un’esigenza specifica dell’agenzia o dell’analista:
- Location Lookup: individua il codice univoco di un quartiere o di un comune (ad esempio «trova l’id per la zona di Santo Stefano a Bologna»). Questa chiamata costa 0 token.
- Area Insights: fornisce il prezzo medio al metro quadro, lo stock attivo, i tempi medi di permanenza sul mercato e l’andamento dei prezzi di una zona residenziale.
- Comparables: trova immobili con caratteristiche simili attorno a un indirizzo o a una coordinata, mostrando la cronologia completa dei ribassi di prezzo e dei cambiamenti di stato.
- AgentGraph: individua, solo in Germania, le agenzie e gli agenti con cui vale la pena collaborare in una determinata zona, con profili completi, mappe territoriali e watchlist; è riservato alle aziende verificate.
- Claro: permette di analizzare i locali commerciali in Spagna e Germania, nonché i terreni commerciali esclusivamente in Germania. Questo strumento è pensato per i team di espansione delle catene e per i loro consulenti di site selection e non copre il territorio italiano; si veda la documentazione di Claro per locali e terreni commerciali (in inglese) per i dettagli di copertura.
La vera forza dell’integrazione risiede nella concatenazione automatica: l’assistente riconosce la località, ottiene l’identificativo di zona a 0 token e interroga gli altri server per comporre una risposta strutturata. Per approfondire gli schemi di interrogazione, sono disponibili gli esempi di richieste pronte da copiare (in inglese).
Come si svolge una sessione: da Bologna alla valutazione
Per comprendere la logica di lavoro, si può considerare un’analisi condotta sul quartiere Santo Stefano a Bologna:
- Richiesta dell’utente: l’agente scrive in chat una richiesta in italiano corrente per conoscere l’andamento del mercato locale e individuare immobili simili a un immobile in valutazione.
- Risoluzione della località: l’assistente richiama il server Location Lookup per trasformare «Bologna, Santo Stefano» in un location id univoco. Questa operazione consuma 0 token.
- Analisi di zona: con l’identificativo ottenuto, l’assistente interroga il server Area Insights per ricevere le metriche aggregate di prezzo al metro quadro, lo stock disponibile e la variazione percentuale recente.
- Ricerca dei comparabili: l’assistente consulta il server Comparables per estrarre la cronologia delle variazioni di prezzo di immobili analoghi nella stessa microzona.
- Sintesi operativa: il modello organizza i dati ricevuti dal grafo immobiliare CASAFARI (che aggrega i dati dei paesi coperti dai dati CASAFARI) e produce un report chiaro con fonti e date aggiornate a ottobre 2026.
Per gli sviluppatori che utilizzano ambienti come Cursor o Claude Code, l’esito delle interrogazioni viene restituito in formato JSON pronto per essere integrato in procedure automatiche o nei report dell’agenzia.
Come aggiungere il connettore in Claude, ChatGPT e Gemini CLI
Il collegamento dei server MCP avviene senza copiare chiavi API nei file di configurazione, seguendo la procedura prevista da ciascun client.
In Claude (claude.ai, Desktop e mobile)
Come descritto nella guida di Anthropic ai connettori personalizzati, l’aggiunta di un connettore remoto richiede pochi passaggi:
- Aprire Impostazioni > Connettori nell’interfaccia di Claude.
- Selezionare «Aggiungi connettore personalizzato».
- Inserire l’URL del server desiderato, ad esempio
https://platform.casafari.com/mcp/area-insights. - Premere Continua e completare la schermata di autorizzazione OAuth 2.1 nel browser con il proprio account CASAFARI.
Sui piani Claude Team ed Enterprise, l’attivazione dei connettori remoti viene gestita centralmente dal proprietario dell’organizzazione nelle impostazioni dell’account.
In ChatGPT (modalità sviluppatore)
Come annunciato da OpenAI a settembre 2025 per i connettori MCP personalizzati:
- Aprire Impostazioni > Connettori > Avanzate e attivare la modalità sviluppatore (Developer mode).
- Selezionare «Crea connettore» e inserire un nome e l’URL del server MCP (ad esempio
https://platform.casafari.com/mcp/comparables). - Selezionare l’autenticazione OAuth e salvare la configurazione.
- Nella finestra di chat, attivare il connettore dal menu degli strumenti e autorizzare l’accesso dal browser.
In Gemini CLI
Per la linea di comando di Gemini (aggiornata a ottobre 2026):
- Aggiungere il server con il comando:
gemini mcp add --transport http casafari-area-insights https://platform.casafari.com/mcp/area-insights - Avviare la sessione di
geminied eseguire il comando/mcp auth casafari-area-insightsper completare l’autenticazione OAuth nel browser. - Verificare i server attivi con il comando
/mcp list.
In Claude Code, Cursor, VS Code e altri client
Gli ambienti di sviluppo supportano i server HTTP remoti tramite comandi semplici o file di configurazione:
- Claude Code: eseguire
claude mcp add --transport http casafari-area-insights https://platform.casafari.com/mcp/area-insights. - Cursor: aggiungere la voce con URL HTTP all’interno del file
mcp.json. - VS Code: selezionare la voce «Add MCP server» e scegliere il trasporto HTTP.
I server MCP di CASAFARI sono compatibili anche con Codex CLI, Devin Desktop (ex Windsurf), Visual Studio, Zed, Cline, JetBrains Junie, Kiro, Warp e goose. L’elenco completo delle definizioni si trova su la guida di collegamento per ogni client su developers.casafari.com (in inglese). Il plugin per Claude Code con le sue skill, l’estensione per Gemini CLI e gli esempi di codice sono pubblicati nel repository GitHub casafari-mcp (in inglese).
Gli indirizzi dei cinque server remoti pubblicati da CASAFARI a ottobre 2026 sono:
https://platform.casafari.com/mcp/locations(Location Lookup)https://platform.casafari.com/mcp/area-insights(Area Insights)https://platform.casafari.com/mcp/comparables(Comparables)https://platform.casafari.com/mcp/agentgraph(AgentGraph)https://platform.casafari.com/mcp/claro(Claro)
Quanto costa: i token, il piano Free e il piano Agent
L’utilizzo dei server MCP si misura in token di consumo. Le ricerche di località effettuate con il server Location Lookup costano 0 token, permettendo di identificare quartieri e comuni senza intaccare il proprio saldo.
I piani di abbonamento disponibili a ottobre 2026 sono:
- Piano Free: include 1.000 token validi per 30 giorni. Si attiva automaticamente al primo accesso OAuth, senza richiedere la carta di credito.
- Piano Agent: costa 49 € al mese con fatturazione annuale oppure 70 € al mese con pagamento mensile (prezzi IVA esclusa).
- Piano Custom: destinato a strutture con volumi elevati o esigenze di integrazione dedicate, gestito a contratto.
Se si esauriscono i token previsti dal piano, è possibile acquistare crediti prepagati per coprire l’uso aggiuntivo. Tutte le informazioni sui consumi sono specificate su le domande frequenti su piani e token (in inglese). Per verificare il saldo aggiornato o modificare l’abbonamento, basta accedere su la piattaforma CASAFARI.
Sicurezza: OAuth 2.1 e strumenti di dati in sola lettura
La sicurezza dell’integrazione poggia sulla specifica di autorizzazione del Model Context Protocol della revisione 2025-11-25, che adotta lo standard OAuth 2.1 con PKCE obbligatorio per i server remoti basati su HTTP.
L’autenticazione avviene interamente nel browser dell’utente. L’assistente IA riceve esclusivamente un access token di autorizzazione e nessuna chiave API riservata viene salvata nel codice o nei file di configurazione locali.
Gli strumenti messi a disposizione dai server MCP di CASAFARI leggono il grafo immobiliare senza modificarlo; le uniche scritture sono quelle della watchlist dell’organizzazione in AgentGraph. L’assistente non ha la facoltà di modificare le impostazioni dell’account o creare avvisi. L’accesso può essere revocato in qualsiasi momento scollegando il connettore dal proprio client o dalla piattaforma.
Nelle organizzazioni strutturate si raccomanda di assegnare un account individuale a ogni operatore e di evitare l’inserimento di dati personali dei clienti nei prompt inviati al modello, garantendo la conformità alle normative sulla riservatezza.
Da dove cominciare oggi
Per testare i dati di mercato all’interno del proprio assistente IA:
- Aprire il client abituale (Claude, ChatGPT o la linea di comando).
- Aggiungere il server Area Insights inserendo l’URL
https://platform.casafari.com/mcp/area-insights. - Inviare una richiesta di prova su una zona di riferimento per analizzare la struttura della risposta.
Per esplorare ulteriori strategie di automazione nello studio immobiliare, si possono consultare i suggerimenti per usare ChatGPT in agenzia e scoprire come l’IA agentica cambia il lavoro in agenzia. Per progetti aziendali su misura o integrazioni avanzate esiste il piano Custom, da richiedere sulla piattaforma (come funzionano i piani, in inglese).
Domande frequenti
Cos’è Casafari MCP e con quali assistenti IA funziona?
Casafari MCP è l’insieme dei server Model Context Protocol di CASAFARI, pubblicati all’indirizzo https://platform.casafari.com/mcp/
Come collego CASAFARI a Claude o a ChatGPT?
In Claude occorre accedere a Impostazioni > Connettori, selezionare «Aggiungi connettore personalizzato», incollare l’URL del server e autorizzare l’accesso tramite OAuth dal browser. In ChatGPT basta attivare la modalità sviluppatore nelle impostazioni dei connettori, creare un connettore personalizzato con l’URL desiderato e completare la procedura di login. Non è necessario copiare alcuna chiave API e l’account viene creato al primo accesso con il piano Free.
Quanto costa usare Casafari MCP?
Il piano Free include 1.000 token per 30 giorni senza carta di credito. Il piano Agent prevede un costo di 49 € al mese con fatturazione annuale oppure 70 € al mese con fatturazione mensile (IVA esclusa), mentre il piano Custom è gestito a contratto. Le chiamate al server Location Lookup costano 0 token, consentendo di identificare qualsiasi comune o quartiere senza intaccare il saldo dei token.
Posso chiedere all’assistente IA il prezzo al metro quadro di una zona di Milano o Roma?
Sì, collegando il server Area Insights l’assistente risolve prima la località con Location Lookup a 0 token e poi restituisce i prezzi medi al metro quadro, lo stock attivo, i tempi medi sul mercato e l’andamento recente. Interrogando il server Comparables, l’assistente recupera anche gli immobili simili con la loro cronologia dei prezzi. Tutti i dati provengono direttamente dal grafo immobiliare CASAFARI e non da stime generiche del modello.
I dati e il mio account sono al sicuro quando uso l’IA con CASAFARI?
L’autenticazione è regolata dallo standard OAuth 2.1 con PKCE, pertanto nessuna chiave API viene condivisa con l’assistente o salvata in locale. Gli strumenti di dati dei server MCP leggono il grafo immobiliare senza modificarlo (solo gli strumenti watchlist di AgentGraph salvano o rimuovono voci nella watchlist dell’organizzazione) e non possono cambiare le impostazioni dell’account. Il collegamento può essere revocato in qualsiasi momento rimuovendo il connettore dal client.