La guida indipendente a SolidCraft

Collega SolidCraft a Claude con MCP.

Il server MCP integrato permette ai client IA compatibili di usare gli strumenti CAD locali di SolidCraft. Prepara qui la configurazione per Claude Code o Claude Desktop: una sessione headless separata oppure un collegamento all’app desktop aperta. Prima installa la CLI, poi applica il JSON sul tuo computer.

Fonti ufficiali verificate il 16 ottobre 2026

Ti servono: una CLI SolidCraft eseguibile dal client e il client Claude scelto. Per il collegamento desktop serve anche l’app desktop.

Installazione ufficiale

Crea la configurazione MCP

01 Scegli il client

Claude CodeNel terminaleClaude DesktopNell’app desktop

02 Scegli la modalità

HeadlessSessione separata, senza finestra.Collegamento desktopCollegati all’app desktop già in esecuzione.

03 Indica la CLI sul tuo computerPercorso dell’eseguibile CLI

Inserisci il nome dell’eseguibile presente nel PATH oppure un percorso assoluto senza virgolette. Con Snap, il comando CLI è solidcraft.cli. Trova il percorso per la tua installazione.

Generata localmente in questo browser.
I percorsi CLI e il JSON generato non vengono aggiunti agli eventi di analisi.

La tua configurazioneJSON

.mcp.jsonPronta da copiare

{
  "mcpServers": {
    "solidcraft": {
      "command": "solidcraft-cli",
      "args": [
        "mcp"
      ]
    }
  }
}

Il generatore prepara un file. L’installazione, l’integrazione con le impostazioni esistenti e la connessione MCP vanno completate sul tuo computer. Se il browser salva il file come mcp.json, rinominalo in .mcp.json prima di usarlo. Configura l’accesso alle cartelle prima del primo salvataggio o della prima esportazione.

Modifica un’impostazione per aggiornare l’anteprima.

Sul tuo computer

Applica la configurazione in Claude Code.

Salva il file come .mcp.json nella cartella principale del progetto. Se il browser rimuove il punto iniziale, rinomina mcp.json. Se sono già presenti altri server, aggiungi solo la voce solidcraft all’oggetto mcpServers esistente.
Apri Claude Code nel progetto. Esamina e approva il server MCP quando richiesto; riavvia la sessione se necessario.
Usa /mcp in Claude Code per controllare lo stato del server e gli strumenti disponibili. Se il server non parte, verifica l’installazione e il percorso della CLI.

In alternativa, registra il server headless dal terminale

claude mcp add solidcraft -- solidcraft-cli mcp

Scegli il file JSON di progetto oppure questo comando. Il comando usa l’ambito locale predefinito di Claude Code: non crea un file .mcp.json condiviso e non concede l’accesso alle cartelle. Consulta la guida all’accesso ai file prima di salvare o esportare un nuovo progetto in quella cartella.

Guida ufficiale: Claude Code configurazione

Quale percorso della CLI devo inserire?

Questi esempi si basano sui pacchetti ufficiali di v0.13.1. Verifica che il file esista nella tua installazione. Nel generatore inserisci solo il percorso della CLI; i comandi per avviare il desktop si eseguono separatamente nel terminale.

Windows: il percorso predefinito dell’installer è C:\Program Files\SolidCraft\solidcraft-cli.exe. Adattalo se hai scelto un’altra cartella o un archivio ZIP. L’eseguibile desktop nella stessa cartella si chiama solidcraft.exe.

macOS: con l’app in Applicazioni, la CLI si trova in /Applications/SolidCraft.app/Contents/MacOS/solidcraft-cli. Spostare l’app non aggiunge automaticamente la CLI al PATH. Per il controllo desktop, usa /Applications/SolidCraft.app/Contents/MacOS/SolidCraft --control 7878, adattando percorso e porta.

Linux nativo o archivio CLI: usa solidcraft-cli se il client lo trova nel PATH, altrimenti indica il percorso assoluto. Un launcher AppImage non configura da solo il comando CLI sul sistema.

Snap: inserisci solidcraft.cli come CLI; il desktop si avvia con solidcraft --control 7878.

