wordcraft-mcp
Zweck
Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung. CLI 0.11.0; die Fallen stammen aus dem Praxistest mit 0.8.0 und sind nicht erneut durchgespielt. Die Anweisungen für den Agenten stehen in SKILL.md (clientneutral).
Voraussetzungen
- WordCraft über den ArtCraft-Launcher (
C:\Program Files\WordCraft\wordcraft-cli.exe) - Claude Desktop oder Cursor (siehe unten)
- Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP
Falls der Plugin-Skill wordcraft-dokumente installiert ist: deaktivieren bzw. löschen.
Cursor: siehe Wurzel-README und docs/CURSOR.md.
Installation (Claude Desktop)
Schritt-für-Schritt: docs/INSTALLATION.md. Kurz:
wordcraft-mcp-v0.4.0.mcpbundwordcraft-mcp-v0.4.0.zipaus dem Release laden.- Die
.mcpbdoppelklicken (oder über Einstellungen → Erweiterungen installieren). Lese-Ordner weit (z. B. Dokumente oder Benutzerordner), Schreib-Ordner eng (eigener Ordner, z. B.Dokumente\Claude). - Unter Einstellungen → Erweiterungen prüfen, dass WordCraft for Claude eingeschaltet ist.
- Skill-ZIP hochladen: „+“ → „Skill erstellen“ → „Skill hochladen“.
- Claude komplett beenden (auch Taskleiste) und neu starten. Neuen Chat öffnen.
Bei open_document / save_document in Claude „Immer fragen“ lassen, wenn du Pfade mitkontrollieren willst.
Wer v0.1.0, v0.2.0 oder v0.3.0 installiert hat: alte Erweiterung entfernen, v0.4.0 installieren, einschalten, Skill-ZIP v0.4.0 hochladen. Alte Skills wordcraft-dokumente bitte löschen.
Umsteigen von der manuellen Config: Eintrag wordcraft unter mcpServers vor der Installation der Erweiterung entfernen (vorher Sicherungskopie), sonst gibt es die Werkzeuge doppelt.
Enthaltene Software
Die Erweiterung steuert WordCraft (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird nicht mitgeliefert. Lizenztexte liegen in der .mcpb unter LICENSES/.
Test
Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“ Die Werkzeuge heißen mit Präfix …WordCraft_for_Claude….
Fehlen die Tools: Einstellungen → Erweiterungen – eingeschaltet? CLI unter C:\Program Files\WordCraft\wordcraft-cli.exe vorhanden? Dann Claude neu starten und neuen Chat öffnen.
Stolpersteine
- Speichern mit „path rejected“: Ziel lag außerhalb des Schreib-Ordners. Einstellungen → Erweiterungen → WordCraft for Claude → Einstellungen.
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
Deinstallation/Update
Einstellungen → Erweiterungen → entfernen; Skill löschen. Update: neue .mcpb und Skill-ZIP, ersetzen lassen, neu starten.
Alternative: manuell (für Entwickler)
Statt der Erweiterung den MCP-Server in claude_desktop_config.json eintragen. Stolpersteine: MCP unter Windows einrichten.
- Claude-Installer:
%APPDATA%\Claude\claude_desktop_config.json - Microsoft-Store-App:
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json(Herausgeber-Hashpzs8sxrjxfjjc, bei allen Store-Installationen gleich)
Die App kann den Eintrag beim Speichern eigener Einstellungen überschreiben – dann neu eintragen und sofort neu starten.
{
"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"
]
}
}
}
Laufende App steuern (nicht auf Ordner beschränkt): wordcraft --control 7981 und wordcraft-cli mcp --connect 127.0.0.1:7981. --connect und die Ordner-Flags zusammen sind ein Fehler.
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "wordcraft-cli.exe" -ErrorAction SilentlyContinue