Usare Stratigrapher con Claude (MCP)¶

Dalla versione rinnovata, Stratigrapher include StratiMcp, un componente che permette di disegnare le colonne stratigrafiche parlando in linguaggio naturale con Claude, l'assistente AI di Anthropic. Scrivi cosa vuoi — "crea la stratigrafia del sondaggio S1: sabbia limosa fino a 3,9 m, poi argilla fino a 7,5, falda a 4,2" — e Claude compila intestazione, strati, campioni, prove SPT e falda, e salva un file che riapri in Stratigrapher per rifinire e stampare.

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: StratiMcp.exe è un normale programma sul tuo PC, installato insieme a Stratigrapher.

Tu scrivi una richiesta nella chat di Claude.
Claude avvia da solo StratiMcp.exe in background sul tuo computer e gli chiede le operazioni necessarie (creare il documento, inserire gli strati, salvare…).
StratiMcp esegue le operazioni in locale col motore di Stratigrapher e restituisce i risultati, che Claude ti riassume in chat.

I tuoi progetti 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¶

Stratigrapher installato (versione rinnovata: StratiMcp.exe è nella cartella del programma);
un'app Claude sul tuo PC, con un account Anthropic:
- Claude Desktop (l'app con la chat), oppure
- Claude Code (per chi lavora da terminale).

Collegare Stratigrapher a Claude (una volta sola)¶

Con il pulsante «Collega a Claude» (consigliato)¶

In Stratigrapher apri il tab ? (Help) e premi Collega a Claude: il programma rileva Claude Desktop e configura il collegamento con un click (per Claude Code trovi il comando già pronto da copiare). Riavvia poi Claude Desktop e il gioco è fatto.

In alternativa puoi fare la stessa configurazione a mano:

Claude Desktop (manuale)¶

Apri il file di configurazione %APPDATA%\Claude\claude_desktop_config.json (da Claude Desktop: Impostazioni → Sviluppatore → Modifica configurazione).
Aggiungi il blocco stratigrapher (se mcpServers esiste già, aggiungi solo la voce interna):

{
  "mcpServers": {
    "stratigrapher": {
      "command": "C:\\Program Files\\Geostru\\Stratigrapher\\StratiMcp.exe"
    }
  }
}

Riavvia Claude Desktop: nell'icona degli strumenti della chat comparirà stratigrapher.

Claude Code¶

Da un terminale:

claude mcp add stratigrapher -- "C:\Program Files\Geostru\Stratigrapher\StratiMcp.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 StratiMcp.exe di conseguenza.

Cosa puoi fare¶

Operazione	Cosa fa Claude per te
Nuovo documento	crea una stratigrafia vuota con intestazione (committente, cantiere, sondaggio, date, operatore…)
Aprire un documento	carica un file `.sthx` esistente e te lo riassume
Strati	inserisce gli strati con profondità, descrizione litologica e riempimento grafico: texture dall'archivio GeoStru (sabbia, argilla, ghiaia, calcare…) o colore
Campioni	aggiunge campioni (indisturbati, rimaneggiati…) nella colonna Campioni
Prove S.P.T.	aggiunge le prove in foro con quota e numeri di colpi
Falda	imposta le quote di falda
Stili	elenca i modelli di impaginazione disponibili e applica quello che preferisci
Litologie	elenca le litologie dell'archivio texture utilizzabili per gli strati
Salvare	scrive un `.sthx` che riapri normalmente in Stratigrapher

I comandi disponibili (tool MCP)¶

Per chi vuole sapere esattamente cosa espone il server: questi sono i 12 comandi («tool») che Claude puo' invocare. Non serve chiamarli per nome — basta descrivere cosa vuoi e Claude sceglie da solo — ma la tabella dice con precisione cosa e' automatizzabile.

Comando	Parametri principali	Cosa fa
`nuovo_documento`	intestazione opzionale (committente, cantiere, `sondaggio`, `quota_pc`, date, operatore)	crea una stratigrafia vuota, una pagina, stile di default
`apri_documento`	`percorso` (obbligatorio)	apre un `.sthx` esistente
`riepilogo_documento`	—	riassume il documento in memoria: intestazione, strati, campioni, SPT, falda
`imposta_intestazione`	solo i campi da cambiare	aggiorna i campi di intestazione della tavola
`imposta_strati`	`strati[]` con `profondita` (fondo strato, m) e `descrizione` obbligatorie; `litologia` oppure `colore_hex` per il riempimento	sostituisce la colonna stratigrafica; gli strati vengono ordinati per profondità
`aggiungi_campioni`	`campioni[]` con `da`/`a` (m) obbligatori; `tipo` (Indisturbato, Rimaneggiato, SPT…), `testo` (etichetta)	aggiunge campioni alla colonna Campioni
`aggiungi_spt`	`prove[]` con `quota` (m) obbligatoria; `colpi` (es. `5-8-12`), `punta` (`PA`/`PC`)	aggiunge prove S.P.T. in foro
`imposta_falda`	`quote[]` (m dal p.c., obbligatorio)	imposta le quote di falda (sostituisce le esistenti)
`elenca_litologie`	—	elenca le litologie dell'archivio texture (incoerenti, coesivi, rocce) per `imposta_strati`
`elenca_stili`	—	elenca i modelli di impaginazione `.stlx` della cartella Template
`imposta_stile`	`stile` (nome o percorso `.stlx`, obbligatorio)	applica un modello di impaginazione
`salva_documento`	`percorso` (obbligatorio, `.sthx`)	salva la stratigrafia su file

Note utili:

in imposta_strati la profondita e' il fondo dello strato in metri dal piano campagna; l'ordine di inserimento e' libero;
la litologia accetta il nome dell'archivio texture con match tollerante («sabbia», «argilla», «calcare»…): l'elenco esatto arriva da elenca_litologie;
in alternativa alla texture si puo' passare un colore pieno colore_hex (es. #D2B48C).

Esempi di richieste¶

Prova a scrivere a Claude frasi come queste:

«Crea la stratigrafia del sondaggio S1 per il committente Rossi, cantiere di Via Roma: sabbia limosa marrone fino a 3,9 m, argilla grigia compatta fino a 7,5, calcare fratturato fino a 12. Falda a 4,2 m.»
«Aggiungi un campione indisturbato tra 2 e 2,5 metri e una SPT a 3 metri con colpi 5-8-12.»
«Apri C:\Progetti\S3.sthx e dimmi che strati contiene.»
«Quali litologie hai in archivio per le rocce?»
«Salva tutto come S1_via_roma.sthx.»

Claude combina da solo le operazioni: in un'unica frase puoi descrivere l'intera colonna stratigrafica.

Limiti della versione attuale¶

Il server apre e salva il formato attuale .sthx; i vecchi .sth si convertono aprendoli e risalvandoli in Stratigrapher.
Le operazioni coprono intestazione, strati, campioni, SPT, falda e stili; pozzo, piezometri, casse catalogatrici, colonne utente, prove di laboratorio e documentazione fotografica si gestiscono dall'applicazione.
La stampa/esportazione della tavola si fa dall'applicazione.
Serve un account Claude (Anthropic): StratiMcp è il ponte locale, non include l'abbonamento all'AI.

Suggerimento — Il flusso più comodo: descrivi il sondaggio a Claude per ottenere la bozza completa in pochi secondi, poi apri il file in Stratigrapher per la rifinitura grafica e la stampa.