Der unabhängige SolidCraft-Ratgeber

SolidCraft mit Claude per MCP verbinden.

Mit dem eingebauten MCP-Server können kompatible KI-Clients die lokalen Modellierungswerkzeuge von SolidCraft nutzen. Erstelle hier eine Konfiguration für Claude Code oder Claude Desktop: als Headless-Sitzung ohne Fenster oder als Verbindung zur laufenden Desktopanwendung. Installiere zuerst die CLI; die erzeugte JSON-Datei wendest du anschließend auf deinem Rechner an.

Offizielle Quellen geprüft am 16. Oktober 2026

Voraussetzungen: eine für deinen Client ausführbare SolidCraft-CLI und der gewählte Claude-Client. Für die Desktop-Verbindung brauchst du zusätzlich die Desktopanwendung.

Offizielle Installation

MCP-Konfiguration erstellen

01 Client auswählen

Claude CodeIm TerminalClaude DesktopIn der Desktopanwendung

02 Betriebsart wählen

HeadlessEigene Sitzung ohne Programmfenster.Desktop-VerbindungMit der laufenden Desktopanwendung verbinden.

03 Lokale CLI angebenPfad zur ausführbaren CLI-Datei

Gib den Programmnamen aus PATH oder einen absoluten Pfad ohne Anführungszeichen an. Bei Snap lautet der CLI-Befehl solidcraft.cli. Pfade für die verschiedenen Installationsarten

Wird lokal in diesem Browser erzeugt.
CLI-Pfade und erzeugtes JSON werden nicht an Analyseereignisse angehängt.

Deine KonfigurationJSON

.mcp.jsonBereit zum Kopieren

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

Hier entsteht eine Konfigurationsdatei. Installation, Zusammenführen mit bestehenden Einstellungen und MCP-Verbindung erfolgen anschließend auf deinem Rechner. Falls dein Browser die Datei als mcp.json speichert, benenne sie vor der Verwendung in .mcp.json um. Richte vor dem ersten Speichern oder Exportieren den Ordnerzugriff ein.

Ändere eine Einstellung, um die Vorschau zu aktualisieren.

Auf deinem Rechner

Konfiguration übernehmen in Claude Code.

Speichere die Datei als .mcp.json im Projektordner. Falls dein Browser den führenden Punkt entfernt, benenne mcp.json entsprechend um. Ergänze bei vorhandenen Servern nur den Eintrag solidcraft im bestehenden Objekt mcpServers.
Öffne Claude Code in diesem Projekt. Prüfe und bestätige den MCP-Server bei der entsprechenden Rückfrage. Starte die Sitzung bei Bedarf neu.
Mit /mcp prüfst du in Claude Code den Serverstatus und die verfügbaren Werkzeuge. Falls der Server nicht startet, kontrolliere zuerst Installation und CLI-Pfad.

Alternativ: Headless-Server per Terminal registrieren

claude mcp add solidcraft -- solidcraft-cli mcp

Wähle entweder die Projektdatei oder diesen Befehl. Der Befehl nutzt den lokalen Standardbereich von Claude Code. Er erstellt keine gemeinsame .mcp.json und erteilt keine Ordnerfreigabe. Beachte die Anleitung zum Ordnerzugriff bevor du dort erstmals speicherst oder exportierst.

Offizielle Claude Code Einrichtungsanleitung

Welchen CLI-Pfad muss ich eintragen?

Die folgenden Beispiele beruhen auf den offiziellen Paketdefinitionen von v0.13.1. Prüfe, ob die Datei in deiner Installation vorhanden ist. In den Konfigurator gehört nur der Pfad zur CLI; Startbefehle für das Desktopprogramm führst du separat im Terminal aus.

Windows: Beim Installationsprogramm liegt die CLI standardmäßig unter C:\Program Files\SolidCraft\solidcraft-cli.exe. Bei einem anderen Installationsordner oder einem portablen ZIP passt du den Pfad an. Das Desktopprogramm daneben heißt solidcraft.exe.

macOS: Bei Installation im Ordner Programme lautet der CLI-Pfad /Applications/SolidCraft.app/Contents/MacOS/solidcraft-cli. Das Verschieben der App fügt die CLI nicht automatisch zu PATH hinzu. Die Desktop-Steuerschnittstelle startest du mit /Applications/SolidCraft.app/Contents/MacOS/SolidCraft --control 7878. Passe bei Bedarf Pfad und Port an.

Native Linux-Pakete oder CLI-Archive: Nutze solidcraft-cli, wenn dein Client es in PATH findet, sonst den absoluten Pfad zur installierten oder entpackten CLI. Ein AppImage-Starter allein richtet keinen CLI-Befehl für den Host ein.

Snap: Trage als CLI solidcraft.cli ein. Die Desktop-Steuerschnittstelle startet weiterhin mit solidcraft --control 7878.

Flatpak: Der Pfad /app/bin/solidcraft-cli liegt innerhalb der Sandbox und ist kein ausführbarer Hostpfad. Nutze für diesen Konfigurator eine separate native CLI oder einen lokalen ausführbaren Wrapper, der die Flatpak-CLI mit ihren Argumenten startet. Eine Verbindung vom Host zur Flatpak-Desktopanwendung benötigt außerdem die passenden Netzwerk- und Tokenzugriffe. Beachte die offiziellen Paket- und MCP-Hinweise.

Quellen: Windows-Paket, macOS-Paket, Flatpak-Paket und Installationsanleitung.

DIE PASSENDE BETRIEBSART

