Royal MCP

Sicherheitsorientierter MCP-Server für WordPress. Verbinden Sie Claude, ChatGPT und Gemini mit Ihrer WordPress-Website – mit API-Key- und OAuth-2.1-Authentifizierung, vollständiger Aktivitätsprotokollierung und berechtigungsgesteuertem Zugriff.

Download auf WordPress.org · Dokumentation · Royal Plugins

Ein WordPress-Plugin, das Ihre Website als Model Context Protocol-Server bereitstellt. KI-Agenten – Claude.ai Web, Claude Desktop, ChatGPT, eigene Clients – können Beiträge, Seiten, Medien, Benutzer, Menüs, WooCommerce-Bestellungen und Elementor-Seiten lesen und schreiben. Jeder Aufruf durchläuft dabei Berechtigungsprüfung, Ratenbegrenzung und ein Audit-Protokoll. Verteilung über das offizielle WordPress.org-Plugin-Verzeichnis.

Kurzübersicht

Related MCP server: wp-mcp

Funktionen

WordPress-Core (84 Tools, immer verfügbar)

• Inhalte — Beiträge, Seiten, benutzerdefinierte Beitragstypen (vollständiges CRUD + Revisionen + Beitragsbilder)

• Taxonomien — Kategorien, Schlagwörter, benutzerdefinierte Taxonomien, Term-Metadaten, Beitrag-Term-Verknüpfung

• Medien — Durchsuchen, Hochladen (URL oder base64), Metadaten aktualisieren, löschen

• Kommentare — Erstellen, moderieren (freigeben / Spam / Papierkorb)

• Benutzer — Anzeigenamen + Rollen lesen (E-Mail-Adressen und Benutzernamen werden nicht offengelegt)

• Menüs — Lesen, Elemente erstellen, neu anordnen, aktualisieren mit Schutzmechanismen gegen destruktive Schreibvorgänge

• Theme — Benutzerdefiniertes CSS, Theme-Modifikationen, Erkennung des aktiven Themes

• Website — Permalink-Struktur, Optionen (auf Whitelist), Website-Informationen

• Suche — Suche über alle Inhalte per Abfrage

• SEO — Yoast / Rank Math / AIOSEO-Metadaten lesen/schreiben, wenn das jeweilige Plugin aktiv ist

• Diagnose — Website-Status (WP/PHP/MySQL/Plugins/Themes/Cron in einem Aufruf), PHP-Fehlerprotokoll-Ende, WP-Cron-Zeitplan und MCP royal_mcp_connection_health (liefert Route, Auth-Methode, Sitzungs-ID, Plugin-Version und aktive Page-Builder-Versionen für Divi + Elementor + Gutenberg)

Plugin-Integrationen (80 Tools, bedingt)

Automatische Registrierung nur, wenn das integrierte Plugin aktiv ist.

WordPress-Abilities-API-Brücke (WP 6.9+)

WordPress 6.9 hat die Abilities API eingeführt – ein Grundbaustein, mit dem Plugins typisierte Fähigkeiten registrieren können, die KI-Agenten aufrufen können. Seit Version 1.4.38 registriert sich jedes Royal-MCP-Tool auch als WordPress-Ability. Damit haben Sie drei Wege zu denselben Handlern:

1. Nativ — Der Streamable-HTTP-Endpunkt /wp-json/royal-mcp/v1/mcp von Royal MCP (unverändert, immer verfügbar).

2. WP MCP Adapter — Wenn das Paket wordpress/mcp-adapter installiert ist, registriert Royal MCP einen benannten royal-mcp-server am mcp_adapter_init-Hook, zusätzlich zum Standard-Server des Adapters.

3. WP-Core-REST — Direkter Ability-Aufruf unter /wp-json/wp-abilities/v1/abilities/{name}/run für Aufrufer, die den Core-WP-Endpunkt bevorzugen.

Dieselben Handler, drei Transporte, ein Satz von Berechtigungsprüfungen pro Tool. Die Brücke kann über die Option royal_mcp_abilities_registration_enabled deaktiviert werden (Standard: aktiv).

Was wir nicht tun

Explizite Scope-Grenzen – das Integrationsmodell ist „schmale Tools, die zuverlässig funktionieren", nicht „jede API-Oberfläche offenlegen".

• Keine Widget-Ebene-Elementor-Erzeugung von Grund auf. Atomare Widgets (Editor V4) werden undurchsichtig durchgereicht; wir dekodieren niemals atomare Schemas, da Elementor sie selbst verschieben kann.

• Keine JSON-Schreibvorgänge für Beaver Builder / Bricks Page-Builder. Standard-Beitragsinhalte sind les- und schreibbar; Page-Builder-spezifische JSON-Speicherung bleibt undurchsichtig, sofern kein dediziertes Tool sie abdeckt. (Elementor und Divi haben dedizierte Tools – siehe Integrationstabelle oben.)

• Keine Erstellung von Theme-Builder-Vorlagen (Elementor oder andere).

• Keine Änderungen an Core-Dateien – Royal MCP schreibt niemals in wp-content/themes, wp-includes oder wp-admin.

• Keine Plugin-Installation oder -Aktualisierung über MCP. Erkennung ja; Installieren/Aktivieren/Deaktivieren nein.

• Kein rohes SQL. Abfragen laufen ausschließlich über WP_Query und $wpdb->prepare().

Royal MCP Pro (kostenpflichtig)

Das kostenlose Plugin ist für einzelne Website-Besitzer voll funktionsfähig. Royal MCP Pro erweitert es für Agenturen und Betreiber mehrerer Websites:

