160 lines
11 KiB
Markdown
160 lines
11 KiB
Markdown
# Claude-Werkzeuge einrichten
|
||
|
||
Mit dieser Anleitung kann Claude auf deinem Rechner Word-Dokumente, Excel-Tabellen, PDFs, Oberflächen-Entwürfe, Vektorgrafiken, DXF/DWG, Compositings, Schnitte und parametrische 3D-Teile bearbeiten. Dauer: etwa 10 Minuten je Werkzeug. Du brauchst keine Programmierkenntnisse.
|
||
|
||
Für jedes Werkzeug installierst du zwei Dinge:
|
||
|
||
| Datei | Was sie ist | Wozu |
|
||
|---|---|---|
|
||
| `….mcpb` | **Erweiterung** für die Claude-App | gibt Claude die Werkzeuge (Datei öffnen, schreiben, speichern …) |
|
||
| `….zip` | **Skill** | Anleitung für Claude, wie man die Werkzeuge richtig benutzt |
|
||
|
||
Ohne Erweiterung kann Claude nichts tun, ohne Skill macht es mehr Fehler. Installiere also immer beides.
|
||
|
||
---
|
||
|
||
## Voraussetzungen
|
||
|
||
- Windows 10 oder 11
|
||
- **Claude Desktop** installiert und angemeldet (die App, nicht nur der Browser)
|
||
- Ein eigener **Schreib-Ordner**, z. B. `Dokumente\Claude`. Leg ihn jetzt an (eng halten). Der **Lese-Ordner** darf weit sein (z. B. ganzer Ordner Dokumente).
|
||
|
||
---
|
||
|
||
## 1. ArtCraft-Launcher und Apps installieren
|
||
|
||
Installiere den [ArtCraft-Launcher](https://getartcraft.com/apps) und darin die Apps, die du brauchst. Den Standardpfad nicht ändern. Die CLI liegt im Programmordner und ist **nicht** auf PATH. Die Claude-Erweiterung enthält die Programme **nicht**.
|
||
|
||
| App | Wofür | CLI |
|
||
|---|---|---|
|
||
| WordCraft | Word-Dokumente | `C:\Program Files\WordCraft\wordcraft-cli.exe` |
|
||
| GridCraft | Excel-Tabellen | `C:\Program Files\GridCraft\gridcraft-cli.exe` |
|
||
| PdfCraft | Schwärzen, Doku-Pakete | `C:\Program Files\PdfCraft\pdfcraft-cli.exe` |
|
||
| FigCraft | HMI-/Oberflächen-Entwürfe | `C:\Program Files\FigCraft\figcraft-cli.exe` |
|
||
| VectorCraft | Typenschilder, Schilder, DXF für Laser | `C:\Program Files\VectorCraft\vectorcraft-cli.exe` |
|
||
| CADCraft | DXF/DWG-Zeichnungen | `C:\Program Files\CADCraft\cadcraft-cli.exe` |
|
||
| EffectCraft | Compositing, .ecproj | `C:\Program Files\EffectCraft\effectcraft-cli.exe` |
|
||
| FilmCraft | Schnitt, .fcproj | `C:\Program Files\FilmCraft\filmcraft-cli.exe` |
|
||
|
||
FigCraft steht im Launcher seit Version **0.4.1**. Ältere Kataloge mit zwölf Apps führen es nicht. Fehlt die Kachel, den Launcher aktualisieren. Installer: [GitHub Releases](https://github.com/storytold/craft-launcher/releases). CADCraft, EffectCraft und FilmCraft sind am 26.10.2026 unter `C:\Program Files` installiert (Publisher Learning Machines LLC). Ob der Launcher dafür eine Kachel hat, ist nicht geprüft.
|
||
|
||
## 1b. SolidCraft installieren
|
||
|
||
SolidCraft wird getrennt vom ArtCraft-Launcher installiert. Installer: [GitHub Releases](https://github.com/tangency-labs/solidcraft/releases) (MSI) oder in der Konsole `winget install bherbruck.SolidCraft`. Den Standardpfad nicht ändern.
|
||
|
||
| App | Wofür | CLI |
|
||
|---|---|---|
|
||
| SolidCraft | parametrische 3D-Teile, STEP, STL, 3MF | `C:\Program Files\SolidCraft\solidcraft-cli.exe` |
|
||
|
||
Die CLI ist **nicht** auf PATH. Die Erweiterung enthält sie nicht. Die Erweiterung startet kopflos mit zwei `--allow-path` (Lese-Ordner und Schreib-Ordner), ohne `--connect` und ohne `--allow-any-path`. `--connect 127.0.0.1:PORT` ist ein anderer Start und braucht `solidcraft --control PORT`. `solvecraft-cli.exe` ist nur ein Alias. Skill-Version: **0.3.0**.
|
||
|
||
---
|
||
|
||
## 2. Dateien herunterladen
|
||
|
||
Lade die passende Version herunter (WordCraft und GridCraft **0.4.0**, PdfCraft, FigCraft und VectorCraft **0.2.0**, SolidCraft **0.3.0**, CADCraft, EffectCraft und FilmCraft **0.1.0**):
|
||
|
||
- [wordcraft-mcp-v0.4.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.4.0/wordcraft-mcp-v0.4.0.mcpb) und [wordcraft-mcp-v0.4.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.4.0/wordcraft-mcp-v0.4.0.zip)
|
||
- [gridcraft-mcp-v0.4.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.4.0/gridcraft-mcp-v0.4.0.mcpb) und [gridcraft-mcp-v0.4.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.4.0/gridcraft-mcp-v0.4.0.zip)
|
||
- [pdfcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-v0.2.0.mcpb) und [pdfcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-v0.2.0.zip)
|
||
- [figcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-v0.2.0.mcpb) und [figcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-v0.2.0.zip)
|
||
- [vectorcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.2.0/vectorcraft-mcp-v0.2.0.mcpb) und [vectorcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.2.0/vectorcraft-mcp-v0.2.0.zip)
|
||
- [solidcraft-mcp-v0.3.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.3.0/solidcraft-mcp-v0.3.0.mcpb) und [solidcraft-mcp-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.3.0/solidcraft-mcp-v0.3.0.zip)
|
||
- [cadcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/cadcraft-mcp%2Fv0.1.0/cadcraft-mcp-v0.1.0.mcpb) und [cadcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/cadcraft-mcp%2Fv0.1.0/cadcraft-mcp-v0.1.0.zip)
|
||
- [effectcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-v0.1.0.mcpb) und [effectcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-v0.1.0.zip)
|
||
- [filmcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/filmcraft-mcp%2Fv0.1.0/filmcraft-mcp-v0.1.0.mcpb) und [filmcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/filmcraft-mcp%2Fv0.1.0/filmcraft-mcp-v0.1.0.zip)
|
||
|
||
Die ZIP-Dateien **nicht entpacken**.
|
||
|
||
---
|
||
|
||
## 3. Erweiterungen installieren
|
||
|
||
Für jede `.mcpb`-Datei:
|
||
|
||
1. Claude Desktop öffnen.
|
||
2. Die `.mcpb`-Datei **doppelklicken** – oder sie ins Claude-Fenster ziehen.
|
||
*Klappt beides nicht:* Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ → Datei auswählen.
|
||
3. Es öffnet sich ein Installationsfenster. Angaben prüfen und bestätigen.
|
||
4. **WordCraft, PdfCraft, FigCraft, VectorCraft, EffectCraft und SolidCraft** fragen nach zwei Ordnern. GridCraft, CADCraft und FilmCraft nicht.
|
||
- **Lese-Ordner (weit):** `Dokumente`.
|
||
- **Schreib-Ordner (eng, und bei PdfCraft und VectorCraft darin):** `Dokumente\Claude`. PdfCraft und VectorCraft öffnen eigene Ergebnisse sonst nicht wieder. Bei FigCraft ist die Lage egal; denselben Standard verwenden.
|
||
- **SolidCraft:** beide Ordner ausfüllen. Jeder wird als `--allow-path` übergeben. Die Erweiterung startet ohne `--connect`.
|
||
5. Installieren. Die Erweiterung erscheint unter Einstellungen → Erweiterungen.
|
||
|
||
**Danach unter Einstellungen → Erweiterungen prüfen, dass die Erweiterungen eingeschaltet sind.** Frisch installierte Erweiterungen können ausgeschaltet sein.
|
||
|
||
> **Windows meldet „Der Computer wurde durch Windows geschützt“ oder Defender schlägt an?**
|
||
> Die Erweiterungen sind nicht signiert. Nur installieren, wenn du der Quelle vertraust.
|
||
|
||
---
|
||
|
||
## 4. Skills installieren
|
||
|
||
Für jede `.zip`-Datei:
|
||
|
||
1. In Claude auf **„+“** → **„Skill erstellen“** → **„Skill hochladen“**.
|
||
2. Die ZIP-Datei auswählen und bestätigen.
|
||
|
||
Die Skills heißen danach `wordcraft-mcp`, `gridcraft-mcp`, `pdfcraft-mcp`, `figcraft-mcp`, `vectorcraft-mcp`, `solidcraft-mcp`, `cadcraft-mcp`, `effectcraft-mcp` und `filmcraft-mcp`.
|
||
|
||
---
|
||
|
||
## 5. Claude neu starten
|
||
|
||
Claude **komplett beenden** – auch das Symbol unten rechts in der Taskleiste (Rechtsklick → Beenden) – und wieder öffnen.
|
||
|
||
---
|
||
|
||
## 6. Testen
|
||
|
||
Einen **neuen** Chat öffnen (offene Chats sehen neue Werkzeuge evtl. erst später) und eintippen:
|
||
|
||
> Sind die Werkzeuge verfügbar?
|
||
|
||
Je App ein kurzer Test:
|
||
|
||
- **PdfCraft:** ein Test-PDF schwärzen und `doc_audit_redactions` ausführen.
|
||
- **FigCraft:** eine kleine HMI-Maske als PNG exportieren.
|
||
- **VectorCraft:** ein Typenschild 100×50 mm als DXF exportieren und die Maße im CAD prüfen.
|
||
- **SolidCraft:** einen Quader 40×30×20 mm bauen und das Volumen prüfen lassen (24000 mm³).
|
||
- **GridCraft:** eine kleine Excel-Tabelle mit drei Zeilen im Ausgabeordner anlegen.
|
||
- **WordCraft:** ein kurzes Dokument im Schreib-Ordner speichern.
|
||
|
||
Beim ersten Mal fragt Claude, ob es die Werkzeuge benutzen darf – erlauben. Die Werkzeuge heißen mit Präfix `…PdfCraft_for_Claude…` (und entsprechend für die anderen Apps).
|
||
|
||
Lass bei WordCraft `open_document` / `save_document`, bei GridCraft `open_workbook` / `save_workbook` / `execute_command`, bei PdfCraft `doc_open` / `doc_save` / `tool_call`, bei FigCraft und VectorCraft `open_file` / `save_file` / `export` und bei SolidCraft `open` / `save` / `export` auf **„Immer fragen“**, wenn du Pfade mitkontrollieren willst.
|
||
|
||
---
|
||
|
||
## Sicher arbeiten – bitte lesen
|
||
|
||
- **GridCraft hat keine Ordnersperre.** Anders als WordCraft kann es jede Datei öffnen und speichern, auf die du Zugriff hast. Lass in Claude bei den GridCraft-Werkzeugen **`save_workbook`**, **`open_workbook`** und **`execute_command`** auf **„Immer fragen“** und lies vor dem Bestätigen den Dateipfad.
|
||
- **Nenne Claude die Datei genau** („öffne `Dokumente\Angebote\A-2026-112.xlsx`“). Claude speichert Änderungen immer unter neuem Namen; das Original bleibt unberührt.
|
||
- **Ergebnis in Word/Excel ansehen**, bevor es an Kunden geht. WordCraft und GridCraft sind Nachbauten; das allermeiste klappt, aber nicht alles.
|
||
- Kundendaten nur in dem Umfang verwenden, den unsere Datenschutzregeln erlauben.
|
||
|
||
---
|
||
|
||
## Probleme?
|
||
|
||
| Problem | Lösung |
|
||
|---|---|
|
||
| Claude sagt, die Werkzeuge fehlen | Einstellungen → Erweiterungen: ist die Erweiterung eingeschaltet? Einschalten, dann neuen Chat öffnen. |
|
||
| Werkzeuge fehlen, Erweiterung ist eingeschaltet | Prüfen, ob `C:\Program Files\<App>\<app>-cli.exe` existiert; sonst über den ArtCraft-Launcher installieren. |
|
||
| SolidCraft: Werkzeuge fehlen, Erweiterung ist eingeschaltet | `C:\Program Files\SolidCraft\solidcraft-cli.exe` prüfen. Sonst den eigenen Installer (MSI oder `winget install bherbruck.SolidCraft`). |
|
||
| SolidCraft speichert die Datei nicht | Beide Ordner im Dialog gesetzt? Die Erweiterung übergibt zwei `--allow-path`. Steht in der Config `--connect`, muss die App mit `solidcraft --control` auf demselben Port lauschen. |
|
||
| Speichern scheitert („path rejected“) | Ziel lag außerhalb des Schreib-Ordners, oder (PdfCraft, VectorCraft) der Schreib-Ordner liegt nicht im Lese-Ordner. Einstellungen → Erweiterungen → die App → Einstellungen. |
|
||
| FigCraft fehlt im Launcher | Launcher auf 0.4.1 oder neuer aktualisieren. |
|
||
| Excel-Formeln zeigen `#NAME?` | Claude hat deutsche Funktionsnamen benutzt. Sagen: „Nutze englische Formeln, wie im Skill beschrieben.“ |
|
||
| Zahlen sehen im Chat wie `1,450.00 €` aus | Normal. In Excel erscheinen sie richtig als `1.450,00 €`. |
|
||
| Doppelklick auf `.mcpb` tut nichts | Über Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ gehen. |
|
||
|
||
## Aktualisieren
|
||
|
||
Neue Version laden, `.mcpb` erneut installieren und die neue Skill-ZIP hochladen. Fragt Claude, ob die bestehende Version ersetzt werden soll: ja. Danach Claude neu starten. Claude holt diese Skills nicht von selbst aus dem Repo; es gibt keinen Sync.
|
||
|
||
## Entfernen
|
||
|
||
Einstellungen → Erweiterungen → Erweiterung entfernen; Skills in der Skill-Liste löschen.
|