[{"data":1,"prerenderedAt":1176},["ShallowReactive",2],{"post-how-to-use-freecad-opencode-mcp-de":3,"related-posts-how-to-use-freecad-opencode-mcp-de":1166,"related-categories-how-to-use-freecad-opencode-mcp-de":1175},{"id":4,"title":5,"author":6,"authorImageUrl":7,"authorUrl":8,"body":9,"categorySlug":1133,"categoryText":1134,"dateModified":1135,"datePublished":1135,"description":1136,"extension":1137,"faqs":1138,"image":1154,"language":1155,"meta":1156,"navigation":1157,"path":1158,"seo":1159,"sitemap":1160,"stem":1161,"tags":1162,"__hash__":1165},"blog\u002Fde\u002Fblog\u002Fhow-to-use-freecad-opencode-mcp.md","FreeCAD mit OpenCode und MCP verwenden","Bruma","\u002Fimages\u002Fauthors\u002Fbruma.jpg","https:\u002F\u002Fbrumaombra.com",{"type":10,"value":11,"toc":1110},"minimark",[12,17,32,35,38,41,44,55,58,61,65,68,72,83,88,91,97,104,109,112,115,118,122,128,133,141,144,147,150,153,156,160,175,184,187,191,194,196,200,203,206,232,238,252,255,263,266,268,272,286,289,295,305,312,318,321,327,330,335,342,345,349,363,369,385,396,398,402,405,411,417,441,444,463,474,486,492,510,512,516,527,530,536,539,553,714,728,730,734,750,753,762,786,794,800,803,812,814,818,821,827,842,849,853,856,858,862,865,868,874,893,897,900,906,917,920,926,929,931,935,948,951,957,960,966,969,976,978,982,985,988,1005,1015,1017,1021,1028,1031,1034,1037,1039,1043,1056,1059,1062,1075,1078,1084,1097,1103,1106],[13,14,16],"h2",{"id":15},"einleitung","Einleitung",[18,19,20,31],"p",{},[21,22,27],"a",{"href":23,"rel":24,"target":26},"https:\u002F\u002Fwww.freecad.org\u002F",[25],"nofollow","_blank",[28,29,30],"strong",{},"FreeCAD"," ist zweifellos eine der leistungsfähigsten parametrischen CAD-Anwendungen überhaupt. Trotzdem kann es viel wiederholte Arbeit, die Suche nach Funktionen im Internet und eine ganze Menge Rückgängig-Schritte erfordern, ein Modell damit von Grund auf zu erstellen ... sehr viele davon!",[18,33,34],{},"Du wählst eine Arbeitsumgebung aus, erstellst ein Dokument, fügst Skizzen hinzu, setzt Constraints, erstellst Features, prüfst den Baum und wiederholst den Vorgang, bis das Ergebnis stimmt. Ein bisschen umständlich, oder?",[18,36,37],{},"Aber was wäre, wenn du das gewünschte Bauteil beschreiben und einen Coding-Agenten bitten könntest, es direkt in FreeCAD zu erstellen – ganz ähnlich wie beim Programmieren?",[18,39,40],{},"Das wäre ziemlich cool, findest du nicht?",[18,42,43],{},"Dann bist du hier genau richtig, denn genau das werden wir in dieser Anleitung erklären.",[18,45,46,47,54],{},"Das ist die Idee hinter dem ",[21,48,51],{"href":49,"rel":50,"target":26},"https:\u002F\u002Fgithub.com\u002Fneka-nat\u002Ffreecad-mcp",[25],[28,52,53],{},"FreeCAD-MCP-Server",", einem Open-Source-Projekt, mit dem du FreeCAD mit einem MCP-kompatiblen KI-Client verbinden kannst, sodass wir es direkt über natürlichsprachliche Prompts steuern können!",[18,56,57],{},"Das Ziel ist nicht, CAD-Kenntnisse zu ersetzen oder generierte Geometrie blind zu akzeptieren, sondern die Interaktion zwischen Mensch und Maschine gesprächiger und programmierbarer zu machen. Wir können den Agenten bitten, ein Dokument zu erstellen, ein einfaches Teil zu erzeugen, den Objektbaum zu prüfen, eine Abmessung zu ändern oder zu erklären, warum ein Feature fehlgeschlagen ist – genau wie bei einem Gespräch mit einem Menschen!",[59,60],"hr",{},[13,62,64],{"id":63},"was-wir-brauchen","Was wir brauchen",[18,66,67],{},"Zuerst beginnen wir mit einer Liste von allem, was wir für dieses kleine Projekt benötigen:",[69,70],"blog-list",{":items":71},"[\"Eine aktuelle FreeCAD-Installation.\",\"Python und uv, damit OpenCode den MCP-Server starten kann.\",\"OpenCode, installiert und mit einem KI-Anbieter konfiguriert.\",\"Das FreeCAD-MCP-Repository von neka-nat.\",\"Grundlegende Kenntnisse der FreeCAD-Oberfläche und der parametrischen Modellierung.\"]",[18,73,74,75,82],{},"Am einfachsten ist es, FreeCAD und ",[21,76,79],{"href":77,"rel":78,"target":26},"https:\u002F\u002Fopencode.ai\u002F",[25],[28,80,81],{},"OpenCode"," auf demselben Computer auszuführen. In diesem Aufbau kann der MCP-Server die lokale Standardverbindung verwenden, und wir müssen FreeCAD nicht im Netzwerk freigeben oder komplizierte Konfigurationen bearbeiten.",[84,85,87],"h3",{"id":86},"warum-freecad","Warum FreeCAD?",[18,89,90],{},"Okay, aber warum FreeCAD und nicht eine andere beliebte 3D-CAD-Lösung?",[18,92,93,94,96],{},"Ich habe mich einfach für ",[28,95,30],{}," entschieden, weil es vollständig quelloffen und kostenlos ist, ohne undurchsichtige Lizenzregeln oder seltsame Vorgaben zur Unternehmensgröße. Du möchtest ein 3D-Projekt für dich, deine Familie oder dein Unternehmen mit einer Million Mitarbeitenden erstellen? Kein Problem, dafür ist keine Lizenz erforderlich!",[18,98,99],{},[100,101],"img",{"alt":102,"src":103},"Open-Source-Funktionen der parametrischen 3D-Modellierung von FreeCAD","\u002Fimages\u002Fblog\u002Ffreecad-opencode\u002Ffreecad-infos.png",[18,105,106,108],{},[28,107,30],{}," bietet uns alle Werkzeuge, die wir zum Erstellen präziser Teile, Baugruppen, technischer Zeichnungen und mehr benötigen, während Abmessungen, Skizzen und Beziehungen bearbeitbar bleiben.",[18,110,111],{},"Im Gegensatz zu einem einfachen Zeichenprogramm merkt sich FreeCAD, wie das Modell erstellt wurde. Wenn wir die Länge einer Skizze, die Position eines Lochs oder die Dicke eines Features ändern, kann der Rest des Modells diesen Beziehungen entsprechend aktualisiert werden, statt dass wir alles manuell neu zeichnen müssen!",[18,113,114],{},"FreeCAD organisiert seine Werkzeuge in verschiedenen Arbeitsumgebungen. Dadurch können wir genau die Features auswählen, die für die jeweilige Aufgabe sinnvoll sind, und der Erstellungsprozess wird deutlich einfacher und übersichtlicher.",[18,116,117],{},"Eine weitere sehr praktische Eigenschaft von FreeCAD ist, dass sich sein Verhalten durch Add-ons und Skripte erweitern lässt. Dadurch eignet es sich perfekt, um mit einem KI-Coding-Agenten zu experimentieren und gleichzeitig die Kontrolle über das Design und unsere Dateien zu behalten.",[84,119,121],{"id":120},"warum-opencode","Warum OpenCode?",[18,123,124,125,127],{},"Für den Agenten habe ich mich für ",[28,126,81],{}," entschieden.",[18,129,130,132],{},[28,131,81],{}," ist ein sehr beliebter Coding-Agent. Da es quelloffen ist, passt es hervorragend zu FreeCAD.",[18,134,135],{},[100,136],{"alt":137,"src":138,"height":139,"width":140},"Funktionen des OpenCode-KI-Coding-Agenten","\u002Fimages\u002Fblog\u002Ffreecad-opencode\u002Fopencode-infos.png",941,1672,[18,142,143],{},"Mit den verfügbaren Modellen kann OpenCode natürlichsprachliche Anfragen verstehen, eine Abfolge von Aktionen planen und verbundene Tools verwenden, um eine Aufgabe zu erledigen. Du kannst OpenCode mit deinem bestehenden bevorzugten LLM oder KI-Abonnement wie GitHub Copilot verwenden oder es mit einer externen API-Plattform wie OpenRouter verbinden.",[18,145,146],{},"Anstatt das Terminal als Ort zu betrachten, an dem wir jeden Befehl perfekt eintippen müssen, können wir beschreiben, was wir erreichen möchten, und den Agenten bei der Auswahl der nächsten Schritte unterstützen lassen.",[18,148,149],{},"In unserem konkreten Fall bietet uns OpenCode eine gesprächige Möglichkeit, FreeCAD zu bitten, Dokumente zu erstellen, Modelle zu bauen, Objekte zu prüfen und klar zu erklären, wie diese Aufgaben erledigt wurden.",[18,151,152],{},"Wir können das gewünschte Ergebnis in einfachen Worten beschreiben, die Arbeit des Agenten überprüfen und um eine konkrete Änderung bitten, wenn etwas korrigiert werden muss. OpenCode kann uns außerdem die Antworten der Tools zurückgeben. So können wir den Agenten bitten, den Dokumentbaum zu prüfen, Abmessungen zu verifizieren oder vor der nächsten Entscheidung einen Screenshot aufzunehmen.",[18,154,155],{},"Da OpenCode quelloffen ist, können wir sein Projekt untersuchen, es lokal konfigurieren und es mit Tools wie dem FreeCAD-MCP-Server verbinden, statt uns nur auf einen geschlossenen, unveränderlichen Ablauf zu verlassen.",[84,157,159],{"id":158},"warum-einen-mcp-server-verwenden","Warum einen MCP-Server verwenden?",[18,161,162,163,170,171,174],{},"Das ",[21,164,167],{"href":165,"rel":166,"target":26},"https:\u002F\u002Fmodelcontextprotocol.io\u002F",[25],[28,168,169],{},"Model Context Protocol",", kurz ",[28,172,173],{},"MCP",", gibt einem KI-Client eine standardisierte Möglichkeit, externe Tools zu entdecken und aufzurufen, die Kontext für LLM-Aufrufe bereitstellen können.",[18,176,177,178,180,181,183],{},"Anstatt FreeCAD über Bildschirmklicks und Mausbewegungen zu steuern, kann ",[28,179,81],{}," die vom ",[28,182,53],{}," bereitgestellten Tools direkt aufrufen. Dadurch kann der Agent die CAD-Software über eine KI-freundliche API steuern.",[18,185,186],{},"Das FreeCAD-MCP-Projekt, das wir in dieser Anleitung verwenden, stellt unter anderem Tools für folgende Aufgaben bereit:",[69,188],{":items":189,"variant":190},"[\"FreeCAD-Dokumente erstellen und öffnen.\",\"FreeCAD-Objekte erstellen, bearbeiten und löschen.\",\"Python-Code innerhalb von FreeCAD ausführen.\",\"Objekte und den Dokumentbaum prüfen.\",\"Einen Screenshot der aktuellen Ansicht anfordern.\",\"Teile aus der FreeCAD-Teilebibliothek einfügen.\"]","circle",[18,192,193],{},"Dadurch erhält der Agent eine nützliche Rückkopplungsschleife. Er kann eine Änderung vornehmen, das Ergebnis prüfen und seine nächste Aktion anpassen, statt nur Code zu schreiben, den wir manuell einfügen müssen. Ziemlich praktisch, oder?",[59,195],{},[13,197,199],{"id":198},"_1-freecad-mcp-herunterladen","1. FreeCAD MCP herunterladen",[18,201,202],{},"Okay, als Erstes laden wir das offizielle Repository herunter, das vom großartigen neka-nat erstellt wurde.",[18,204,205],{},"Öffne dazu ein Terminal, wechsle in ein Verzeichnis deiner Wahl und führe den folgenden Befehl aus:",[207,208,213],"pre",{"className":209,"code":210,"language":211,"meta":212,"style":212},"language-bash shiki shiki-themes github-light github-dark","git clone https:\u002F\u002Fgithub.com\u002Fneka-nat\u002Ffreecad-mcp.git\n","bash","",[214,215,216],"code",{"__ignoreMap":212},[217,218,221,225,229],"span",{"class":219,"line":220},"line",1,[217,222,224],{"class":223},"sScJk","git",[217,226,228],{"class":227},"sZZnC"," clone",[217,230,231],{"class":227}," https:\u002F\u002Fgithub.com\u002Fneka-nat\u002Ffreecad-mcp.git\n",[18,233,234],{},[100,235],{"alt":236,"src":237},"FreeCAD-MCP-Repository im Documents-Ordner geklont","\u002Fimages\u002Fblog\u002Ffreecad-opencode\u002Ffreecad-mcp-download.png",[18,239,240,241,244,245,248,249,251],{},"Das Repository enthält sowohl den ",[28,242,243],{},"Python-MCP-Server"," als auch das ",[28,246,247],{},"FreeCAD-Addon",". Bewahre das Repository an einem stabilen Ort auf, da ",[28,250,81],{}," beim Start des Servers seinen Pfad benötigt.",[18,253,254],{},"Unter Windows empfehle ich, es in deinem Documents-Ordner aufzubewahren. Zum Beispiel könntest du folgenden Pfad verwenden:",[207,256,261],{"className":257,"code":259,"language":260,"meta":212},[258],"language-text","C:\\Users\\YourName\\Documents\\freecad-mcp\n","text",[214,262,259],{"__ignoreMap":212},[18,264,265],{},"Wenn du einen anderen Ort verwendest, ist das kein Problem. Wir müssen später in der OpenCode-Konfiguration nur den Beispielpfad ersetzen.",[59,267],{},[13,269,271],{"id":270},"_2-freecad-addon-installieren","2. FreeCAD-Addon installieren",[18,273,274,275,278,279,281,282,285],{},"Der ",[28,276,277],{},"MCP-Server"," benötigt außerdem ein in ",[28,280,30],{}," installiertes Add-on. Das offizielle Repository enthält alles, was wir brauchen, im Verzeichnis ",[214,283,284],{},"addon\u002FFreeCADMCP",".",[18,287,288],{},"Unter Windows verwendet FreeCAD 1.1 das folgende versionsabhängige Add-on-Verzeichnis:",[207,290,293],{"className":291,"code":292,"language":260,"meta":212},[258],"C:\\Users\\YourName\\AppData\\Roaming\\FreeCAD\\v1-1\\Mod\\FreeCADMCP\n",[214,294,292],{"__ignoreMap":212},[18,296,297,298,301,302,285],{},"Um das Add-on zu installieren, öffne das geklonte Repository und kopiere den Ordner ",[28,299,300],{},"FreeCADMCP"," aus ",[214,303,304],{},"addon",[18,306,307,308,311],{},"Füge ihn anschließend in den folgenden FreeCAD-Ordner ein. Erstelle den Ordner ",[214,309,310],{},"Mod",", falls er noch nicht existiert:",[207,313,316],{"className":314,"code":315,"language":260,"meta":212},[258],"C:\\Users\\YourName\\AppData\\Roaming\\FreeCAD\\v1-1\\Mod\n",[214,317,315],{"__ignoreMap":212},[18,319,320],{},"Kurz gesagt: Kopiere den folgenden Ordner:",[207,322,325],{"className":323,"code":324,"language":260,"meta":212},[258],"C:\\Users\\YourName\\Documents\\freecad-mcp\\addon\\FreeCADMCP\n",[214,326,324],{"__ignoreMap":212},[18,328,329],{},"in diesen Ordner:",[207,331,333],{"className":332,"code":315,"language":260,"meta":212},[258],[214,334,315],{"__ignoreMap":212},[18,336,337,338,341],{},"Ältere FreeCAD-Versionen verwenden möglicherweise den Ordner ",[214,339,340],{},"C:\\Users\\YourName\\AppData\\Roaming\\FreeCAD\\Mod"," für Add-ons. Verwende das Verzeichnis, das zum versionsabhängigen Ordner deiner FreeCAD-Installation passt.",[18,343,344],{},"Starte FreeCAD nach dem Kopieren des Add-ons neu, falls es bereits geöffnet war. Das Repository dokumentiert auch die Add-on-Verzeichnisse für Linux und macOS, falls du ein anderes Betriebssystem verwendest.",[84,346,348],{"id":347},"mcp-addon-arbeitsumgebung-auswählen","MCP-Addon-Arbeitsumgebung auswählen",[18,350,351,352,354,355,358,359,362],{},"Öffne nach dem Neustart von ",[28,353,30],{}," die Auswahl der Arbeitsumgebungen und wähle ",[28,356,357],{},"MCP Addon",". Nun sollte die ",[28,360,361],{},"FreeCAD-MCP","-Symbolleiste oder das entsprechende Menü sichtbar sein.",[18,364,365],{},[100,366],{"alt":367,"src":368},"FreeCAD-MCP-Arbeitsumgebung und RPC-Server-Steuerung","\u002Fimages\u002Fblog\u002Ffreecad-opencode\u002Ffreecad-mcp-addon.png",[18,370,371,372,375,376,378,379,381,382,384],{},"Klicke auf ",[28,373,374],{},"Start RPC Server",", um die lokale Brücke zu starten. Der von ",[28,377,81],{}," gestartete ",[28,380,277],{}," verwendet diese Brücke, um mit ",[28,383,30],{}," zu kommunizieren.",[18,386,387,388,391,392,395],{},"Der RPC-Server muss normalerweise bei jedem Start von FreeCAD gestartet werden. Wenn er automatisch starten soll, öffne das Menü ",[28,389,390],{},"FreeCAD MCP"," und aktiviere ",[28,393,394],{},"Auto-Start Server",". Die Einstellung wird vom Add-on gespeichert und bleibt über mehrere Sitzungen hinweg erhalten.",[59,397],{},[13,399,401],{"id":400},"_3-opencode-installieren","3. OpenCode installieren",[18,403,404],{},"Als Nächstes installieren wir OpenCode.",[18,406,407],{},[100,408],{"alt":409,"src":410},"OpenCode-Installationsseite","\u002Fimages\u002Fblog\u002Ffreecad-opencode\u002Fopencode-website.jpg",[18,412,413,414,416],{},"Wir können ",[28,415,81],{}," mit dem offiziellen Installer und dem folgenden Bash-Befehl installieren:",[207,418,420],{"className":209,"code":419,"language":211,"meta":212,"style":212},"curl -fsSL https:\u002F\u002Fopencode.ai\u002Finstall | bash\n",[214,421,422],{"__ignoreMap":212},[217,423,424,427,431,434,438],{"class":219,"line":220},[217,425,426],{"class":223},"curl",[217,428,430],{"class":429},"sj4cs"," -fsSL",[217,432,433],{"class":227}," https:\u002F\u002Fopencode.ai\u002Finstall",[217,435,437],{"class":436},"szBVR"," |",[217,439,440],{"class":223}," bash\n",[18,442,443],{},"Wenn du wie ich lieber npm verwendest, kannst du stattdessen den folgenden Befehl ausführen:",[207,445,447],{"className":209,"code":446,"language":211,"meta":212,"style":212},"npm i -g opencode-ai\n",[214,448,449],{"__ignoreMap":212},[217,450,451,454,457,460],{"class":219,"line":220},[217,452,453],{"class":223},"npm",[217,455,456],{"class":227}," i",[217,458,459],{"class":429}," -g",[217,461,462],{"class":227}," opencode-ai\n",[18,464,465,466,469,470,473],{},"Öffne nach Abschluss der Installation ein neues Terminal, damit der Befehl ",[214,467,468],{},"opencode"," in deinem ",[214,471,472],{},"PATH"," verfügbar ist. Prüfen wir, ob er funktioniert:",[207,475,477],{"className":209,"code":476,"language":211,"meta":212,"style":212},"opencode --version\n",[214,478,479],{"__ignoreMap":212},[217,480,481,483],{"class":219,"line":220},[217,482,468],{"class":223},[217,484,485],{"class":429}," --version\n",[18,487,488],{},[100,489],{"alt":490,"src":491},"Ausgabe des OpenCode-Versionsbefehls","\u002Fimages\u002Fblog\u002Ffreecad-opencode\u002Fopencode-version.png",[18,493,494,495,498,499,501,502,509],{},"Du musst außerdem einen ",[28,496,497],{},"KI-Anbieter"," konfigurieren, bevor ",[28,500,81],{}," als Coding-Agent arbeiten kann. Wenn du OpenCode zum ersten Mal installierst, findest du in der ",[21,503,506],{"href":504,"rel":505,"target":26},"https:\u002F\u002Fopencode.ai\u002Fdocs\u002F",[25],[28,507,508],{},"OpenCode-Dokumentation"," Hinweise zur Einrichtung des Anbieters.",[59,511],{},[13,513,515],{"id":514},"_4-opencode-konfigurieren","4. OpenCode konfigurieren",[18,517,518,519,522,523,526],{},"OpenCode liest seine Projektkonfiguration aus einer Datei ",[214,520,521],{},"opencode.json"," oder ",[214,524,525],{},"opencode.jsonc",". Wir können diese Datei im Stammverzeichnis eines Projekts ablegen oder die globale OpenCode-Konfiguration verwenden, wenn FreeCAD überall verfügbar sein soll.",[18,528,529],{},"Unter Windows befindet sich die globale Konfigurationsdatei normalerweise hier:",[207,531,534],{"className":532,"code":533,"language":260,"meta":212},[258],"C:\\Users\\YourName\\.config\\opencode\\opencode.json\n",[214,535,533],{"__ignoreMap":212},[18,537,538],{},"Falls das Verzeichnis oder die Datei noch nicht existiert, erstelle sie, bevor du die Konfiguration hinzufügst.",[18,540,541,542,545,546,548,549,552],{},"Erstelle oder bearbeite nun die ",[28,543,544],{},"OpenCode-Konfiguration"," und füge den ",[28,547,53],{}," wie unten gezeigt unter dem Schlüssel ",[214,550,551],{},"mcp"," hinzu:",[207,554,558],{"className":555,"code":556,"language":557,"meta":212,"style":212},"language-json shiki shiki-themes github-light github-dark","{\n    \"$schema\": \"https:\u002F\u002Fopencode.ai\u002Fconfig.json\",\n    \"mcp\": {\n        \"freecad\": {\n            \"type\": \"local\",\n            \"command\": [\n                \"uv\",\n                \"--directory\",\n                \"C:\\\\Users\\\\YourName\\\\Documents\\\\freecad-mcp\",\n                \"run\",\n                \"freecad-mcp\"\n            ],\n            \"enabled\": true\n        }\n    }\n}\n","json",[214,559,560,566,581,590,598,611,620,628,636,665,673,679,685,696,702,708],{"__ignoreMap":212},[217,561,562],{"class":219,"line":220},[217,563,565],{"class":564},"sVt8B","{\n",[217,567,569,572,575,578],{"class":219,"line":568},2,[217,570,571],{"class":429},"    \"$schema\"",[217,573,574],{"class":564},": ",[217,576,577],{"class":227},"\"https:\u002F\u002Fopencode.ai\u002Fconfig.json\"",[217,579,580],{"class":564},",\n",[217,582,584,587],{"class":219,"line":583},3,[217,585,586],{"class":429},"    \"mcp\"",[217,588,589],{"class":564},": {\n",[217,591,593,596],{"class":219,"line":592},4,[217,594,595],{"class":429},"        \"freecad\"",[217,597,589],{"class":564},[217,599,601,604,606,609],{"class":219,"line":600},5,[217,602,603],{"class":429},"            \"type\"",[217,605,574],{"class":564},[217,607,608],{"class":227},"\"local\"",[217,610,580],{"class":564},[217,612,614,617],{"class":219,"line":613},6,[217,615,616],{"class":429},"            \"command\"",[217,618,619],{"class":564},": [\n",[217,621,623,626],{"class":219,"line":622},7,[217,624,625],{"class":227},"                \"uv\"",[217,627,580],{"class":564},[217,629,631,634],{"class":219,"line":630},8,[217,632,633],{"class":227},"                \"--directory\"",[217,635,580],{"class":564},[217,637,639,642,645,648,650,653,655,658,660,663],{"class":219,"line":638},9,[217,640,641],{"class":227},"                \"C:",[217,643,644],{"class":429},"\\\\",[217,646,647],{"class":227},"Users",[217,649,644],{"class":429},[217,651,652],{"class":227},"YourName",[217,654,644],{"class":429},[217,656,657],{"class":227},"Documents",[217,659,644],{"class":429},[217,661,662],{"class":227},"freecad-mcp\"",[217,664,580],{"class":564},[217,666,668,671],{"class":219,"line":667},10,[217,669,670],{"class":227},"                \"run\"",[217,672,580],{"class":564},[217,674,676],{"class":219,"line":675},11,[217,677,678],{"class":227},"                \"freecad-mcp\"\n",[217,680,682],{"class":219,"line":681},12,[217,683,684],{"class":564},"            ],\n",[217,686,688,691,693],{"class":219,"line":687},13,[217,689,690],{"class":429},"            \"enabled\"",[217,692,574],{"class":564},[217,694,695],{"class":429},"true\n",[217,697,699],{"class":219,"line":698},14,[217,700,701],{"class":564},"        }\n",[217,703,705],{"class":219,"line":704},15,[217,706,707],{"class":564},"    }\n",[217,709,711],{"class":219,"line":710},16,[217,712,713],{"class":564},"}\n",[18,715,716,717,720,721,724,725,727],{},"Ersetze ",[214,718,719],{},"C:\\\\Users\\\\YourName\\\\Documents\\\\freecad-mcp"," durch den tatsächlichen Pfad zu deinem Klon. JSON-Pfade verwenden maskierte Backslashes. Ein Windows-Pfad wie ",[214,722,723],{},"C:\\Users\\YourName\\Documents\\freecad-mcp"," muss daher innerhalb der JSON-Datei als ",[214,726,719],{}," geschrieben werden.",[59,729],{},[13,731,733],{"id":732},"_5-opencode-starten","5. OpenCode starten",[18,735,736,737,739,740,742,743,745,746,749],{},"Bevor wir ",[28,738,81],{}," starten, sollten wir bestätigen, dass ",[28,741,30],{}," geöffnet ist, die Arbeitsumgebung ",[28,744,357],{}," ausgewählt wurde und der ",[28,747,748],{},"RPC-Server"," läuft.",[18,751,752],{},"Wenn alles passt, starte OpenCode aus dem Verzeichnis, in dem sich die Konfiguration befindet:",[207,754,756],{"className":209,"code":755,"language":211,"meta":212,"style":212},"opencode\n",[214,757,758],{"__ignoreMap":212},[217,759,760],{"class":219,"line":220},[217,761,755],{"class":223},[18,763,764,766,767,770,771,773,774,776,777,469,780,782,783,285],{},[28,765,81],{}," sollte den ",[214,768,769],{},"freecad","-",[28,772,277],{}," beim Start erkennen. Wenn der Server nicht erscheint, überprüfe den Pfad in ",[214,775,521],{},", bestätige, dass ",[214,778,779],{},"uv",[214,781,472],{}," verfügbar ist, und prüfe den ",[28,784,785],{},"Status des OpenCode-MCP-Servers",[18,787,413,788,790,791,793],{},[28,789,81],{}," auch mit einem einfachen Prompt fragen, ob es auf den ",[28,792,361],{}," zugreifen kann:",[207,795,798],{"className":796,"code":797,"language":260,"meta":212},[258],"Do you have access to the FreeCAD MCP?\n",[214,799,797],{"__ignoreMap":212},[18,801,802],{},"Beginne nicht mit einem komplexen CAD-Projekt. Ein kleiner Verbindungstest macht es viel einfacher herauszufinden, ob ein späteres Problem von OpenCode, dem MCP-Server oder FreeCAD selbst verursacht wird.",[18,804,805,806,808,809,811],{},"Wenn die Antwort positiv ist, herzlichen Glückwunsch! ",[28,807,81],{}," ist nun erfolgreich mit dem ",[28,810,361],{}," verbunden.",[59,813],{},[13,815,817],{"id":816},"_6-erstes-projekt-erstellen","6. Erstes Projekt erstellen",[18,819,820],{},"Okay, machen wir mit einer etwas detaillierteren Anfrage weiter:",[207,822,825],{"className":823,"code":824,"language":260,"meta":212},[258],"Use the freecad MCP server to create a new document named AgentTest, then list the objects in the document.\n",[214,826,824],{"__ignoreMap":212},[18,828,829,830,833,834,837,838,841],{},"Der Agent sollte ",[214,831,832],{},"create_document"," und anschließend ",[214,835,836],{},"get_objects"," aufrufen. Abhängig von den Servereinstellungen kann die Antwort außerdem einen Screenshot der ",[28,839,840],{},"FreeCAD-Ansicht"," enthalten.",[18,843,844,845,848],{},"Wenn die Anfrage erfolgreich ist, hast du die gesamte ",[28,846,847],{},"Verbindungskette"," bestätigt:",[69,850],{":items":851,"variant":852},"[\"OpenCode kann den konfigurierten MCP-Server sehen.\",\"Der MCP-Server kann eine Verbindung zur FreeCAD-RPC-Brücke herstellen.\",\"Das FreeCAD-Addon kann eine Anfrage empfangen und verarbeiten.\",\"Der Agent kann ein Ergebnis von FreeCAD zurücklesen.\"]","numbered",[18,854,855],{},"Großartig! Speichere das Dokument jetzt manuell oder bitte den Agenten, es mit FreeCAD-Python zu speichern. Wenn du dieses erste Testdokument aufbewahrst, ist es später bei der Fehlersuche hilfreich.",[59,857],{},[13,859,861],{"id":860},"_7-einfaches-parametrisches-teil-erstellen","7. Einfaches parametrisches Teil erstellen",[18,863,864],{},"Sobald die Verbindung funktioniert, können wir den Agenten bitten, ein kleines Modell mit konkreten Abmessungen zu erstellen. Eine einfache Platte mit vier Löchern ist ein gutes erstes Projekt, weil die Geometrie eindeutig und leicht zu prüfen ist.",[18,866,867],{},"Zum Beispiel können wir einen Prompt wie diesen verwenden:",[207,869,872],{"className":870,"code":871,"language":260,"meta":212},[258],"Use the freecad MCP tools to create a new document containing a parametric rectangular plate.\n\nRequirements:\n- The plate should be 100 mm long, 60 mm wide, and 8 mm thick.\n- Add four through-holes with a diameter of 6 mm.\n- Place the holes symmetrically, 10 mm from the nearest two edges.\n- Use meaningful object names.\n- Recompute the document and report the objects and final dimensions.\n- Do not overwrite any existing document.\n",[214,873,871],{"__ignoreMap":212},[18,875,876,877,880,881,884,885,888,889,892],{},"Die genaue Umsetzung bleibt dem Agenten überlassen. Er kann ",[28,878,879],{},"Part-Primitives"," erstellen, eine ",[28,882,883],{},"Skizze"," und einen ",[28,886,887],{},"Pad"," verwenden oder ",[28,890,891],{},"FreeCAD-Python"," ausführen, das die Form erstellt. Wichtig ist, die Abmessungen, Constraints, Erwartungen an die Benennung und Sicherheitsgrenzen klar anzugeben.",[84,894,896],{"id":895},"ergebnis-prüfen","Ergebnis prüfen",[18,898,899],{},"Nachdem das Modell erstellt wurde, bitten wir den Agenten, es zu prüfen, statt sofort ein weiteres Feature anzufordern:",[207,901,904],{"className":902,"code":903,"language":260,"meta":212},[258],"Inspect the current FreeCAD document with the freecad MCP tools. List every object, its type, its dimensions, and any visible errors. Take an isometric view screenshot if available.\n",[214,905,903],{"__ignoreMap":212},[18,907,908,909,912,913,916],{},"Hier wird der ",[28,910,911],{},"MCP-Workflow"," nützlicher als eine einmalige Codegenerierung. Wir können den Bericht des Agenten mit dem ",[28,914,915],{},"FreeCAD-Baum"," und dem Ansichtsfenster vergleichen und anschließend eine gezielte Korrektur anfordern.",[18,918,919],{},"Wenn die Löcher beispielsweise nicht an der richtigen Stelle liegen, können wir Folgendes sagen:",[207,921,924],{"className":922,"code":923,"language":260,"meta":212},[258],"The plate looks correct, but the holes are not symmetric around the center. Inspect the model and move only the hole locations so the four hole centers are 10 mm from the corresponding edges. Preserve the plate thickness and hole diameter.\n",[214,925,923],{"__ignoreMap":212},[18,927,928],{},"Formuliere Änderungswünsche präzise. Wenn du den Agenten bittest, etwas „besser aussehen“ zu lassen, gibst du ihm zu viel Freiheit, und das Ergebnis wird schwieriger zu überprüfen.",[59,930],{},[13,932,934],{"id":933},"_8-mit-freecad-python-arbeiten","8. Mit FreeCAD-Python arbeiten",[18,936,937,938,941,942,944,945,947],{},"Mit dem Tool ",[214,939,940],{},"execute_code"," kann der Agent Python innerhalb von ",[28,943,30],{}," ausführen. Das ist eine wirklich leistungsfähige Funktion, weil ",[28,946,30],{}," einen großen Teil seiner Modellierungsfunktionen über Python bereitstellt. Gleichzeitig bedeutet das, dass wir den generierten Code prüfen sollten, bevor wir wichtige Änderungen zulassen.",[18,949,950],{},"Beginnen wir mit einer sicheren Anfrage zur Untersuchung:",[207,952,955],{"className":953,"code":954,"language":260,"meta":212},[258],"Use execute_code only to inspect the active document. Return the document name and a list of object names and types. Do not create, delete, or modify anything.\n",[214,956,954],{"__ignoreMap":212},[18,958,959],{},"Bei einer kontrollierten Modellierungsaufgabe solltest du den Agenten zuerst die geplanten Vorgänge erklären lassen:",[207,961,964],{"className":962,"code":963,"language":260,"meta":212},[258],"Before executing code, describe the FreeCAD objects and operations you plan to use to create the plate. Wait for confirmation before modifying the document.\n",[214,965,963],{"__ignoreMap":212},[18,967,968],{},"Dieser zusätzliche Schritt ist nützlich, wenn wir die API kennenlernen oder mit einem Modell arbeiten, das wichtige Konstruktionsarbeit enthält.",[18,970,971,972,975],{},"Denke daran, dass ",[28,973,974],{},"FreeCAD-Operationen"," Abhängigkeiten haben können. Das Löschen oder Ändern eines Objekts kann sich auf Skizzen, Pads, Schnitte oder nachgelagerte Features auswirken. Ein Modell, das in einem Screenshot korrekt aussieht, kann trotzdem fragile oder falsche parametrische Beziehungen enthalten.",[59,977],{},[13,979,981],{"id":980},"fehlerbehebung","Fehlerbehebung",[18,983,984],{},"Wenn etwas fehlschlägt, hilft die folgende kurze Checkliste:",[69,986],{":items":987},"[\"Wenn OpenCode den Server nicht findet, überprüfe den mcp-Schlüssel, den Servernamen, das Befehlsarray und den Pfad in opencode.json.\",\"Wenn uv nicht startet, installiere uv und bestätige, dass der Befehl im Terminal verfügbar ist, über das du OpenCode startest.\",\"Wenn der Server startet, FreeCAD aber nicht antwortet, öffne FreeCAD, wähle die Arbeitsumgebung MCP Addon aus und starte den RPC-Server neu.\",\"Wenn ein Tool ein GUI-Dispatch-Problem meldet, verwende get_rpc_status und warte, bis FreeCAD wieder in einem gesunden Zustand ist, bevor du eine weitere GUI-Anfrage sendest.\",\"Wenn die generierte Geometrie falsch ist, prüfe den Dokumentbaum und die Abmessungen, bevor du den Agenten um eine gezielte Korrektur bittest.\"]",[18,989,162,990,993,994,997,998,1001,1002,1004],{},[28,991,992],{},"FreeCAD-MCP-Projekt"," weist darauf hin, dass ",[28,995,996],{},"GUI-Operationen"," nicht immer sicher zwangsweise abgebrochen werden können. Wenn eine GUI-Operation hängen bleibt, kann das Senden weiterer GUI-Anfragen die Situation verschlimmern. Prüfe den ",[28,999,1000],{},"RPC-Status"," und starte ",[28,1003,30],{}," bei Bedarf neu.",[18,1006,1007,1008,1010,1011,1014],{},"Wenn ",[214,1009,940],{}," beim Erstellen eines ",[214,1012,1013],{},"FeaturePython","-Objekts eine Ausnahme auslöst, prüfe das neue Objekt, bevor du versuchst, es zu ändern oder zu löschen. Bei einem teilweise erstellten Objekt ist der erwartete Proxy möglicherweise nicht installiert.",[59,1016],{},[13,1018,1020],{"id":1019},"praktische-hinweise","Praktische Hinweise",[18,1022,1023,1024,1027],{},"Ein ",[28,1025,1026],{},"KI-Coding-Agent"," ist am nützlichsten, wenn wir ihn als fähigen Mitarbeiter betrachten, dessen Arbeit überprüft werden muss. Gib ihm messbare Anforderungen, bitte ihn, sein Ergebnis zu prüfen, und halte Änderungen klein genug, um sie rückgängig machen zu können.",[18,1029,1030],{},"Für wiederholbare Aufgaben solltest du Abmessungen und Constraints beschreiben, statt nur das Aussehen zu nennen. „Erstelle eine 100 mm lange und 60 mm breite Platte mit vier 6-mm-Löchern“ ist viel nützlicher als „Erstelle eine kleine Montageplatte“.",[18,1032,1033],{},"Außerdem ist es eine gute Gewohnheit, vor größeren Änderungen Versionen unserer FreeCAD-Dateien zu speichern. Parametrische Modelle können versteckte Abhängigkeiten enthalten, und eine scheinbar kleine Änderung kann ein späteres Feature ungültig machen.",[18,1035,1036],{},"Denke zum Schluss daran, dass generiertes CAD nicht automatisch sicher für die Fertigung ist. Prüfe Einheiten, Toleranzen, Wandstärken, Befestigungsabstände, Materialannahmen und Exporteinstellungen selbst. Der Agent kann den Designprozess beschleunigen, aber die technische Verantwortung bleibt bei der Person, die das Modell freigibt.",[59,1038],{},[13,1040,1042],{"id":1041},"fazit","Fazit",[18,1044,1045,1046,1048,1049,1052,1053,1055],{},"Damit sind wir am Ende dieser Reise angekommen! ",[28,1047,390],{}," ermöglicht es, eine laufende FreeCAD-Sitzung mit einem ",[28,1050,1051],{},"MCP-kompatiblen Agenten"," zu verbinden. Mit ",[28,1054,81],{}," können wir eine Modellierungsaufgabe in natürlicher Sprache beschreiben, den Agenten FreeCAD-Objekte erstellen oder ändern lassen, das Ergebnis prüfen und mit gezielten Anweisungen weiterarbeiten.",[18,1057,1058],{},"Hier ist eine kurze Zusammenfassung dessen, was wir gemacht haben:",[69,1060],{":items":1061,"variant":852},"[\"Das FreeCAD-MCP-Repository klonen.\",\"Das FreeCADMCP-Addon installieren und FreeCAD neu starten.\",\"Den FreeCAD-RPC-Server starten.\",\"Den FreeCAD-MCP-Server zur OpenCode-Konfiguration hinzufügen.\",\"Die Verbindung mit einem neuen Dokument und einer Objektauflistung testen.\",\"Ein kleines, messbares Teil erstellen und sorgfältig prüfen.\"]",[18,1063,1064,1065,1069,1070,285],{},"Weitere Beispiele und die neuesten Installationshinweise findest du im ",[21,1066,1068],{"href":49,"rel":1067,"target":26},[25],"FreeCAD-MCP-Repository"," und in der ",[21,1071,1074],{"href":1072,"rel":1073,"target":26},"https:\u002F\u002Fopencode.ai\u002Fdocs\u002Fmcp-servers\u002F",[25],"OpenCode-MCP-Dokumentation",[18,1076,1077],{},"Wenn dein Verbindungstest funktioniert hat und der Agent dein erstes Teil erstellt hat, herzlichen Glückwunsch! Du hast jetzt eine gesprächige Brücke zwischen OpenCode und FreeCAD und kannst mit deinen eigenen parametrischen Modellen experimentieren!",[18,1079,1080,1081,1083],{},"Halte FreeCAD, das FreeCAD-MCP-Repository, OpenCode und ",[214,1082,779],{}," aktuell, damit die Einrichtung zuverlässig funktioniert. Speichere vor wichtigen Änderungen eine Kopie deines Modells und überprüfe generierte Geometrie immer, bevor du sie in einem echten Projekt verwendest.",[18,1085,1086,1087,1091,1092,1096],{},"Wenn du praktische Open-Source-Projekte wie dieses magst, interessiert dich vielleicht auch unsere ",[21,1088,1090],{"href":1089},"\u002Fde\u002Fblog\u002Fhow-to-configure-pi-hole-and-mullvad-on-a-raspberry-pi","Anleitung zur Einrichtung von Pi-hole und Mullvad auf einem Raspberry Pi"," für einen netzwerkweiten Datenschutz oder unsere ",[21,1093,1095],{"href":1094},"\u002Fde\u002Fblog\u002Fhow-to-setup-and-use-mullvad-vpn-mobile-app","Anleitung zur Verwendung der mobilen Mullvad-VPN-App",", wenn du einzelne Geräte unterwegs schützen möchtest!",[18,1098,1099],{},[100,1100],{"alt":1101,"src":1102},"Mädchen verwendet FreeCAD mit einem KI-Coding-Agenten","\u002Fimages\u002Fblog\u002Ffreecad-opencode\u002Fgirl-using-freecad.png",[18,1104,1105],{},"Damit sind wir für heute fertig! Ich hoffe, dir hat diese Anleitung gefallen, und wir sehen uns hoffentlich bald wieder!",[1107,1108,1109],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":212,"searchDepth":568,"depth":568,"links":1111},[1112,1113,1118,1119,1122,1123,1124,1125,1126,1129,1130,1131,1132],{"id":15,"depth":568,"text":16},{"id":63,"depth":568,"text":64,"children":1114},[1115,1116,1117],{"id":86,"depth":583,"text":87},{"id":120,"depth":583,"text":121},{"id":158,"depth":583,"text":159},{"id":198,"depth":568,"text":199},{"id":270,"depth":568,"text":271,"children":1120},[1121],{"id":347,"depth":583,"text":348},{"id":400,"depth":568,"text":401},{"id":514,"depth":568,"text":515},{"id":732,"depth":568,"text":733},{"id":816,"depth":568,"text":817},{"id":860,"depth":568,"text":861,"children":1127},[1128],{"id":895,"depth":583,"text":896},{"id":933,"depth":568,"text":934},{"id":980,"depth":568,"text":981},{"id":1019,"depth":568,"text":1020},{"id":1041,"depth":568,"text":1042},"guides","Anleitungen","2026-08-22","Eine praktische Anleitung zur Steuerung von FreeCAD mit dem FreeCAD-MCP-Server und OpenCode – von der Installation des Add-ons bis zum Erstellen und Prüfen eines parametrischen Modells mit natürlichsprachlichen Anweisungen.","md",[1139,1142,1145,1148,1151],{"question":1140,"answer":1141},"Was ist der FreeCAD-MCP-Server?","FreeCAD MCP verbindet einen MCP-kompatiblen Coding-Agenten mit FreeCAD. Er verwendet das FreeCADMCP-Addon und einen kleinen MCP-Server, damit der Agent Dokumente erstellen, FreeCAD-Python-Code ausführen, Objekte prüfen und Ansichten des Modells anfordern kann.",{"question":1143,"answer":1144},"Kann OpenCode FreeCAD direkt steuern?","Ja. OpenCode kann den FreeCAD-MCP-Server als lokalen MCP-Prozess starten. Der Server kommuniziert mit dem FreeCAD-Addon, das in einer geöffneten FreeCAD-Sitzung laufen muss.",{"question":1146,"answer":1147},"Muss ich FreeCAD-Python beherrschen, um diese Einrichtung zu verwenden?","Nein, aber grundlegende Kenntnisse von FreeCAD und Python sind hilfreich. Ein Agent kann einen großen Teil des Codes schreiben, während dein Verständnis von Dokumenten, Bodies, Skizzen, Constraints und Messungen dir hilft, das Ergebnis zu überprüfen.",{"question":1149,"answer":1150},"Wo sollte ich den FreeCAD-MCP-Server ausführen?","Führe ihn für die einfachste Einrichtung auf demselben Computer wie FreeCAD aus. Das FreeCAD-MCP-Projekt unterstützt auch Remote-Verbindungen, wenn das Addon so konfiguriert ist, dass es die IP-Adresse oder das Subnetz des Agentencomputers zulässt.",{"question":1152,"answer":1153},"Kann der Agent automatisch produktionsreife CAD-Modelle erstellen?","Er kann nützliche parametrische Modelle erstellen und wiederkehrende Arbeiten beschleunigen, aber jedes generierte Modell muss weiterhin von einem Menschen geprüft werden. Überprüfe Abmessungen, Constraints, Topologie, Abstände, Fertigbarkeit und die gespeicherte Datei, bevor du sie für ein echtes Projekt verwendest.","\u002Fimages\u002Fblog\u002Ffreecad-opencode\u002Fguy-using-freecad.png","de",{},true,"\u002Fde\u002Fblog\u002Fhow-to-use-freecad-opencode-mcp",{"title":5,"description":1136},{"loc":1158},"de\u002Fblog\u002Fhow-to-use-freecad-opencode-mcp",[30,81,173,1163,1164],"CAD","AI","uQz9VXDF6vVUDcAN7N33IvMQMQ99Ffi-N0oHFvYebyg",[1167,1171],{"title":1168,"description":1169,"image":1170,"categoryText":1134,"path":1089},"Pi-hole und Mullvad VPN auf einem Raspberry Pi verwenden","Eine praktische Anleitung zur Installation von Pi-hole und zur Einrichtung eines Raspberry Pi als Mullvad-WireGuard-Gateway, einschließlich DNS, Weiterleitung, NAT und Fehlerbehebung bei Leaks.","\u002Fimages\u002Fblog\u002Fpi-hole-and-mullvad\u002Fraspberry-pi-network.png",{"title":1172,"description":1173,"image":1174,"categoryText":1134,"path":1094},"Mullvad VPN: Die mobile App einrichten und verwenden","Eine praktische Anleitung zum Installieren, Einrichten und Verwenden der mobilen Mullvad-VPN-App unter Android und iOS, einschließlich Kontoeinrichtung, Serverauswahl, Kill-Switch-Verhalten und Fehlerbehebung bei Verbindungsproblemen.","\u002Fimages\u002Fblog\u002Fmullvad-app\u002Fmullvad-app.png",[],1789897414898]