Add Claude Desktop extensions (.mcpb) for WordCraft and GridCraft.

Ship unsigned MCPB packages built from the ArtCraft Launcher CLIs, with install docs and skill 0.2.0 updates.
2026-10-19 16:07:21 +02:00
1 parent 3ac6cd5a29
commit 2fd4164ee7
@@ -0,0 +1,109 @@
+# 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)
+- Ein eigener Ordner, in den Claude speichern darf, z. B. `Dokumente\Claude-Ausgabe`. Leg ihn jetzt an.
+
+WordCraft oder GridCraft selbst musst du **nicht** installieren – das Nötige steckt in der Erweiterung.
+
+---
+
+## 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 | 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.
@@ -2,6 +2,8 @@

 [Alle Skills](../README.md)

+**Standardweg:** [INSTALLATION.md](INSTALLATION.md) (Erweiterung `.mcpb` + Skill-ZIP). Diese Seite gilt nur für die manuelle Einrichtung ohne Erweiterung.
+
 Gilt für Skills, die einen lokalen MCP-Server in Claude Desktop eintragen: [wordcraft-mcp](../skills/wordcraft-mcp/README.md), [gridcraft-mcp](../skills/gridcraft-mcp/README.md). Der Pfad zur jeweiligen Programmdatei und die Argumente stehen in der README des Skills.

 ## Ort der Config