Skills als eigene Bereiche dokumentieren und das ZIP über ein Gitea-Release ausliefern.

2026-10-19 15:29:26 +02:00
1 parent b57c458919
commit 55e93e7660
@@ -1,5 +1,9 @@
 # Changelog – wordcraft-mcp

+## 0.1.1 (2026-10-19)
+
+- Doku: eigene README mit Windows-Stolpersteinen; ZIP über Release.
+
 ## 0.1.0 (2026-10-19)

 - Erste Version, getestet mit WordCraft 0.8.0 (headless, `--automation-read-root` / `--automation-write-root`).
@@ -0,0 +1,73 @@
+# wordcraft-mcp
+
+[Alle Skills](../../README.md)
+
+## Zweck
+
+Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung von Änderungen und der Fallen, die beim Praxistest mit WordCraft 0.8.0 aufgefallen sind. Die Anweisungen für Claude stehen in [SKILL.md](SKILL.md).
+
+## Voraussetzungen
+
+- WordCraft mit `wordcraft-cli` ist installiert.
+- Der MCP-Server ist in der `claude_desktop_config.json` eingetragen und über `--automation-read-root` und `--automation-write-root` auf Ordner beschränkt.
+- Der Ordner aus `--automation-write-root` existiert bereits.
+- Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren, damit Claude `wordcraft-mcp` verwendet.
+
+## Installation
+
+Git ist nicht nötig.
+
+1. Das ZIP [wordcraft-mcp-v0.1.1.zip](https://git.gundel.dev/dg/claude-skills/releases/tag/wordcraft-mcp/v0.1.1) aus dem Release laden.
+2. In Claude **„+“ → „Skill erstellen“ → „Skill hochladen“** wählen und das ZIP hochladen.
+
+## Einrichtung
+
+In die bestehende `claude_desktop_config.json` nur den Block `mcpServers` einfügen. Platzhalter durch die eigenen Pfade ersetzen. Beispiel für den vollen Pfad nach der Installation durch den ArtCraft-Launcher: `C:\\Program Files\\WordCraft\\wordcraft-cli.exe`.
+
+```json
+{
+  "mcpServers": {
+    "wordcraft": {
+      "command": "C:\\Pfad\\zu\\WordCraft\\wordcraft-cli.exe",
+      "args": [
+        "mcp",
+        "--author", "Claude",
+        "--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
+        "--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\claude_out"
+      ]
+    }
+  }
+}
+```
+
+## Einrichtung unter Windows – Stolpersteine
+
+- Der ArtCraft-Launcher installiert nach `C:\Program Files\WordCraft\` (`wordcraft.exe` und `wordcraft-cli.exe`) und trägt nichts in den PATH ein. `Get-Command wordcraft-cli` findet die Datei daher nicht; in die Config den vollen Pfad schreiben. Auffinden mit:
+
+  ```powershell
+  Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "wordcraft-cli.exe" -ErrorAction SilentlyContinue
+  ```
+
+- Ort der Config:
+  - Claude-Installer: `%APPDATA%\Claude\claude_desktop_config.json`
+  - Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json` (existiert `%APPDATA%\Claude` nicht, ist es die Store-Version)
+- Die Config enthält bereits Einstellungen der App. Nur den Block `"mcpServers"` ergänzen, sonst nichts verändern; auf gültiges JSON achten (Kommas, doppelte Backslashes).
+- Der Ordner aus `--automation-write-root` muss vorher existieren, sonst startet der Server nicht.
+- Die Claude-App speichert Einstellungen aus ihrem Arbeitsspeicher zurück und löscht dabei frisch eingetragene `mcpServers` (passiert zum Beispiel, wenn man im laufenden Betrieb einen Ordnerzugriff erteilt). Deshalb: eintragen, speichern, **sofort** Claude komplett beenden (auch im Tray) und neu starten, danach den Eintrag kontrollieren.
+- Test: neuen Chat öffnen und fragen „Sind die WordCraft-Tools verfügbar?“
+
+## Test
+
+Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“
+
+Fehlen die Tools, zuerst den Eintrag in der Config prüfen. Nicht auf ein anderes Programm ausweichen.
+
+## Deinstallation/Update
+
+Deinstallation: In Claude den Skill aus der Liste entfernen. Den Block `wordcraft` unter `mcpServers` nur löschen, wenn WordCraft nicht mehr benutzt wird. Andere Einträge in der Config nicht anfassen.
+
+Update: das ZIP der neuen Version aus dem Release laden und wie bei der Installation hochladen. Liegt die alte Fassung noch in Claude, diese vorher entfernen.
+
+## Änderungen
+
+[CHANGELOG.md](CHANGELOG.md)