[ [ DOCS · DIVISKIT AGENT ] ]

Diviskit Agent —
Dokumentation.

Die REST-Bridge zwischen deinem AI-Client und Divi 5: Setup, MCP-Konfiguration, Tool-Übersicht und Antworten auf die häufigsten Fragen — Stand Plugin-Version 1.7.4.

v1.7.4 · WP ≥ 6.5 · PHP ≥ 8.0 · DIVI 5 · GPL-2.0

01

Setup & Client-Config

Der MCP-Server läuft im AI-Client (separat via npm: @diviskit/mcp-server) und verbindet sich per Application Password mit dem Plugin. Das Dashboard zeigt Komponenten und Status — es ist kein Chat-Interface und kein Beweis einer aktiven MCP-Verbindung.

  1. 01Diviskit Agent installieren (Plugins → Add New oder ZIP-Upload) und aktivieren — Divi 5 muss aktiv sein.
  2. 02Application Password erstellen: Users → Profile → Application Passwords, oder per WP-CLI:
ddev wp user application-password create admin diviskit-mcp --porcelain
  1. 03MCP-Server im AI-Client konfigurieren — Site-URL, WP-Benutzername und Application Password in der Client-Config:
{
    "mcpServers": {
        "diviskit-mcp": {
            "command": "npx",
            "args": ["-y", "--package", "@diviskit/mcp-server", "diviskit-mcp"],
            "env": {
                "WP_URL": "https://example.com",
                "WP_USER": "admin",
                "WP_APP_PASSWORD": "<application-password>"
            }
        }
    }
}
  1. 04Handshake prüfen — POST /wp-json/diviskit/v1/handshake muss "compatible": true liefern:
curl -s -X POST "https://example.com/wp-json/diviskit/v1/handshake" \
  -u "user:<application-password>" \
  -H "Content-Type: application/json" \
  -d '{"mcp_server_version":"1.1.0"}'

# -> { "compatible": true, "capabilities": { ... } }
  1. 05Authoring-Skills installieren: das Plugin liefert bin/install-skills.sh (Download im Diviskit-Dashboard oder unter wp-content/plugins/diviskit-agent/bin/) für Devin, Codex, Claude Code, Cursor oder ein eigenes Verzeichnis. Danach den Client neu starten und die Site-Capabilities inspizieren lassen.
curl -fsSL -o install-skills.sh \
  "https://example.com/wp-content/plugins/diviskit-agent/bin/install-skills.sh"
chmod +x install-skills.sh
./install-skills.sh --client devin --scope project
# oder: codex | claude | cursor | generic --target <dir>

02

Tools & Capabilities

Jede Antwort folgt dem Envelope { ok, data } bzw. { ok:false, error:{ code, message, hint } }. Welche Operationen verfügbar sind, hängt von Plugin-Versionen, WordPress-Rechten und dem Capability-Handshake ab.

PAGES

Seiten & Inhalte

diviskit_page_* — list, get, get_layout, create, update_content, update_meta, update_status, trash.
diviskit_module_* — get, update, move, clone, lock/unlock.
diviskit_section_* — append, get, replace, remove.

DESIGN

Design-System

diviskit_preset_* — create, update, delete, audit, cleanup, inspect, reassign, set_default, registry_doctor.
diviskit_variable_* — create, list, delete, create_fluid_system, scan_orphans, used_on_page.
diviskit_global_color_* · diviskit_global_font_*

LAYOUT

Theme Builder & Library

diviskit_tb_template_* · diviskit_tb_layout_*
diviskit_template_* · diviskit_library_*
diviskit_canvas_* · diviskit_menu_*

CHECK

Validierung & Diagnose

diviskit_validate_blocks — bekannte Silent-Failures vor dem Schreiben.
diviskit_render_preview · diviskit_schema_* — Modul-Schema & Attributpfade.
diviskit_meta_* — info, ping, find_icon, flush_cache, wp_cli.
diviskit_rollback_snapshot_* — list, get, delete, restore.

SEO

SEO (The SEO Framework)

diviskit_seo_provider_list · diviskit_seo_metadata_get · diviskit_seo_metadata_update
Der Agent fährt das installierte Plugin (5.1.4+) — er bringt keine eigene SEO-Engine mit.

PRO

Pro & Add-ons

diviskit_scf_* — Secure Custom Fields (Basis, Free).
diviskit_vk_* — Vendokit-Commerce (Pro).
Der Capability-Handshake meldet, was die verbundene Site tatsächlich unterstützt.

03

Berechtigungen & Sicherheit

Alle Endpunkte verlangen Application-Password-Auth. Zusätzlich gilt das WordPress-Capability-Modell:

READ

edit_posts

Lese-Endpunkte: Seiten, Layouts, Presets, Variablen, Snapshots, Schema.

WRITE

edit_pages

Schreib-Endpunkte: Content-Updates, Module, Sections, Theme-Builder-Layouts.

ADMIN

manage_options

Administrative Flächen: Preset- und Variablen-Verwaltung. Erstellen/Status-Änderungen brauchen zusätzlich die gemappten create/publish-Capabilities des Post-Types.

Secrets nie teilen.
Application Passwords, Lizenzschlüssel und Tokens gehören nur in die lokale MCP-Config oder Umgebungsvariablen — nie in Issues, Doku-Beispiele, Screenshots oder Repo-Dateien.

04

FAQ & Troubleshooting

Funktioniert das mit Codex oder Claude?

Ja. Der Diviskit-MCP-Server verbindet kompatible Clients — Codex, Claude Code, Claude Desktop, Devin und andere — mit dem Plugin. Client-Konfiguration und Client-Zugang sind unabhängig vom WordPress-Plugin.

Läuft das Plugin ohne MCP-Server?

Installieren und das Dashboard einsehen: ja. Der AI-Workflow braucht den separat installierten MCP-Server und einen kompatiblen AI-Client.

Brauche ich Divi?

Ja — Diviskit Agent zielt auf Divi 5. Ohne aktives Divi antworten authentifizierte Requests mit divi_unavailable.

Kann ich das Ergebnis im Visual Builder weiterbearbeiten?

Ja. Native Divi-Module bleiben im Visual Builder editierbar. Prüfe die Ausgabe auf Staging — inklusive Responsive-Layouts — bevor du publizierst.

Sind alle MCP-Tools im Free-Plugin enthalten?

Nein. Free enthält die Site-Authoring-Bridge; ausgewählte Workflows (z. B. Vendokit-Commerce) brauchen separate Pro-Komponenten. Der MCP-Server prüft den Capability-Handshake.

Wie aktualisiere ich das Divi-Modul-Schema nach einem Divi-Update?

Divi-Updates können Attributpfade ändern. Der Schema-Dump liegt unter GET /wp-json/diviskit/v1/schema/module/dump-all mit schema_version-Fingerprint. Das Dashboard (Diviskit Agent → Schema dump) zeigt den aktuellen Fingerprint und das Refresh-Kommando update_skills.sh.