Flatpak: /app/bin/solidcraft-cli è un percorso interno alla sandbox, non un eseguibile direttamente accessibile all’host. Usa una CLI nativa separata oppure un wrapper locale eseguibile che inoltri correttamente gli argomenti. Il collegamento al desktop Flatpak richiede anche accessi di rete e token adeguati. Segui le indicazioni ufficiali per pacchetto e MCP.

Fonti: pacchetto Windows, pacchetto macOS, pacchetto Flatpak.

SCEGLI LA MODALITÀ

Sessione separata o collegamento desktop?

In entrambi i casi il client avvia il server MCP sul tuo computer. Condizioni, costi e trattamento dei dati del client IA si applicano separatamente.

Headless

solidcraft-cli mcp

Una sessione di modellazione indipendente, senza finestra desktop. Puoi usarla quando non ti serve seguire il pezzo nella finestra dell’app.

Collegamento desktop

solidcraft-cli mcp --connect 127.0.0.1:7878

Inoltra gli strumenti all’app desktop in esecuzione con l’interfaccia di controllo attiva, così puoi seguire la costruzione sullo schermo.

Autorizza una cartella prima di salvare o esportare.

Una nuova sessione headless ha inizialmente accesso alla cartella di recupero e alla propria cartella temporanea. La directory corrente non è automaticamente autorizzata. Creare .mcp.json nel progetto non concede l’accesso ai file.

Crea una cartella dedicata al CAD. Nell’array args della configurazione salvata aggiungi due elementi distinti: --allow-path e il percorso assoluto. Esempio per la modalità headless:

{
  "args": [
    "mcp",
    "--allow-path",
    "/percorso/assoluto/ai/progetti"
  ]
}

L’esempio mostra solo args: conserva il resto del JSON e sostituisci il percorso con una cartella esistente. Su Windows le barre inverse vanno protette nel JSON, per esempio "C:\\Users\\nome\\Documents\\SolidCraft". Nel collegamento desktop mantieni mcp, --connect, host e porta, aggiungendo poi i due elementi.

Riavvia il server MCP dopo aver cambiato gli argomenti e prova salvataggio ed esportazione nella cartella. Il generatore non concede permessi automaticamente e non esamina il tuo filesystem.

Aprire un progetto esistente può rendere disponibile la sua cartella se si trova nella directory utente o temporanea e fuori dalle cartelle nascoste. Un’autorizzazione esplicita --allow-path include invece anche i file nascosti nella cartella. Usa una directory dedicata e consulta le regole ufficiali di accesso. Non risolvere un problema di cartella concedendo --allow-any-path.

Domande frequenti

Problemi con la configurazione MCP?

Il client non trova solidcraft-cli: cosa controllo?

Verifica che l’installazione includa una CLI. Un collegamento desktop non garantisce che sia nel PATH. Inserisci il percorso completo senza virgolette esterne e controlla gli esempi per Snap e Flatpak.

Il server è connesso ma non riesce a salvare.

Verifica che la cartella esista e sia autorizzata con --allow-path. Riavvia il server dopo la modifica degli argomenti. Segui la guida all’accesso ai file.

Il collegamento desktop non risponde.

Controlla che l’app sia aperta con l’interfaccia di controllo attiva e che host e porta coincidano. Un server MCP può partire prima del desktop, ma gli strumenti non funzionano finché l’app non è in ascolto.

Il generatore si connette al mio computer?

No. Prepara il testo della configurazione nel browser. Devi installare il software, integrare il file e verificare il server nel tuo client. I percorsi e il JSON non vengono aggiunti agli eventi di analisi.

Perché alcuni nomi del client restano in inglese?

Comandi, chiavi JSON, nomi di file e voci effettive del client restano invariati per permetterti di copiarli e riconoscerli. Le istruzioni spiegano in italiano cosa fare.

Consulta le fonti

Dalla documentazione ufficiale alla pratica.

Ultima verifica 16 ottobre 2026. Il software viene aggiornato. Confronta questi passaggi con la tua versione e con la documentazione ufficiale.

SolidCraft: CLI e MCP (in inglese)Guida ufficiale MCP per Claude Code Configurazione MCP per Claude Desktop