• Divi-Pro-Suite — Seiten klonen, Bilder austauschen, Vorlagen importieren, vollständiges Bibliotheks-CRUD, D4→D5-Migrator, globale Presets in Stapelverarbeitung anwenden (8 Tools)

• Elementor-Pro-Tiefe — zusätzliche Elementor-Tools über die kostenlose Integration hinaus

• Universelles Audit-Protokoll — jeder KI-Vorgang wird mit Zuordnung + Export protokolliert

• 72-Stunden-Rückgängig bei jedem Schreibvorgang — jedes destruktive Pro-Tool gibt ein Undo-Token zurück; jeder Vorgang kann innerhalb des Zeitfensters rückgängig gemacht werden

• Lizenzgesteuerte Updates über den Standard-WordPress-Updater – keine Laufzeitabhängigkeiten von externen Lizenzservern

Mehr erfahren auf royalplugins.com/royal-mcp-pro

Verbinden

Installation

1. Installieren Sie aus dem WordPress.org-Verzeichnis (empfohlen – Auto-Updates über WP-Admin) oder laden Sie das GitHub-Release-ZIP hoch.

2. Royal MCP → Einstellungen → klicken Sie auf API-Key generieren.

3. Wählen Sie unten einen Client aus.

Claude.ai Web (OAuth – empfohlen)

Der einfachste Weg – keine Konfigurationsdatei-Änderungen, kein API-Key in Ihrem Client.

1. In Claude.ai → Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen.

2. URL: https://yoursite.com/wp-json/royal-mcp/v1/mcp

3. Bestätigen Sie den OAuth-Zustimmungsbildschirm, wenn Sie dazu aufgefordert werden. Claude.ai übernimmt die Dynamic Client Registration + den PKCE-Ablauf gegen Ihre Website.

Claude Desktop (.mcpb-Ein-Klick-Bundle – neu in 1.4.38)

Der einfachste Claude-Desktop-Weg – kein mcp-remote, kein npx, keine Konfigurationsdatei-Bearbeitung.

1. Laden Sie royal-mcp-1.4.38.mcpb aus dem aktuellsten GitHub-Release herunter.

2. Doppelklicken Sie auf die .mcpb-Datei – Claude Desktop öffnet den Installationsdialog.

3. Geben Sie Ihre Website-URL + Ihren API-Key ein, wenn Sie dazu aufgefordert werden. Die Verbindung ist sofort aktiv.

Das Bundle enthält eine abhängigkeitsfreie stdio-zu-HTTPS-Brücke in Node ≥18, das Claude Desktop bereits mitbringt. Siehe Claude Desktop MCP Bundles für die .mcpb-Spezifikation.

Claude Desktop (OAuth über mcp-remote)

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://yoursite.com/wp-json/royal-mcp/v1/mcp"]
    }
  }
}

Konfigurationspfad: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows).

Claude Desktop (API-Schlüssel)

OAuth überspringen und über Header authentifizieren:

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://yoursite.com/wp-json/royal-mcp/v1/mcp",
        "--header", "X-Royal-MCP-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

ChatGPT

ChatGPTs benutzerdefinierter MCP-Connector verwendet dieselbe URL wie Claude.ai Web. Folgen Sie dem Connector-Ablauf von ChatGPT und fügen Sie https://yoursite.com/wp-json/royal-mcp/v1/mcp ein.

Raw HTTP (benutzerdefinierte Clients)

# 1. Initialize a session. -i prints headers so you can grab Mcp-Session-Id.
curl -i -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "id": 1,
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "my-app", "version": "1.0"}
    }
  }'

# 2. List available tools using the session id from the response header.
curl -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Mcp-Session-Id: <session_id>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 2}'

Sicherheitsmodell

Vollständige Sicherheitsarchitektur: royalplugins.com/support/royal-mcp/

Projektstatus

• Aktive Wartung — etwa wöchentliche Veröffentlichungen. Siehe releases für das Änderungsprotokoll.

• MCP-Spezifikationskonformität — implementiert den Streamable HTTP transport (2025-11-25).

• Issues — github.com/royalplugins/royal-mcp/issues. Issues mit Kundenauswirkung werden in der Regel innerhalb von 24 Stunden bestätigt und mit Versionszielen priorisiert.

• Mitwirken — PRs willkommen. Der Plugin-Quellcode wird sowohl in dieses Repo als auch in den wp.org-SVN-Trunk eingepflegt; Veröffentlichungen werden über den wp.org-Review-Prozess koordiniert.

Weiterführende Lektüre

• Editing Elementor with Claude: The Four Workflows That Work Today — die vier realen Architekturen für die KI-Bearbeitung von Elementor-Seiten und wann man welche verwenden sollte. Benutzerorientierte Version mit Prompts, Beispielen und einer Videodemo des Clone-and-Customize-Ablaufs.

• Editing Elementor with Claude: 4 MCP Architectures — die Ingenieursversion auf Hashnode. Das PHP unter der Haube von elementor_clone_page, die sechs Tool-Signaturen und der Abwägung zwischen HTTP-Basic- und OAuth-2.1-Authentifizierungsmodell.

Verwandte Projekte

• GuardPress — WordPress-Sicherheitshärtung

• SiteVault — WordPress-Backups und -Migration

• ForgeCache — Caching und Leistung

• FormForge — Formular-Builder mit PDF-Erstellung

• SEObolt — SEO-Toolkit für WordPress

Lizenz

GPLv2 oder später — siehe LICENSE oder die GNU-Website.

Royal MCP wird wie besehen bereitgestellt. API-Schlüssel schützen Ihre Endpunkte; bewahren Sie sie wie jede andere Anmeldeinformation. Sie sind verantwortlich für den Inhalt, die Befehle und Aktionen, die eine KI-Plattform auf Ihrer WordPress-Website ausführen darf.