96 lines
4.1 KiB
Markdown
96 lines
4.1 KiB
Markdown
# 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)
|