After Effects MCP · Fortgeschritten

Learning Loop — der MCP wächst mit Ihrem Workflow

AE MCP bringt 220+ Tools mit. Während Sie damit arbeiten, protokolliert es, welche JSX-Snippets Sie mit derselben Struktur erneut ausführen — und Sie (oder Claude) können diese Muster zu neuen MCP-Tools mit sauberen Schemas und Parametern hochstufen, ohne Rebuild und ohne Neustart von After Effects. Ein exklusives System von Synthetic, das kein anderer Adobe-MCP bietet.

Warum das wichtig ist

· Weniger Tokens. Claude ruft ein Tool mit 2 Argumenten auf, statt 30 Zeilen JSX zu generieren.
· Weniger Fehler. Validiertes Schema statt JSX, das jedes Mal neu generiert wird.
· Lernt aus echter Nutzung. Hochgestuft werden genau die Muster, die Sie tatsächlich wiederholen.
· 100 % umkehrbar. Es ist eine JSON-Datei auf Ihrem PC. Entfernen Sie eine Zeile, und das Tool ist weg.

So funktioniert es

run_jsx_json ─▶ journal.jsonl ─▶ analyze.mjs ─▶ (tú eliges) ─▶ promote.mjs ─▶ wrappers.json
   JSX libre        cada llamada     detecta shapes                    template       tool nuevo
                                     repetidos +                       JSON           vivo al reconectar
                                     params candidatos                                el cliente MCP

Vier Schritte, komplett lokal:

1. Automatische Protokollierung

Jedes Mal, wenn ein MCP-Client ein Tool aufruft, hängt der Server eine Zeile an ~/.synthetic-ae-mcp/journal.jsonl an. Aufrufe von run_jsx / run_jsx_json speichern den vollständigen Code (das sind die Kandidaten); alle anderen speichern nur den Tool-Namen + die Argument-Schlüssel (ohne Payloads). Die Protokollierung erfolgt nach bestem Bemühen: Schlägt das Schreiben fehl, wird der Tool-Aufruf trotzdem normal abgeschlossen.

2. Analysieren: wiederkehrende Muster finden

# desde el repo del MCP (clonado o vía npx)
node scripts/analyze.mjs              # reporte human-readable
node scripts/analyze.mjs --json       # output JSON para scripting
node scripts/analyze.mjs --min 3      # subir el umbral (default 2)

Der Analyzer normalisiert das JSX (entfernt Kommentare, ersetzt Strings und Zahlen durch Tokens), gruppiert nach Signatur und meldet für jede Struktur, die ≥2-mal vorkommt: wie oft sie ausgeführt wurde, welche Literal-Positionen variieren (das sind Ihre Parameter) und ein Codebeispiel.

3. Hochstufen: das neue Tool erstellen

Definieren Sie eine JSON-Spezifikation mit Name + Template + Parametertypen. Beispiel: ein Tool, das frameRate=X für alle Kompositionen setzt, deren Name einen bestimmten Teilstring enthält:

{
  "name": "ae_set_framerate_batch",
  "description": "Setzt frameRate für alle Kompositionen, deren Name <pattern> enthält.",
  "code": "var n = 0; for (var i = 1; i <= app.project.numItems; i++) { var it = app.project.item(i); if (it instanceof CompItem && it.name.indexOf({{pattern}}) >= 0) { it.frameRate = {{fps}}; n++; } } __write({ ok: true, updated: n });",
  "params": [
    { "name": "fps",     "type": "number", "required": true,  "description": "Ziel-Framerate" },
    { "name": "pattern", "type": "string", "required": false, "default": "", "description": "Teilstring, der im Kompositionsnamen gesucht wird (leer = alle)" }
  ]
}

node scripts/promote.mjs spec.json
# OK promoted 'ae_set_framerate_batch' (2 params) -> ~/.synthetic-ae-mcp/wrappers.json
# Reconnect the MCP (or restart the client) to see the new tool.

4. Live: Das Tool erscheint in Ihrem Client

Der Server liest wrappers.json bei jedem tools/list neu ein. Verbinden Sie Claude Desktop / Cursor / Codex neu, und ae_set_framerate_batch(fps, pattern) steht wie jedes native Tool mit seinem vollständigen MCP-Schema zur Verfügung. Ruft Claude es auf, füllt der Server das Template aus und leitet es über run_jsx_json weiter — ohne Architekturänderung, ohne Rebuild.

Parametertypen

Typ	Wird in JSX eingesetzt als
string	JSON-escapeter String: "hello" → "hello"
number	Zahlenliteral: 24 → 24
boolean	true / false
array	JSON-Literal: [1,2,3] → [1,2,3]
object	JSON-Literal: {"a":1} → {"a":1}
raw	Unverändert eingefügt (fortgeschritten)

Datenschutz und Sicherheit

· Alles bleibt lokal: ~/.synthetic-ae-mcp/ ist ein Ordner auf Ihrem PC. Nichts wird irgendwohin hochgeladen.
· Das Journal zeichnet Aufrufe von run_jsx[_json] mit dem vollständigen Code auf. Andere Tools protokollieren nur Name + Argument-Schlüssel (keine Werte).
· Ordner ändern: Setzen Sie AE_MCP_DATA_DIR in Ihrer MCP-Konfiguration.
· Zurücksetzen: Löschen Sie ~/.synthetic-ae-mcp/.

Verfügbar ab AE MCP v2.2.0 — npx aktualisiert automatisch, Sie müssen nichts tun. Wenn Sie bereits Kunde sind, steht die Funktion beim nächsten Start von Claude Desktop zur Verfügung.

Panel-Modus Alle Tools