Files
claude-skills/docs/INSTALLATION.md
T

119 lines
6.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Claude-Werkzeuge für Word und Excel einrichten
Mit dieser Anleitung kann Claude Word-Dokumente (über **WordCraft for Claude**) und Excel-Tabellen (über **GridCraft for Claude**) direkt auf deinem Rechner erstellen und bearbeiten. Dauer: etwa 10 Minuten. 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 **WordCraft** und **GridCraft**. Den Standardpfad nicht ändern: `C:\Program Files\WordCraft` bzw. `C:\Program Files\GridCraft`. Die Claude-Erweiterung enthält die Programme **nicht**.
(Installer auch unter [GitHub Releases](https://github.com/storytold/craft-launcher/releases).)
---
## 2. Dateien herunterladen
Lade jeweils die Version **0.3.0** herunter:
- [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)
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. **Nur bei WordCraft for Claude** fragt Claude nach zwei Ordnern:
- **Lese-Ordner (weit):** z. B. `Dokumente` oder der Benutzerordner. Lesen ist per Freigabe-Dialog kontrollierbar.
- **Schreib-Ordner (eng):** nur hier darf Claude speichern – z. B. `Dokumente\Claude`. Nicht denselben wie den Lese-Ordner.
5. Installieren. Die Erweiterung erscheint unter Einstellungen → Erweiterungen.
**Danach unter Einstellungen → Erweiterungen prüfen, dass beide 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` und `gridcraft-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 WordCraft- und GridCraft-Werkzeuge verfügbar? Leg zum Test eine kleine Excel-Tabelle mit drei Zeilen in meinem Claude-Ausgabeordner an.
Claude sollte beide Werkzeuge finden und eine `.xlsx`-Datei im Ausgabeordner speichern. Beim ersten Mal fragt Claude, ob es die Werkzeuge benutzen darf – erlauben. Die Werkzeuge heißen mit Präfix `…WordCraft_for_Claude…` bzw. `…GridCraft_for_Claude…`.
Lass bei WordCraft `open_document` / `save_document` und bei GridCraft `open_workbook` / `save_workbook` / `execute_command` 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\WordCraft\wordcraft-cli.exe` (bzw. `C:\Program Files\GridCraft\gridcraft-cli.exe`) existiert; sonst über den ArtCraft-Launcher installieren. |
| WordCraft speichert nicht („path rejected“) | Claude wollte außerhalb des Schreib-Ordners speichern. Ordner prüfen: Einstellungen → Erweiterungen → WordCraft for Claude → Einstellungen. |
| 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.