74 lines
3.6 KiB
Markdown
74 lines
3.6 KiB
Markdown
# 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
|
||
|
||
- 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
|
||
```
|
||
|
||
- Ort der Config:
|
||
- Claude-Installer: `%APPDATA%\Claude\claude_desktop_config.json`
|
||
- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json` (existiert `%APPDATA%\Claude` nicht, ist es die Store-Version)
|
||
- Die Config enthält bereits Einstellungen der App. Nur den Block `"mcpServers"` ergänzen, sonst nichts verändern; auf gültiges JSON achten (Kommas, doppelte Backslashes).
|
||
- Der Ordner aus `--automation-write-root` muss vorher existieren, sonst startet der Server nicht.
|
||
- Die Claude-App speichert Einstellungen aus ihrem Arbeitsspeicher zurück und löscht dabei frisch eingetragene `mcpServers` (passiert zum Beispiel, wenn man im laufenden Betrieb einen Ordnerzugriff erteilt). Deshalb: eintragen, speichern, **sofort** Claude komplett beenden (auch im Tray) und neu starten, danach den Eintrag kontrollieren.
|
||
- Test: neuen Chat öffnen und fragen „Sind die WordCraft-Tools verfügbar?“
|
||
|
||
## 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)
|