Autodesk Fusion 360 mit Claude über MCP verbinden

Installation von faust-machines/fusion360-mcp-server auf macOS und Windows

Mit dem externen MCP-Server faust-machines/fusion360-mcp-server kann Claude über das Model Context Protocol mit Autodesk Fusion 360 kommunizieren. Dadurch kann Claude Fusion-Werkzeuge aufrufen, Geometrien erzeugen, Parameter setzen, Skizzen anlegen, Körper extrudieren, Modelle analysieren und weitere CAD-Aktionen ausführen.

Das Projekt besteht im Wesentlichen aus zwei Komponenten:

1. Fusion360MCP Add-in
   Dieses Add-in läuft direkt in Autodesk Fusion 360 und nimmt Befehle entgegen.
2. Python MCP Server
   Dieser Server wird von Claude Desktop gestartet und kommuniziert per TCP mit dem Fusion-Add-in.

Voraussetzungen

• Autodesk Fusion 360
• Claude Desktop
• Python 3.10 oder neuer, empfohlen Python 3.11+
• Git
• Internetzugang
• Grundkenntnisse im Terminal bzw. in PowerShell

Optional kann auch uv bzw. uvx verwendet werden. In dieser Anleitung wird jedoch die lokale Installation über eine virtuelle Python-Umgebung beschrieben, weil sie für Einsteiger besser nachvollziehbar ist.

Teil 1: Installation auf macOS

1. Terminal öffnen und Python-Version prüfen

Öffne das Terminal und prüfe die installierte Python-Version:

Terminal

python3 --version

Empfohlen ist Python 3.11 oder neuer. Falls auf dem Mac nur eine ältere Systemversion wie Python 3.9 vorhanden ist, sollte eine neuere Version installiert werden.

Mit Homebrew zum Beispiel:

Terminal

brew install python@3.11

Danach prüfen:

Terminal

python3.11 --version

2. Repository herunterladen

Wechsle in dein Benutzerverzeichnis und klone das Repository:

Terminal

cd ~
git clone https://github.com/faust-machines/fusion360-mcp-server.git
cd fusion360-mcp-server

Der Projektordner liegt danach beispielhaft unter:

macOS-Pfad

/Users/druckwerkstatt3d/fusion360-mcp-server

Bei anderen Nutzern muss druckwerkstatt3d durch den eigenen macOS-Benutzernamen ersetzt werden.

3. Virtuelle Python-Umgebung erstellen

Im Projektordner wird eine virtuelle Python-Umgebung angelegt:

Terminal

python3.11 -m venv venv
source venv/bin/activate

Falls python3.11 nicht vorhanden ist, kann je nach Installation auch dieser Befehl funktionieren:

Terminal

python3 -m venv venv
source venv/bin/activate

Prüfe anschließend die aktive Python-Version:

Terminal

python --version

4. MCP-Server installieren

Das Projekt verwendet pyproject.toml. Deshalb wird es lokal so installiert:

Terminal

pip install -e .

Prüfe danach, ob das Paket installiert wurde:

Terminal

pip list

In der Liste sollte unter anderem fusion360-mcp-server erscheinen.

Prüfe außerdem, ob der Startbefehl existiert:

Terminal

ls /Users/druckwerkstatt3d/fusion360-mcp-server/venv/bin/fusion360-mcp-server

Pfadhinweis:

Wenn dein Benutzername nicht

druckwerkstatt3d

lautet, ersetze diesen Teil des Pfades durch deinen eigenen Benutzernamen.
Alternativ kann auf macOS häufig auch

$HOME

verwendet werden.

5. Fusion Add-in installieren

Im Repository befindet sich der Ordner addon. Darin liegen typischerweise:

Dateien im Add-in-Ordner

Fusion360MCP.manifest
Fusion360MCP.py
server

Das Add-in muss in den Autodesk-Fusion-Add-in-Ordner kopiert werden. Auf macOS lautet der übliche Pfad:

