Vai al contenuto

Usare GHP DESIGN 3D con Claude (MCP)

Dalla versione rinnovata, GHP DESIGN 3D include GhpMcp, un componente che permette di usare il programma parlando in linguaggio naturale con Claude, l'assistente AI di Anthropic. Scrivi cosa vuoi — "apri il progetto, porta le sonde a 4 e ridimensiona" — e Claude apre il progetto, modifica i dati, lancia il calcolo ASHRAE e ti riporta i risultati. Il calcolo è sempre quello di GHP DESIGN 3D: l'AI fa solo da interfaccia, i numeri li produce il motore del programma.

Come funziona

MCP (Model Context Protocol) è lo standard con cui le app AI dialogano con i programmi. "Server MCP" non significa un server su internet: GhpMcp.exe è un normale programma sul tuo PC, installato insieme a GHP DESIGN 3D.

  1. Tu scrivi una richiesta nella chat di Claude.
  2. Claude avvia da solo GhpMcp.exe in background sul tuo computer e gli chiede le operazioni necessarie (aprire il progetto, cambiare i dati, calcolare…).
  3. GhpMcp esegue le operazioni in locale col motore di GHP DESIGN 3D e restituisce i risultati, che Claude ti riassume in chat.

I tuoi file di progetto non lasciano mai il tuo PC: verso internet viaggia solo la tua conversazione con Claude, come per qualunque altra domanda che gli fai.

Cosa ti serve

  • GHP DESIGN 3D installato (versione rinnovata: GhpMcp.exe è nella cartella del programma);
  • un'app Claude sul tuo PC, con un account Anthropic:

Collegare GHP DESIGN 3D a Claude (una volta sola)

Con il pulsante «Collega a Claude» (consigliato)

In GHP DESIGN 3D apri il tab Help e premi Collega a Claude: il programma rileva Claude Desktop, configura il collegamento con un click (per Claude Code trovi il comando già pronto da copiare) e ti dice quando è tutto a posto. Riavvia poi Claude Desktop e il gioco è fatto.

In alternativa puoi fare la stessa configurazione a mano:

Claude Desktop (manuale)

  1. Apri il file di configurazione %APPDATA%\Claude\claude_desktop_config.json (da Claude Desktop: Impostazioni → Sviluppatore → Modifica configurazione).
  2. Aggiungi il blocco ghpdesign3d (se mcpServers esiste già, aggiungi solo la voce interna):
{
  "mcpServers": {
    "ghpdesign3d": {
      "command": "C:\\Program Files\\Geostru\\GHP Design 3D\\GhpMcp.exe"
    }
  }
}
  1. Riavvia Claude Desktop: nell'icona degli strumenti della chat comparirà ghpdesign3d.

Claude Code

Da un terminale:

claude mcp add ghpdesign3d -- "C:\Program Files\Geostru\GHP Design 3D\GhpMcp.exe"

Poi apri una nuova sessione con claude e verifica con /mcp.

Nota — Se hai installato il programma in un percorso diverso, adatta il percorso di GhpMcp.exe di conseguenza.

Cosa puoi fare

Operazione Cosa fa Claude per te
Aprire un progetto carica un file .bdm (anche delle versioni precedenti)
Riepilogo ti racconta il progetto: terreno, stratigrafia, sonde, fabbisogni, risultati
Fabbisogni energetici imposta i valori mensili di riscaldamento, ACS e raffrescamento, potenze e COP/EER
Stratigrafia sostituisce gli strati del terreno (tipologia, profondità, conducibilità, capacità)
Posizionamento sonde numero e coordinate delle sonde, distanza, rapporto perforazioni
Esegui analisi dimensionamento col metodo ASHRAE: resistenze termiche e lunghezze delle sonde
Modello 3D dell'edificio genera un edificio parametrico (piani, pianta, facciata in vetro/intonaco/mattoni/cemento, tetto piano o a due falde) in formato OBJ, da caricare nella vista 3D con Carica modello 3D
Salvare scrive un .bdm che riapri normalmente in GHP DESIGN 3D

Esempi di richieste

Prova a scrivere a Claude frasi come queste:

  • «Apri il progetto C:\Progetti\villa_rossi.bdm e fammi un riepilogo.»
  • «Quanto sono lunghe le sonde con la configurazione attuale? E se le porto a 4 su una maglia di 8 metri?»
  • «Raddoppia i fabbisogni di riscaldamento dei mesi invernali e rilancia l'analisi: come cambiano le lunghezze?»
  • «Porta la stratigrafia a 100 metri aggiungendo calcare sotto i 75, con conducibilità 2,8 e capacità 2,25, e ridimensiona.»
  • «Confronta il dimensionamento con distanza sonde 6 e 10 metri e dimmi quale conviene.»
  • «Salva tutto come villa_rossi_variante2.bdm.»

Claude combina da solo le operazioni: in un'unica richiesta puoi chiedere modifica + calcolo + confronto tra varianti.

Limiti della versione attuale

  • Le modifiche guidate coprono fabbisogni, stratigrafia e posizionamento; gli altri dati (sonde, fluido, dati climatici, impianto) si impostano dall'applicazione — Claude li legge e li usa comunque nel calcolo.
  • La relazione di calcolo e gli elaborati grafici si generano dall'applicazione.
  • Serve un account Claude (Anthropic): GhpMcp è il ponte locale, non include l'abbonamento all'AI.

Suggerimento — Il flusso più comodo: imposti il progetto una volta nell'applicazione, poi usi Claude per le varianti rapide (e se ne salvi una, la riapri nel programma per relazione e tavole).