[ [ 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.
- 01Diviskit Agent installieren (Plugins → Add New oder ZIP-Upload) und aktivieren — Divi 5 muss aktiv sein.
- 02Application Password erstellen: Users → Profile → Application Passwords, oder per WP-CLI:
ddev wp user application-password create admin diviskit-mcp --porcelain
- 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>"
}
}
}
}
- 04Handshake prüfen —
POST /wp-json/diviskit/v1/handshakemuss"compatible": trueliefern:
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": { ... } }
- 05Authoring-Skills installieren: das Plugin liefert
bin/install-skills.sh(Download im Diviskit-Dashboard oder unterwp-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.
