154 lines
9.9 KiB
Markdown
154 lines
9.9 KiB
Markdown
# Claude-Werkzeuge einrichten
|
||
|
||
Mit dieser Anleitung kann Claude auf deinem Rechner Word-Dokumente, Excel-Tabellen, PDFs, Oberflächen-Entwürfe, Vektorgrafiken 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` |
|
||
|
||
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).
|
||
|
||
## 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. Der MCP-Server läuft ohne Fenster und bekommt zwei Argumente `--allow-path` (Lese-Ordner und Schreib-Ordner). Kein `--connect`, kein `--allow-any-path`. Skill-Version: **0.2.0**.
|
||
|
||
---
|
||
|
||
## 2. Dateien herunterladen
|
||
|
||
Lade die passende Version herunter (WordCraft und GridCraft **0.3.0**, PdfCraft, FigCraft und VectorCraft **0.1.0**, SolidCraft **0.2.0**):
|
||
|
||
- [wordcraft-mcp-v0.3.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.mcpb) und [wordcraft-mcp-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.zip)
|
||
- [gridcraft-mcp-v0.3.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-v0.3.0.mcpb) und [gridcraft-mcp-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-v0.3.0.zip)
|
||
- [pdfcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.1.0/pdfcraft-mcp-v0.1.0.mcpb) und [pdfcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.1.0/pdfcraft-mcp-v0.1.0.zip)
|
||
- [figcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.1.0/figcraft-mcp-v0.1.0.mcpb) und [figcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.1.0/figcraft-mcp-v0.1.0.zip)
|
||
- [vectorcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-v0.1.0.mcpb) und [vectorcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-v0.1.0.zip)
|
||
- [solidcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.2.0/solidcraft-mcp-v0.2.0.mcpb) und [solidcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.2.0/solidcraft-mcp-v0.2.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 und SolidCraft** fragen nach zwei Ordnern. GridCraft 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. Fehlt ein Ordner, kann der Agent dort nicht speichern. Der Server startet ohne Fenster und 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` und `solidcraft-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 Args sind zwei `--allow-path`, kein `--connect`. |
|
||
| 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.
|
||
|
||
## Entfernen
|
||
|
||
Einstellungen → Erweiterungen → Erweiterung entfernen; Skills in der Skill-Liste löschen.
|