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:

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:

brew install python@3.11

Danach prüfen:

python3.11 --version

2. Repository herunterladen

Wechsle in dein Benutzerverzeichnis und klone das Repository:

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

Der Projektordner liegt danach beispielhaft unter:

/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:

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

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

python3 -m venv venv
source venv/bin/activate

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

python --version

4. MCP-Server installieren

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

pip install -e .

Prüfe danach, ob das Paket installiert wurde:

pip list

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

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

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

5. Fusion Add-in installieren

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

Fusion360MCP.manifest
Fusion360MCP.py
server

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

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

Kopiere das Add-in mit:

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:

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

Es sollten mindestens diese Dateien bzw. Ordner sichtbar sein:

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:

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

In diesem Fall zusätzlich kopieren:

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:

Fusion 360 → Quit Fusion 360
oder
Cmd + Q

7. Add-in in Fusion starten

Öffne Autodesk Fusion 360. Danach:

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:

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

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

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:

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

Allgemeine Vorlage:

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

Beispiel mit bestehenden Einstellungen:

{
  "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 → 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:

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:

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:

git --version

2. Repository herunterladen

PowerShell öffnen und zum Benutzerordner wechseln:

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

Der Projektordner liegt danach zum Beispiel unter:

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:

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:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Dann erneut aktivieren:

.\venv\Scripts\Activate.ps1

Prüfen:

python --version

4. MCP-Server installieren

Im Projektordner:

pip install -e .

Danach prüfen:

pip list

In der Liste sollte fusion360-mcp-server erscheinen.

Außerdem sollte die Startdatei existieren:

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:

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

In 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:

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

Es sollten erscheinen:

Fusion360MCP.manifest
Fusion360MCP.py
server

6. Add-in in Fusion starten

Autodesk Fusion 360 öffnen. Danach:

Shift + S → Add-Ins → Fusion360MCP → Run

Alternativ über die Oberfläche:

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:

%APPDATA%\Claude\claude_desktop_config.json

Öffnen über den Ausführen-Dialog:

Windows-Taste + R
%APPDATA%\Claude

Dort die Datei öffnen oder erstellen:

claude_desktop_config.json

Alternativ in 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:

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

Alternative mit doppelten Backslashes:

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

Nicht korrekt wäre:

{
  "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:

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

Wenn True erscheint, den vollständigen Pfad ausgeben:

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:

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:

uvx fusion360-mcp-server --mode socket

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

{
  "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:

Unexpected non-whitespace character after JSON

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

Falsch:

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

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:

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

Windows PowerShell:

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

Erwartet:

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.

Verbindungstest

Der beste erste Test in Claude lautet:

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:

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

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

Allgemein:

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

Windows-Beispiel

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

Allgemein:

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

Kurzfassung

macOS

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:

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

Windows

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:

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

Ergebnis