Files
claude-skills/docs/INSTALLATION.md
T
Dominic Gundel 2c02038e8c Do not bundle CLIs in MCPB packages.
Point extensions at ArtCraft Launcher installs and require WordCraft/GridCraft on the machine.
2026-10-19 16:15:08 +02:00

109 lines
5.2 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 für Claude**) und Excel-Tabellen (über **GridCraft für 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)
- **ArtCraft-Launcher:** darüber **WordCraft** und **GridCraft** installieren (legt die Programme nach `C:\Program Files\WordCraft\` bzw. `C:\Program Files\GridCraft\`). Die Claude-Erweiterung enthält die Programme **nicht**.
- Ein eigener Ordner, in den Claude speichern darf, z. B. `Dokumente\Claude-Ausgabe`. Leg ihn jetzt an.
---
## 1. Dateien herunterladen
Öffne die Releases-Seite: **https://git.gundel.dev/dg/claude-skills/releases**
Lade jeweils die neueste Version herunter:
- `wordcraft-mcp-vX.Y.Z.mcpb` und `wordcraft-mcp-vX.Y.Z.zip`
- `gridcraft-mcp-vX.Y.Z.mcpb` und `gridcraft-mcp-vX.Y.Z.zip`
Die ZIP-Dateien **nicht entpacken**.
---
## 2. 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 für Claude** fragt Claude nach zwei Ordnern:
- **Lese-Ordner:** Hier darf Claude Dokumente lesen, z. B. `Dokumente`.
- **Schreib-Ordner:** Nur hier darf Claude speichern – deinen Ordner `Dokumente\Claude-Ausgabe` wählen. Nicht denselben wie den Lese-Ordner, dann bleiben deine Originale sicher.
5. Installieren. Die Erweiterung erscheint unter Einstellungen → Erweiterungen und muss **eingeschaltet** sein.
> **Windows meldet „Der Computer wurde durch Windows geschützt“ oder Defender schlägt an?**
> Die Erweiterungen sind nicht signiert. Wende dich an Dominic, bevor du die Warnung übergehst.
---
## 3. 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`.
---
## 4. Claude neu starten
Claude **komplett beenden** – auch das Symbol unten rechts in der Taskleiste (Rechtsklick → Beenden) – und wieder öffnen.
---
## 5. Testen
Neuen Chat öffnen 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.
---
## 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 | ArtCraft-Launcher: Sind WordCraft bzw. GridCraft installiert? Einstellungen → Erweiterungen: Ist die Erweiterung eingeschaltet? Dann Claude komplett beenden (auch Taskleiste) und neu starten. |
| WordCraft speichert nicht („path rejected“) | Claude wollte außerhalb des Schreib-Ordners speichern. Ordner prüfen: Einstellungen → Erweiterungen → WordCraft für 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 von der Releases-Seite 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.