# gridcraft-mcp

[Alle Skills](../../README.md)

## Zweck

Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Server von GridCraft. Getestet mit 0.8.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).

## Voraussetzungen

- **GridCraft** über den ArtCraft-Launcher (`C:\Program Files\GridCraft\gridcraft-cli.exe`)
- Claude Desktop **oder** Cursor (siehe unten)
- Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP

**Keine Ordnerbeschränkung.** In Claude bei `open_workbook`, `save_workbook` und `execute_command` auf „Immer fragen“ lassen.

**Cursor:** siehe [Wurzel-README](../../README.md) und [docs/CURSOR.md](../../docs/CURSOR.md).

## Installation (Claude Desktop)

Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:

1. `gridcraft-mcp-v0.3.0.mcpb` und `gridcraft-mcp-v0.3.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-v0.3.0.mcpb) laden.
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
3. Unter Einstellungen → Erweiterungen prüfen, dass **GridCraft for Claude** eingeschaltet ist.
4. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
5. Claude komplett beenden (auch Taskleiste) und neu starten. **Neuen** Chat öffnen.

Wer v0.1.0 oder v0.2.0 installiert hat: alte Erweiterung entfernen, v0.3.0 installieren, einschalten, Skill-ZIP v0.3.0 hochladen. Alte Skills `wordcraft-dokumente` bitte löschen.

**Umsteigen von der manuellen Config:** Eintrag `gridcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen.

## Enthaltene Software

Die Erweiterung steuert [GridCraft](https://github.com/storytold/gridcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert.

## Im Test geprüft

Formeln, Tabellen, Zahlenformate, PDF-Export, Stückliste/BOM mit `range.fill`, Datenüberprüfung und bedingte Formatierung. Beim Öffnen/Speichern bestehender `.xlsx` blieben u. a. verbundene Zellen, Kommentare und A4 quer erhalten.

## Bekannte Grenzen

Kurzfassung in [SKILL.md](SKILL.md): englische Formeln, Apostroph bei Text mit `=`, Diagramme nur aus zusammenhängendem Bereich, CSV ungeeignet für deutsches Excel, keine Makros.

## Test

Neuen Chat öffnen und fragen: „Sind die GridCraft-Tools verfügbar? Lies A1:E10 aus \<Pfad zu einer Test-xlsx\>.“ Präfix `…GridCraft_for_Claude…`.

Fehlen die Tools: Erweiterung eingeschaltet? CLI unter `C:\Program Files\GridCraft\gridcraft-cli.exe`? Neu starten, neuer Chat.

## Stolpersteine

- Erweiterungen sind nicht signiert.
- Formeln mit deutschen Namen ergeben `#NAME?`.

## Deinstallation/Update

Einstellungen → Erweiterungen → entfernen; Skill löschen. Update: neue `.mcpb` und Skill-ZIP.

## Alternative: manuell (für Entwickler)

Statt der Erweiterung in `claude_desktop_config.json` eintragen. Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md).

- Claude-Installer: `%APPDATA%\Claude\claude_desktop_config.json`
- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "gridcraft": {
      "command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
      "args": ["mcp"]
    }
  }
}
```

```powershell
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "gridcraft-cli.exe" -ErrorAction SilentlyContinue
```

## Änderungen

[CHANGELOG.md](CHANGELOG.md)