GridCraft-Skill ergänzen und die gemeinsamen Windows-MCP-Schritte auslagern.

2026-10-19 15:36:37 +02:00
1 parent 55e93e7660
commit 3ac6cd5a29
@@ -0,0 +1,95 @@
+# gridcraft-mcp
+
+[Alle Skills](../../README.md)
+
+## Zweck
+
+Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Server von GridCraft. GridCraft ist der Open-Source-Excel-Nachbau aus der ArtCraft-Suite, getestet mit 0.8.0. Die Anweisungen für Claude stehen in [SKILL.md](SKILL.md).
+
+## Voraussetzungen
+
+- GridCraft inklusive `gridcraft-cli.exe` ist installiert. Der ArtCraft-Launcher legt die Dateien nach `C:\Program Files\GridCraft\` und trägt nichts in den PATH ein.
+- Claude Desktop ist installiert.
+- Der MCP-Server ist in der `claude_desktop_config.json` eingetragen.
+
+**Keine Ordnerbeschränkung.** Anders als WordCraft kennt GridCraft keine `--automation-read-root` und `--automation-write-root`. Der Server kann jede Datei lesen und schreiben, die der Windows-Benutzer lesen und schreiben darf. In Claude bei den GridCraft-Werkzeugen `open_workbook`, `save_workbook` und `execute_command` auf „Immer fragen“ lassen. Der Skill weist Claude an, nie über ein Original zu speichern, sondern immer unter einem neuen Namen.
+
+## Installation
+
+Git ist nicht nötig.
+
+1. Das ZIP [gridcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/tag/gridcraft-mcp/v0.1.0) aus dem Release laden.
+2. In Claude **„+“ → „Skill erstellen“ → „Skill hochladen“** wählen und das ZIP hochladen.
+
+## Einrichtung
+
+In der bestehenden `claude_desktop_config.json` nur einen Eintrag innerhalb von `mcpServers` ergänzen. Bestehende Einträge, zum Beispiel `wordcraft`, bleiben unverändert.
+
+```json
+"gridcraft": {
+  "command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
+  "args": ["mcp"]
+}
+```
+
+So sieht `mcpServers` aus, wenn WordCraft schon eingetragen ist. Den vorhandenen `wordcraft`-Block nicht durch dieses Beispiel ersetzen, nur `gridcraft` daneben setzen:
+
+```json
+{
+  "mcpServers": {
+    "wordcraft": {
+      "command": "C:\\Program Files\\WordCraft\\wordcraft-cli.exe",
+      "args": [
+        "mcp",
+        "--author", "Claude",
+        "--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
+        "--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\claude_out"
+      ]
+    },
+    "gridcraft": {
+      "command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+## Einrichtung unter Windows – Stolpersteine
+
+Gemeinsame Punkte (Ort der Config, nur `mcpServers` ergänzen, App überschreibt die Datei): [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md).
+
+- Der ArtCraft-Launcher installiert nach `C:\Program Files\GridCraft\` (`gridcraft.exe` und `gridcraft-cli.exe`) und trägt nichts in den PATH ein. `Get-Command gridcraft-cli` findet die Datei daher nicht; in die Config den vollen Pfad schreiben. Auffinden mit:
+
+  ```powershell
+  Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "gridcraft-cli.exe" -ErrorAction SilentlyContinue
+  ```
+
+## Im Test geprüft
+
+Formeln, Tabellen, Zahlenformate und der PDF-Export. Beim Öffnen und Speichern einer bestehenden `.xlsx` blieben erhalten: verbundene Zellen, Kommentare, bedingte Formatierung, Datenüberprüfung, Namen, blattübergreifende Formeln, Fixierung, A4 quer und die Kopfzeile.
+
+## Bekannte Grenzen
+
+Kurzfassung, die Einzelheiten stehen in [SKILL.md](SKILL.md):
+
+- Formeln nur englisch und mit Komma als Trenner.
+- Deutsche Zahlen und Datumsangaben als Text werden nicht erkannt und rechnen nicht mit.
+- Diagramme nur aus einem zusammenhängenden Bereich.
+- CSV-Export ist komma-getrennt und schreibt das Anzeigeformat.
+- Keine Makros.
+
+## Test
+
+Neuen Chat öffnen und fragen: „Sind die GridCraft-Tools verfügbar? Lies A1:E10 aus <Pfad zu einer Test-xlsx>.“
+
+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 `gridcraft` unter `mcpServers` nur löschen, wenn GridCraft 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)