# effectcraft-mcp

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

## Zweck

Baut Motion-Graphics in `.ecproj` über den MCP-Server von EffectCraft und rendert Standbilder oder Filme. CLI 0.17.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).

## Voraussetzungen

- **EffectCraft 0.17.0** (`C:\Program Files\EffectCraft\effectcraft-cli.exe`, nicht auf PATH). Publisher Learning Machines LLC.
- Claude Desktop **oder** Cursor
- Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP

**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. `effectcraft-mcp-v0.1.0.mcpb` und `effectcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-v0.1.0.mcpb) laden.
2. Die `.mcpb` doppelklicken. **Lese-Ordner** `Dokumente`, **Schreib-Ordner** `Dokumente\Claude`.
3. **EffectCraft for Claude** einschalten, Skill-ZIP hochladen, Claude neu starten, neuen Chat öffnen.

## Ordner und Start

Die Erweiterung startet `mcp --empty` mit Lese- und Schreib-Ordner. Dieser Aufruf ist geprüft. `--autosave` und `--bridge PORT` schließen sich aus; die Erweiterung setzt sie nicht. Die Hilfe sagt, mit den Ordner-Flags werden Skripte abgelehnt.

## Test

Neuen Chat öffnen, eine kleine Komposition mit einem Text anlegen und `render_preview` ansehen lassen. Präfix `…EffectCraft_for_Claude…`.

## Stolpersteine

- Speichern scheitert außerhalb des Schreib-Ordners.
- 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)

```json
{
  "mcpServers": {
    "effectcraft": {
      "command": "C:\\Program Files\\EffectCraft\\effectcraft-cli.exe",
      "args": [
        "mcp",
        "--empty",
        "--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
        "--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
      ]
    }
  }
}
```

Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md). Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`.

## Änderungen

[CHANGELOG.md](CHANGELOG.md)