macOS-Fusion-Add-in-Pfad

~/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/

Kopiere das Add-in mit:

Terminal

mkdir -p "$HOME/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/Fusion360MCP"

cp -R addon/* "$HOME/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/Fusion360MCP/"

Prüfen:

Terminal

ls "$HOME/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/Fusion360MCP"

Es sollten mindestens diese Dateien bzw. Ordner sichtbar sein:

Erwartete Ausgabe

Fusion360MCP.manifest
Fusion360MCP.py
server

6. Wenn Fusion das Add-in nicht anzeigt

Falls das Add-in in Fusion nicht sichtbar ist, kann es an einem leicht abweichenden Fusion-Pfad liegen. Manche Installationen verwenden auch:

Alternativer macOS-Pfad

~/Library/Application Support/Autodesk/Autodesk Fusion/API/AddIns/

In diesem Fall zusätzlich kopieren:

Terminal

mkdir -p "$HOME/Library/Application Support/Autodesk/Autodesk Fusion/API/AddIns/Fusion360MCP"

cp -R addon/* "$HOME/Library/Application Support/Autodesk/Autodesk Fusion/API/AddIns/Fusion360MCP/"

Danach Fusion komplett beenden und neu starten. Nicht nur das Fenster schließen, sondern Fusion wirklich beenden:

macOS

Fusion 360 → Quit Fusion 360
oder
Cmd + Q

7. Add-in in Fusion starten

Öffne Autodesk Fusion 360. Danach:

Fusion 360

UTILITIES → Scripts and Add-Ins → Add-Ins

Dort sollte Fusion360MCP erscheinen. Das Add-in auswählen und auf Run klicken. Optional kann Run on Startup aktiviert werden, damit das Add-in bei jedem Fusion-Start automatisch geladen wird.

8. Claude Desktop konfigurieren

Claude Desktop nutzt für lokale MCP-Server eine JSON-Konfigurationsdatei. Auf macOS liegt sie normalerweise hier:

macOS-Claude-Config

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop kann die Datei auch über die Oberfläche öffnen:

Claude Desktop

Claude → Settings → Developer → Edit Config

9. Claude-Config für macOS eintragen

Wichtig: Der Pfad muss zum eigenen Benutzerkonto passen.

Beispiel für den Mac-Benutzer druckwerkstatt3d:

claude_desktop_config.json

{
  "mcpServers": {
    "fusion360": {
      "command": "/Users/druckwerkstatt3d/fusion360-mcp-server/venv/bin/fusion360-mcp-server",
      "args": ["--mode", "socket"]
    }
  }
}

Allgemeine Vorlage:

claude_desktop_config.json

{
  "mcpServers": {
    "fusion360": {
      "command": "/Users/DEIN_BENUTZERNAME/fusion360-mcp-server/venv/bin/fusion360-mcp-server",
      "args": ["--mode", "socket"]
    }
  }
}

Wichtig bei bestehender Claude-Config:

Falls in der Datei bereits ein Bereich wie

„preferences“

vorhanden ist,
darf kein zweiter JSON-Block darunter eingefügt werden. Die Datei muss immer ein einziger gültiger JSON-Block sein.

Beispiel mit bestehenden Einstellungen:

claude_desktop_config.json

{
  "preferences": {
    "coworkWebSearchEnabled": true
  },
  "mcpServers": {
    "fusion360": {
      "command": "/Users/druckwerkstatt3d/fusion360-mcp-server/venv/bin/fusion360-mcp-server",
      "args": ["--mode", "socket"]
    }
  }
}

10. Claude neu starten

Nach jeder Änderung an claude_desktop_config.json muss Claude Desktop vollständig beendet und neu gestartet werden.

Claude Desktop

Claude → Quit Claude

Danach Claude erneut öffnen. Fusion 360 sollte geöffnet sein und das Add-in Fusion360MCP sollte laufen.

11. Verbindung testen

In Claude Desktop kann man zum Beispiel schreiben:

Prompt für Claude

Prüfe die Verbindung zu Fusion 360 und liste die verfügbaren Fusion-Tools auf.

Ein erfolgreicher Test zeigt typischerweise, dass der Ping-Befehl mit pong: true beantwortet wurde und Claude die verfügbaren Fusion-Werkzeuge auflistet.

Teil 2: Installation auf Windows

1. Voraussetzungen installieren

Auf Windows werden benötigt:

• Autodesk Fusion 360
• Claude Desktop für Windows
• Python 3.10 oder neuer, empfohlen Python 3.11+
• Git for Windows
• PowerShell

Python prüfen:

PowerShell

python --version

Falls Python nicht gefunden wird, Python von python.org installieren und beim Setup die Option Add Python to PATH aktivieren.

Git prüfen:

PowerShell

git --version

2. Repository herunterladen

PowerShell öffnen und zum Benutzerordner wechseln:

PowerShell

cd $HOME
git clone https://github.com/faust-machines/fusion360-mcp-server.git
cd fusion360-mcp-server

Der Projektordner liegt danach zum Beispiel unter:

Windows-Pfad

C:\Users\druckwerkstatt3d\fusion360-mcp-server

Bei anderen Nutzern muss druckwerkstatt3d durch den eigenen Windows-Benutzernamen ersetzt werden.

3. Virtuelle Python-Umgebung erstellen

In PowerShell:

PowerShell

python -m venv venv
.\venv\Scripts\Activate.ps1

Falls PowerShell die Aktivierung blockiert, kann vorübergehend die Ausführungsrichtlinie für den aktuellen Benutzer angepasst werden:

PowerShell

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Dann erneut aktivieren:

PowerShell

.\venv\Scripts\Activate.ps1

Prüfen:

PowerShell

python --version

4. MCP-Server installieren

Im Projektordner:

PowerShell

pip install -e .

Danach prüfen:

PowerShell

pip list

In der Liste sollte fusion360-mcp-server erscheinen.

Außerdem sollte die Startdatei existieren:

PowerShell

Test-Path "$HOME\fusion360-mcp-server\venv\Scripts\fusion360-mcp-server.exe"

Wenn PowerShell True ausgibt, ist der Server korrekt installiert.

5. Fusion Add-in installieren

Das Add-in liegt im Repository im Ordner addon.

Der übliche Windows-Zielpfad ist:

Windows-Fusion-Add-in-Pfad

%APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP

In PowerShell:

PowerShell

New-Item -ItemType Directory -Force "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"

Copy-Item -Recurse -Force ".\addon\*" "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP\"

Prüfen:

PowerShell

Get-ChildItem "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"

Es sollten erscheinen:

Erwartete Ausgabe

Fusion360MCP.manifest
Fusion360MCP.py
server

6. Add-in in Fusion starten

Autodesk Fusion 360 öffnen. Danach:

Fusion 360

Shift + S → Add-Ins → Fusion360MCP → Run

Alternativ über die Oberfläche:

Fusion 360

UTILITIES → Scripts and Add-Ins → Add-Ins → Fusion360MCP → Run

Optional Run on Startup aktivieren.

7. Claude Desktop auf Windows konfigurieren

Die Claude-Config liegt auf Windows normalerweise hier:

Windows-Claude-Config

%APPDATA%\Claude\claude_desktop_config.json

Öffnen über den Ausführen-Dialog:

Windows

Windows-Taste + R
%APPDATA%\Claude

Dort die Datei öffnen oder erstellen:

Dateiname

claude_desktop_config.json

Alternativ in Claude Desktop:

Claude Desktop

Claude → Settings → Developer → Edit Config

8. Claude-Config für Windows eintragen

Wichtig: In JSON müssen Windows-Pfade entweder mit doppelten Backslashes geschrieben werden oder man verwendet normale Slashes.

Empfohlene Variante mit normalen Slashes:

claude_desktop_config.json

{
  "mcpServers": {
    "fusion360": {
      "command": "C:/Users/druckwerkstatt3d/fusion360-mcp-server/venv/Scripts/fusion360-mcp-server.exe",
      "args": ["--mode", "socket"]
    }
  }
}

Alternative mit doppelten Backslashes:

claude_desktop_config.json

{
  "mcpServers": {
    "fusion360": {
      "command": "C:\\Users\\druckwerkstatt3d\\fusion360-mcp-server\\venv\\Scripts\\fusion360-mcp-server.exe",
      "args": ["--mode", "socket"]
    }
  }
}

Nicht korrekt wäre:

Falsches JSON-Beispiel

{
  "command": "C:\Users\druckwerkstatt3d\fusion360-mcp-server\venv\Scripts\fusion360-mcp-server.exe"
}

Denn einfache Backslashes können in JSON als Escape-Zeichen interpretiert werden.

9. Windows-Pfad prüfen

Vor dem Eintragen kann man den Pfad in PowerShell prüfen:

PowerShell

Test-Path "$HOME\fusion360-mcp-server\venv\Scripts\fusion360-mcp-server.exe"

Wenn True erscheint, den vollständigen Pfad ausgeben:

PowerShell

Resolve-Path "$HOME\fusion360-mcp-server\venv\Scripts\fusion360-mcp-server.exe"

Diesen Pfad dann in die Claude-Config übernehmen.

10. Claude neu starten

Nach dem Speichern der Config:

1. Claude Desktop vollständig beenden.
2. Fusion 360 öffnen.
3. Fusion360MCP Add-in starten.
4. Claude Desktop erneut öffnen.

Dann in Claude testen:

Prompt für Claude

Prüfe die Verbindung zu Fusion 360 und liste die verfügbaren Fusion-Tools auf.

Bei erfolgreicher Verbindung sollte Claude die verfügbaren Fusion-Werkzeuge anzeigen.

Alternative Installation mit uvx

Der MCP-Server kann auch über uvx gestartet werden:

Terminal / PowerShell

uvx fusion360-mcp-server --mode socket

Für Claude Desktop kann das zum Beispiel so aussehen:

claude_desktop_config.json

{
  "mcpServers": {
    "fusion360": {
      "command": "uvx",
      "args": ["fusion360-mcp-server", "--mode", "socket"]
    }
  }
}

Häufige Fehler und Lösungen

Fehler: Claude meldet „Server disconnected“

Mögliche Ursachen:

• Fusion 360 ist nicht geöffnet.
• Das Add-in Fusion360MCP wurde nicht gestartet.
• Der Pfad in claude_desktop_config.json ist falsch.
• Der JSON-Inhalt der Config ist ungültig.
• Der MCP-Server startet, findet aber das Fusion-Add-in nicht.

Lösung:

1. Fusion öffnen.
2. Add-in Fusion360MCP starten.
3. Claude komplett neu starten.
4. Pfad in der Config prüfen.
5. In Claude die Developer Logs öffnen.

Fehler: JSON kann nicht gelesen werden

Typischer Fehler:

Fehlermeldung

Unexpected non-whitespace character after JSON

Das passiert, wenn in claude_desktop_config.json zwei JSON-Blöcke hintereinander stehen.

Falsch:

Falsch

{
  "preferences": {}
}
{
  "mcpServers": {}
}

Richtig:

Richtig

{
  "preferences": {},
  "mcpServers": {}
}

Die Datei darf immer nur einen äußeren { … } Block haben.

Fehler: Add-in ist in Fusion nicht sichtbar

Prüfen, ob die Dateien wirklich im richtigen Ordner liegen.

macOS:

Terminal

ls "$HOME/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/Fusion360MCP"

Windows PowerShell:

PowerShell

Get-ChildItem "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"

Erwartet:

Erwartete Ausgabe

Fusion360MCP.manifest
Fusion360MCP.py
server

Wenn Fusion das Add-in trotzdem nicht anzeigt:

• Fusion komplett beenden und neu starten.
• Prüfen, ob der Zielordner wirklich Fusion360MCP heißt.
• Prüfen, ob die Datei Fusion360MCP.manifest vorhanden ist.
• In Fusion über Scripts and Add-Ins manuell nach dem Add-in suchen.

Fehler: MCP-Server läuft im Terminal scheinbar „hängend“

Das ist normal.

Ein MCP-Server über stdio wartet auf JSON-Nachrichten des MCP-Clients. Wenn man ihn manuell im Terminal startet, wirkt es so, als würde nichts passieren.

Wichtig:

In ein laufendes MCP-Server-Terminal keine normalen Befehle eintippen.
Der Server erwartet JSON-Daten vom Client und würde normale Texteingaben als ungültiges JSON interpretieren.

Verbindungstest

Der beste erste Test in Claude lautet:

Prompt für Claude

Prüfe, ob du mit Fusion 360 verbunden bist. Nutze ping und liste danach die verfügbaren Fusion-Tools auf.

Bei erfolgreicher Einrichtung sollte Claude eine Antwort ähnlich dieser liefern:

Erwartete Antwort

Die Verbindung zu Fusion 360 steht. Ping wurde erfolgreich beantwortet.

Außerdem sollte Claude die verfügbaren Werkzeuge auflisten, zum Beispiel Werkzeuge für Skizzen, Extrusionen, Körper, Komponenten, Parameter, Messungen, Exportfunktionen und CAM-Funktionen.

Wichtige Hinweise zu Pfaden

Die Pfade in dieser Anleitung sind Beispiele. Nutzer müssen sie an ihren eigenen Benutzernamen und Installationsort anpassen.

macOS-Beispiel

macOS-Beispielpfad

/Users/druckwerkstatt3d/fusion360-mcp-server/venv/bin/fusion360-mcp-server

Allgemein:

macOS-Vorlage

/Users/DEIN_BENUTZERNAME/fusion360-mcp-server/venv/bin/fusion360-mcp-server

Windows-Beispiel

Windows-Beispielpfad

C:/Users/druckwerkstatt3d/fusion360-mcp-server/venv/Scripts/fusion360-mcp-server.exe

Allgemein:

Windows-Vorlage

C:/Users/DEIN_BENUTZERNAME/fusion360-mcp-server/venv/Scripts/fusion360-mcp-server.exe

Kurzfassung

macOS

Terminal

cd ~
git clone https://github.com/faust-machines/fusion360-mcp-server.git
cd fusion360-mcp-server

python3.11 -m venv venv
source venv/bin/activate
pip install -e .

mkdir -p "$HOME/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/Fusion360MCP"
cp -R addon/* "$HOME/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/Fusion360MCP/"

Claude Config:

claude_desktop_config.json

{
  "mcpServers": {
    "fusion360": {
      "command": "/Users/druckwerkstatt3d/fusion360-mcp-server/venv/bin/fusion360-mcp-server",
      "args": ["--mode", "socket"]
    }
  }
}

Windows

PowerShell

cd $HOME
git clone https://github.com/faust-machines/fusion360-mcp-server.git
cd fusion360-mcp-server

python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -e .

New-Item -ItemType Directory -Force "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"
Copy-Item -Recurse -Force ".\addon\*" "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP\"

Claude Config:

claude_desktop_config.json

{
  "mcpServers": {
    "fusion360": {
      "command": "C:/Users/druckwerkstatt3d/fusion360-mcp-server/venv/Scripts/fusion360-mcp-server.exe",
      "args": ["--mode", "socket"]
    }
  }
}

Ergebnis

Nach erfolgreicher Einrichtung kann Claude Desktop direkt mit Autodesk Fusion 360 kommunizieren.
Claude kann dann über MCP CAD-Werkzeuge aufrufen, Skizzen erstellen, Körper modellieren, Parameter verwalten,
Maße abfragen und Modelle exportieren.