Release wordcraft-mcp and gridcraft-mcp 0.3.0: client-neutral skills, Cursor plugins.

2026-10-19 23:27:06 +02:00
1 parent debdf92877
commit 4c7e3ff720
@@ -0,0 +1,73 @@
+# Cursor: WordCraft und GridCraft
+
+Kurzfassung in der [Wurzel-README](../README.md). Für Claude Desktop: [INSTALLATION.md](INSTALLATION.md).
+
+Jedes Werkzeug ist ein **eigenes** Cursor-Plugin (1:1 zur Claude-`.mcpb`). Keine Sammel-Plugins.
+
+## Voraussetzung
+
+1. [ArtCraft-Launcher](https://getartcraft.com/apps) und darin WordCraft bzw. GridCraft (Standardpfad `C:\Program Files\…`).
+2. Cursor Desktop.
+
+## Plugin installieren (empfohlen)
+
+1. `<skill>-cursor-vX.Y.Z.zip` aus dem Release laden (Spalte „Cursor-Plugin“ in der README-Tabelle).
+2. Nach `~/.cursor/plugins/local/<skill>` entpacken (Windows: `%USERPROFILE%\.cursor\plugins\local\<skill>`). Der Ordner muss `.cursor-plugin/plugin.json`, `skills/` und ggf. `mcp.json` enthalten.
+3. **Developer: Reload Window**.
+4. Unter Customize prüfen, dass Skill und MCP-Server sichtbar sind.
+
+WordCraft: Lese-/Schreib-Ordner in den Plugin-Variablen (Configure) oder in `mcp.json` prüfen. Standard: Lese = `${userHome}/Documents`, Schreib = `${userHome}/Documents/Claude`.
+
+## Alternativ: nur MCP + Skill
+
+1. Spalte „Cursor 1-Klick“ / „Add to Cursor“ für den MCP-Server.
+2. Skill-Ordner aus `dist/cursor/skills/<skill>/` (oder dem Plugin-ZIP unter `skills/<skill>/`) nach `~/.cursor/skills/<skill>/` kopieren.
+
+Manuelle `~/.cursor/mcp.json` (Ausschnitt WordCraft):
+
+```json
+{
+  "mcpServers": {
+    "wordcraft": {
+      "command": "C:\\Program Files\\WordCraft\\wordcraft-cli.exe",
+      "args": [
+        "mcp",
+        "--author", "Claude",
+        "--automation-read-root", "${userHome}/Documents",
+        "--automation-write-root", "${userHome}/Documents/Claude"
+      ]
+    }
+  }
+}
+```
+
+GridCraft:
+
+```json
+{
+  "mcpServers": {
+    "gridcraft": {
+      "command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Unterstützte Variablen in `mcp.json`: `${userHome}`, `${env:NAME}`, `${workspaceFolder}`, `${pathSeparator}` (siehe Cursor-MCP-Doku). In Plugin-`mcp.json` zusätzlich Plugin-Variablen (`${READ_ROOT}`, …) und `${CURSOR_PLUGIN_ROOT}` (hier unnötig, keine gebündelte EXE).
+
+## Test
+
+Im Agent: „Sind die WordCraft-Werkzeuge verfügbar?“ bzw. GridCraft. Kleines Testdokument im Schreib-Ordner anlegen.
+
+## Probleme
+
+| Problem | Lösung |
+|---|---|
+| Keine Werkzeuge | Plugin unter `plugins/local/<skill>`? Reload? CLI unter `C:\Program Files\…`? |
+| WordCraft path rejected | Schreib-Ordner prüfen (`WRITE_ROOT` / mcp.json). |
+| Doppelte Server | Alten Eintrag in `~/.cursor/mcp.json` entfernen, wenn das Plugin denselben Namen (`wordcraft` / `gridcraft`) registriert. |
+
+## Datenschutz
+
+Auch Cursor sendet Inhalte an Cloud-Modelle. Ampel wie in den Skills: personenbezogene und NDA-Daten nicht in die Cloud-KI.
@@ -17,7 +17,7 @@ Ohne Erweiterung kann Claude nichts tun, ohne Skill macht es mehr Fehler. Instal

 - 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.
+- 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).

 ---

@@ -31,10 +31,10 @@ Installiere den [ArtCraft-Launcher](https://getartcraft.com/apps) und darin **Wo

 ## 2. Dateien herunterladen

-Lade jeweils die Version **0.2.0** herunter:
+Lade jeweils die Version **0.3.0** herunter:

- [wordcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.0/wordcraft-mcp-v0.2.0.mcpb) und [wordcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.0/wordcraft-mcp-v0.2.0.zip)
- [gridcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.2.0/gridcraft-mcp-v0.2.0.mcpb) und [gridcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.2.0/gridcraft-mcp-v0.2.0.zip)
+- [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**.

@@ -49,8 +49,8 @@ Für jede `.mcpb`-Datei:
   *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:** 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.
+   - **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.
@@ -85,6 +85,8 @@ Einen **neuen** Chat öffnen (offene Chats sehen neue Werkzeuge evtl. erst spät

 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
@@ -109,7 +111,7 @@ Claude sollte beide Werkzeuge finden und eine `.xlsx`-Datei im Ausgabeordner spe

 ## 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.
+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