# 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)