Le guide indépendant de SolidCraft

Connectez SolidCraft à Claude avec MCP.

Le serveur MCP intégré donne à un client IA compatible accès aux outils CAO locaux. Préparez ici le JSON pour Claude Code ou Claude Desktop : session headless indépendante ou connexion à l’application de bureau. Installez d’abord la CLI, puis appliquez la configuration sur votre ordinateur.

Sources officielles vérifiées le 16 octobre 2026

Prérequis : une CLI SolidCraft que le client peut exécuter et le client Claude choisi. Pour la connexion au bureau, il faut aussi l’application de bureau.

Installation officielle

Générateur de configuration MCP

01 Choisissez votre client

Claude CodeDans le terminalClaude DesktopDans l’application de bureau

02 Choisissez le mode

HeadlessUne session distincte, sans fenêtre.Connexion à l’application de bureauUtilisez l’application de bureau déjà ouverte.

03 Indiquez votre CLI localeChemin de l’exécutable CLI

Saisissez le nom de l’exécutable disponible dans le PATH, ou son chemin absolu sans guillemets. Avec Snap, la CLI se lance avec solidcraft.cli. Trouver le chemin correspondant à votre installation.

Configuration générée dans ce navigateur.
Les chemins de la CLI et le JSON généré ne sont pas ajoutés aux événements de mesure.

Votre configurationJSON

.mcp.jsonPrête à copier

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

Ce générateur prépare un fichier. L’installation, la fusion avec vos réglages et la connexion MCP se font sur votre ordinateur. Si le navigateur enregistre mcp.json, renommez-le en .mcp.json avant utilisation. Configurez l’accès aux dossiers avant le premier enregistrement ou export.

Modifiez un paramètre pour actualiser l’aperçu.

Sur votre ordinateur

Appliquer la configuration dans Claude Code.

Enregistrez le fichier sous .mcp.json à la racine du projet. Si le navigateur retire le point initial, renommez mcp.json. Si d’autres serveurs sont déjà configurés, ajoutez seulement l’entrée solidcraft à l’objet mcpServers existant.
Ouvrez Claude Code dans ce projet. Examinez et approuvez le serveur MCP à l’invite ; relancez la session si nécessaire.
Utilisez /mcp dans Claude Code pour vérifier le serveur et ses outils. S’il ne démarre pas, contrôlez l’installation et le chemin de la CLI.

Ou enregistrez le serveur headless par défaut dans le terminal

claude mcp add solidcraft -- solidcraft-cli mcp

Choisissez le fichier JSON du projet ou cette commande. Celle-ci utilise la portée locale par défaut de Claude Code : elle ne crée pas de .mcp.json partagé et n’accorde pas l’accès au dossier. Consultez la configuration de l’accès aux fichiers avant d’y enregistrer ou exporter un nouveau modèle.

Guide officiel de configuration pour Claude Code

Quel chemin de CLI renseigner ?

Ces exemples se fondent sur les paquets officiels de v0.13.1. Vérifiez que le fichier existe chez vous. Le générateur attend uniquement le chemin de la CLI ; les commandes de démarrage de l’application se lancent séparément dans votre terminal.

Windows : l’installateur utilise par défaut C:\Program Files\SolidCraft\solidcraft-cli.exe. Adaptez-le si vous avez choisi un autre dossier ou un ZIP. L’application de bureau s’appelle solidcraft.exe.

macOS : si l’application est dans Applications, utilisez /Applications/SolidCraft.app/Contents/MacOS/solidcraft-cli. Déplacer l’application n’ajoute pas la CLI au PATH. Pour le contrôle de bureau : /Applications/SolidCraft.app/Contents/MacOS/SolidCraft --control 7878, en adaptant le chemin et le port.

Linux natif ou archive CLI : utilisez solidcraft-cli si votre client le trouve dans le PATH, sinon son chemin absolu. Un lanceur AppImage ne configure pas automatiquement une CLI sur le système.

Snap : renseignez solidcraft.cli. L’application de bureau se lance avec solidcraft --control 7878.

