← zum Handbuch Projektseite

Betrieb und Hilfe

Aktualisieren, zu einer früheren Version zurückkehren, sich nach einem Fehler in CATIA helfen, Probleme melden und CadPilot wieder entfernen – alles ohne Administratorrechte.

Stand: 26.09.2026 · Einrichtung: Handbuch, Kapitel 4 · erster Test: Live-Test-Anleitung

1. Welche Version läuft?

In einer Eingabeaufforderung im CadPilot-Ordner:

.venv\Scripts\python.exe -c "import catia_mcp; print(catia_mcp.__version__)"

Die Einrichtung (scripts\setup_user.cmd) endet außerdem mit ALL TESTS PASSED — 103 tools ready; die Zahl der Werkzeuge ändert sich mit neuen Versionen. Was sich in welcher Version geändert hat, steht in den Neuigkeiten.

2. Auf eine neue Version aktualisieren

ZIP-Datei holen: CadPilot-<Version>.zip (von Martin oder aus dem Release im Repository).
In einen neuen Ordner neben dem alten entpacken, z. B. C:\Users\<Name>\CadPilot-0.4.0. Den alten Ordner nicht überschreiben – er ist Ihr Rückweg.
Einrichten: im neuen Ordner scripts\setup_user.cmd per Doppelklick. Der Arbeitsordner bleibt derselbe; Ihre Arbeitskopien bleiben erhalten.
Umschalten: in VS Code „Datei → Ordner öffnen“ mit dem neuen Ordner, dann „MCP: List Servers“ → catia-v5 → Start.

Mit Git statt ZIP: git pull im Ordner, danach scripts\setup_user.cmd erneut ausführen.

Ab 0.5.0: Das strukturierte Ergebnisformat (v2) ist Standard. Wer mit dem Einrichtungsskript arbeitet, merkt nichts – es hat v2 schon vorher gesetzt. Nur ein eigenes Programm, das die alten Textantworten auswertet, braucht "CATIA_MCP_RESULT_FORMAT": "v1" in der mcp.json.

3. Zu einer früheren Version zurück

Jede Version hat ihren eigenen Ordner mit eigener Python-Umgebung und eigener Server-Einstellung. Zurück heißt deshalb nur: den alten Ordner in VS Code öffnen und den Server dort starten. Mit Git: git checkout v0.3.0 (gewünschte Version) und scripts\setup_user.cmd.

4. Wenn in CATIA etwas schiefgeht

Situation	Was hilft
Letzter Schritt war falsch	Copilot bitten: „Zeig das Journal“ und „Mach die letzte Änderung rückgängig“ (`catia_journal_list`, `catia_undo_last`). Geht für Parameteränderungen und neue Features, nur für den letzten Schritt und nur, solange nichts darauf aufbaut.
Werkstoff, Eigenschaften, neue Parameter oder Formeln sollen zurück	Nicht über das Journal. Die alten Werte stehen im Ergebnis des Werkzeugs – in CATIA von Hand zurücksetzen.
Sorge um die Originaldatei	Im Schutzmodus (Standard) werden Originale nie überschrieben; gespeichert wird nur im Arbeitsordner `%USERPROFILE%\CATIA_MCP_Work`. Im Zweifel die Arbeitskopie löschen und neu vom Original anlegen.
Meldung `COM_TIMEOUT` oder `SESSION_BLOCKED`	CATIA zeigt vermutlich einen Dialog – in CATIA nachsehen und schließen. Bis dahin nimmt CadPilot absichtlich keine neuen Befehle an.
CATIA reagiert gar nicht mehr	CATIA im Task-Manager beenden (ungespeicherte Arbeit geht verloren), neu starten, dann in VS Code „MCP: List Servers“ → `catia-v5` → Restart.
Copilot verwendet falsche Parameter	CadPilot lehnt unbekannte Parameter ab und nennt die erlaubten; Copilot korrigiert das in der Regel selbst.

5. Häufige Einrichtungsprobleme

Meldung	Ursache / Lösung
„Kein passendes Python … gefunden“	Python im Benutzerprofil installieren (Handbuch, Kapitel 4), Eingabeaufforderung neu öffnen.
„Ungültige Klassenzeichenfolge“ / „Invalid class string“	CATIA ist nicht für die Automation registriert – einmalig durch die IT.
„Programm durch Gruppenrichtlinien blockiert“	Python im Benutzerprofil ist gesperrt (AppLocker) – nur über die IT lösbar.
Copilot zeigt keine CATIA-Werkzeuge	Agent-Modus gewählt? Server gestartet? Bei Firmen-Copilot: Richtlinie „MCP servers in Copilot“.
„Failed to connect to CATIA V5“	CATIA vorher starten; CATIA und VS Code beide ohne „Als Administrator“.

Die vollständige Tabelle mit Proxy, Offline-Installation und Firmenrichtlinien steht in der Anleitung im Projekt (docs\ANLEITUNG_COPILOT.md) und in der Live-Test-Anleitung.

6. Ein Problem melden

Bitte schicken:

die Version (Abschnitt 1) und die genaue Meldung, am besten als Bildschirmfoto des Chats,
den Umgebungsbericht: .venv\Scripts\python.exe scripts\live_env_report.py --catia --out umgebung.json – er enthält Windows-, Python- und CATIA-Version sowie die freigeschalteten Lizenzen, aber keinen Dokumentnamen,
die Protokolldatei catia_mcp.log aus dem CadPilot-Ordner – im Schutzmodus ohne Pfade und Werte.

Bitte keine CAD-Dateien, Kunden- oder Projektdaten schicken.

7. CadPilot wieder entfernen

In VS Code den Server stoppen („MCP: List Servers“ → catia-v5 → Stop).
Den CadPilot-Ordner löschen – er enthält auch die Python-Umgebung und die Server-Einstellung.
Den Arbeitsordner %USERPROFILE%\CATIA_MCP_Work prüfen, Arbeitskopien sichern, dann löschen.
Optional: Python über „Apps und Features“ deinstallieren und den Zwischenspeicher %LOCALAPPDATA%\pip\Cache löschen.

CadPilot legt keine Dienste, Autostart- oder Registry-Einträge an und installiert nichts außerhalb dieser Ordner.