# wordcraft-mcp

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

## Zweck

Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung von Änderungen und der Fallen, die beim Praxistest mit WordCraft 0.8.0 aufgefallen sind. Die Anweisungen für Claude stehen in [SKILL.md](SKILL.md).

## Voraussetzungen

- WordCraft mit `wordcraft-cli` ist installiert.
- Der MCP-Server ist in der `claude_desktop_config.json` eingetragen und über `--automation-read-root` und `--automation-write-root` auf Ordner beschränkt.
- Der Ordner aus `--automation-write-root` existiert bereits.
- Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren, damit Claude `wordcraft-mcp` verwendet.

## Installation

Git ist nicht nötig.

1. Das ZIP [wordcraft-mcp-v0.1.1.zip](https://git.gundel.dev/dg/claude-skills/releases/tag/wordcraft-mcp/v0.1.1) aus dem Release laden.
2. In Claude **„+“ → „Skill erstellen“ → „Skill hochladen“** wählen und das ZIP hochladen.

## Einrichtung

In die bestehende `claude_desktop_config.json` nur den Block `mcpServers` einfügen. Platzhalter durch die eigenen Pfade ersetzen. Beispiel für den vollen Pfad nach der Installation durch den ArtCraft-Launcher: `C:\\Program Files\\WordCraft\\wordcraft-cli.exe`.

```json
{
  "mcpServers": {
    "wordcraft": {
      "command": "C:\\Pfad\\zu\\WordCraft\\wordcraft-cli.exe",
      "args": [
        "mcp",
        "--author", "Claude",
        "--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
        "--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\claude_out"
      ]
    }
  }
}
```

## 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\WordCraft\` (`wordcraft.exe` und `wordcraft-cli.exe`) und trägt nichts in den PATH ein. `Get-Command wordcraft-cli` findet die Datei daher nicht; in die Config den vollen Pfad schreiben. Auffinden mit:

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

- Der Ordner aus `--automation-write-root` muss vorher existieren, sonst startet der Server nicht.

## Test

Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“

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 `wordcraft` unter `mcpServers` nur löschen, wenn WordCraft 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)