Flatpak : /app/bin/solidcraft-cli est interne à la sandbox ; ce n’est pas un chemin exécutable directement depuis l’hôte. Utilisez une CLI native distincte ou un script local exécutable qui transmet correctement les arguments. La connexion au bureau Flatpak demande aussi les accès réseau et les jetons adaptés. Suivez les instructions officielles.

Sources : paquet Windows, paquet macOS, paquet Flatpak.

CHOISIR LE MODE

Une session séparée ou l’application à l’écran ?

Le client lance le serveur MCP sur votre ordinateur. Ses propres conditions, frais et règles de traitement des données s’appliquent séparément.

Headless : sans fenêtre

solidcraft-cli mcp

Une session de modélisation indépendante. Utile lorsque vous n’avez pas besoin de suivre la pièce dans l’application de bureau.

Connexion à l’application de bureau

solidcraft-cli mcp --connect 127.0.0.1:7878

Les outils pilotent l’application ouverte avec son interface de contrôle active. Vous suivez ainsi la construction à l’écran.

Autorisez un dossier avant d’enregistrer ou d’exporter.

Une nouvelle session headless a accès à son dossier de récupération et à son dossier temporaire. Le répertoire courant n’est pas autorisé automatiquement. Créer un .mcp.json dans le projet ne donne pas l’accès aux fichiers.

Créez un dossier dédié à la CAO. Dans le tableau args du JSON enregistré, ajoutez deux éléments distincts : --allow-path et le chemin absolu. Exemple en mode headless :

{
  "args": [
    "mcp",
    "--allow-path",
    "/chemin/absolu/vers/mes-projets"
  ]
}

Conservez le reste du JSON et remplacez ce chemin par un dossier existant. Sous Windows, échappez les barres obliques inverses, par exemple "C:\\Users\\nom\\Documents\\SolidCraft". En connexion au bureau, gardez mcp, --connect, l’adresse et le port, puis ajoutez les deux éléments.

Redémarrez le serveur MCP, puis essayez un enregistrement et un export dans ce dossier. Le générateur n’examine pas vos fichiers et n’accorde pas de permission automatiquement.

Ouvrir un projet existant peut rendre son dossier accessible s’il est dans le répertoire utilisateur ou temporaire et hors des dossiers cachés. Une autorisation explicite --allow-path inclut les fichiers cachés du dossier. Utilisez un dossier dédié et consultez les règles d’accès officielles. Évitez d’élargir l’accès avec --allow-any-path pour résoudre un simple problème de dossier.

Questions fréquentes

Besoin d’aide avec MCP ?

Le client ne trouve pas solidcraft-cli.

Vérifiez que le paquet contient la CLI. Un raccourci de bureau ne garantit pas sa présence dans le PATH. Saisissez son chemin complet sans guillemets extérieurs et consultez les cas Snap et Flatpak.

Le serveur est connecté, mais l’enregistrement échoue.

Vérifiez que le dossier existe et figure dans les arguments --allow-path. Redémarrez le serveur après modification. Consultez les permissions des fichiers.

La connexion à l’application de bureau ne répond pas.

L’application doit être ouverte avec l’interface de contrôle active, sur la même adresse et le même port. Le serveur MCP peut démarrer avant elle ; les outils attendront qu’elle écoute.

Ce générateur se connecte-t-il à mon ordinateur ?

Il prépare le texte dans le navigateur. Vous installez le logiciel, intégrez le JSON et vérifiez le serveur depuis votre client. Les chemins et le JSON ne sont pas ajoutés aux événements de mesure du site.

Pourquoi conserver certains mots en anglais ?

Les commandes, clés JSON, noms de fichiers et libellés réels du client restent tels quels pour être copiés et retrouvés. Les consignes expliquent leur usage en français.

Consulter les sources

Des explications fondées sur la documentation officielle.

Dernière vérification 16 octobre 2026. Le logiciel évolue. Comparez ces étapes avec votre version et la documentation officielle avant de commencer.

CLI et MCP de SolidCraft (en anglais)MCP dans Claude Code MCP dans Claude Desktop