Eigene Sitzung oder Desktop-Verbindung?

In beiden Fällen startet dein Client den MCP-Server lokal auf deinem Rechner. Für die Nutzung des KI-Clients gelten zusätzlich die Bedingungen und Datenpraktiken seines Anbieters.

Headless

solidcraft-cli mcp

Eine eigene Konstruktionssitzung ohne Desktopfenster. Geeignet, wenn du die Modellierung nicht im Programmfenster verfolgen möchtest.

Desktop-Verbindung

solidcraft-cli mcp --connect 127.0.0.1:7878

Leitet Werkzeuge an die laufende Desktopanwendung mit aktivierter Steuerschnittstelle weiter. So kannst du die Konstruktion im Fenster verfolgen.

Vor dem ersten Speichern einen Projektordner freigeben.

Eine neue Headless-Sitzung hat zunächst Zugriff auf den Wiederherstellungsordner und ihren eigenen temporären Arbeitsordner. Das aktuelle Arbeitsverzeichnis ist nicht automatisch freigegeben. Eine .mcp.json im Projektordner erteilt noch keine Dateiberechtigung.

Lege zuerst einen eigenen CAD-Ordner an. Ergänze in der gespeicherten Client-Konfiguration das args-Array des Servers um zwei getrennte Einträge: --allow-path und den absoluten Ordnerpfad. Für Headless sieht das Feld beispielsweise so aus:

{
  "args": [
    "mcp",
    "--allow-path",
    "/absoluter/pfad/zu/konstruktionen"
  ]
}

Das Beispiel zeigt nur das args-Feld. Behalte den Rest deiner erzeugten Konfiguration bei und ersetze den Beispielpfad durch einen vorhandenen Ordner. Unter Windows müssen Rückstriche in JSON maskiert werden, etwa "C:\\Users\\name\\Documents\\SolidCraft". Für die Desktop-Verbindung bleiben mcp, --connect sowie Host und Port erhalten; ergänze danach die beiden Einträge.

Starte den MCP-Server nach einer Änderung seiner Startargumente neu. Prüfe einen Speicher- und Exportvorgang im freigegebenen Ordner. Der Konfigurator erteilt diese Freigabe nicht automatisch und untersucht dein Dateisystem nicht.

Eine bereits geöffnete Konstruktion kann ihren Ordner ebenfalls verfügbar machen, wenn er innerhalb des Benutzer- oder temporären Ordners und außerhalb versteckter Ordner liegt. Ein ausdrückliches --allow-path umfasst dagegen auch versteckte Dateien im freigegebenen Ordner. Verwende deshalb einen eigenen Arbeitsordner, prüfe die Werkzeugfreigaben deines Clients und lies die offiziellen Zugriffsregeln. Löse Ordnerprobleme nicht mit --allow-any-path.

Häufige Fragen

Hilfe bei der MCP-Einrichtung

Warum findet mein Client solidcraft-cli nicht?

Prüfe zuerst, ob deine Installation eine CLI enthält. Ein Desktopshortcut garantiert nicht, dass die CLI in PATH liegt. Trage den vollständigen Pfad ohne umschließende Anführungszeichen ein. Beachte bei Snap und Flatpak die installationsabhängigen Beispiele.

Der Server ist verbunden, kann aber keine Dateien speichern.

Kontrolliere, ob der Zielordner existiert und freigegeben ist. Eine neue Headless-Sitzung erbt nicht automatisch Zugriff auf dein Projekt. Richte einen Ordner mit --allow-path ein und starte den Server neu. Zusätzlich gelten normale Dateirechte und Paket-Sandboxgrenzen.

Warum erreicht die Desktop-Verbindung keine Anwendung?

Starte die Desktopanwendung mit solidcraft --control PORT. Verwende im Client denselben lokalen Host und Port. Beide Prozesse müssen auf demselben Rechner laufen. Bei Sandboxpaketen kann zusätzlich der Zugriff auf das Kontrolltoken relevant sein.

Warum erscheint der MCP-Server nicht in Claude?

Prüfe gültiges JSON mit mcpServers, den CLI-Pfad und die gespeicherte Konfigurationsdatei. Lade deinen Client neu. In Claude Code kontrollierst du Projektfreigabe und Status über /mcp. Beende Claude Desktop vollständig, öffne es erneut und prüfe bei Bedarf die MCP-Protokolle.

Stellt diese Website eine Verbindung zu meinem Rechner her?

Der Konfigurator erzeugt Text und JSON lokal im Browser. Er startet keine lokalen Prozesse und greift nicht auf dein KI-Konto zu. Die Website verwendet Google Analytics für Besuchsstatistiken; CLI-Pfade, erzeugte Konfigurationen und Tokens werden nicht an Analyseereignisse angehängt.

Wie behalte ich vorhandene MCP-Server?

Übernimm nur den Eintrag solidcraft in das vorhandene mcpServers-Objekt. Sichere vorher deine Konfiguration und behalte andere Server und Einstellungen bei. Der Konfigurator liest oder verändert keine bestehenden Dateien.

Quellen zum Nachlesen

Die offizielle Dokumentation als Grundlage.

Zuletzt geprüft am 16. Oktober 2026. SolidCraft entwickelt sich weiter. Gleiche die Schritte mit deiner Version und der offiziellen Dokumentation ab.

SolidCraft: MCP-Befehle und Client-Beispiele SolidCraft: CLI installieren Offizielle Claude-Code-MCP-Dokumentation Offizielle MCP-Anleitung für Claude Desktop