Anmelden

Direkt mit dem Composer MCP Server verbinden

Composer registriert WordPress Abilities und einen dedizierten MCP Server. Der separate WordPress MCP Adapter liefert den MCP-Transport, den kompatible Clients zur Entdeckung und Ausführung dieser Fähigkeiten nutzen.

Das ist der direkte Transport für das governance-geführte Modell aus dem Agent Composer Überblick. Der Client liefert Reasoning und Content-Generierung; Composer beschränkt WordPress-Operationen und erzeugt einen validierten Entwurf zur menschlichen Prüfung.

Der Composer Endpunkt ist:

<wordpress-url>/wp-json/mcp/smartcloud-agent-composer

Voraussetzungen​

  • WordPress 6.9 oder neuer und PHP 8.1 oder neuer.
  • SmartCloud Agent Composer installiert und aktiv.
  • Ein validierter und aktiver Config Set mit mindestens einem Blueprint.
  • Der offizielle WordPress MCP Adapter installiert und aktiv.
  • Ein dedizierter WordPress-Benutzer mit Rolle smartcloud_agent.
  • HTTPS für jede Remote-HTTP-Verbindung.

WordPress enthält die Abilities API seit 6.9 im Core. Folgen Sie den aktuellen Installationshinweisen des MCP Adapters statt eines beliebigen Development-Branches. Primäre Plugin-Installation ist composer require wordpress/mcp-adapter; das offizielle Repo beschreibt ebenfalls einen klassischen Plugin-Pfad.

Ausführungsidentität erstellen​

Erzeuge einen dedizierten WordPress-Account wie <agent-user> und weise die Rolle smartcloud_agent zu. Nutzen Sie keinen Administrator-Account.

Die Rolle erlaubt Composer-Draft-Ausführung und die schmale remote-Bild-Ingestion von Composer; sie gibt jedoch kein allgemeines upload_files, keine Veröffentlichungsrechte, kein normales Inhalts-Löschen, kein Plugin- oder Theme-Management, keine Nutzerverwaltung und kein unfiltered HTML. Halten Sie Zugangsdaten außerhalb von Config-Set-JSON, Logs, Screenshots und Source Control.

Für HTTP-Clients mit WordPress Application Passwords erstellen Sie ein Application Password für diesen Account und speichern Sie es im Secret Store des Clients. Niemals public in Beispielkonfigurationen ablegen.

Server vor Client-Anschluss prüfen​

Öffnen Sie als Administrator SmartCloud -> Agent Composer -> Overview und bestätigen Sie:

  • erwarteter aktiver Config Set,
  • Endpoint-Pfad,
  • Draft-only-Ausführungsbereitschaft,
  • aktuelles Theme und Provider-Bereitschaft.

Prüfen Sie anschließend den Server mit einem kompatiblen MCP-Inspector oder Client. Das WordPress MCP Adapter-Repository beschreibt HTTP- und lokale WP-CLI/stdio-Transporte. Eine generische HTTP-Konfiguration sollte enthalten:

Server URL: <wordpress-url>/wp-json/mcp/smartcloud-agent-composer
Username: <agent-user>
Password/token: <stored-application-password>

Die genauen Auth-Felder hängen vom Client ab. Exponiere den Endpunkt niemals anonym und speichern Sie keine langlebigen Credentials in der Kommando-Historie.

Erwarteter governance-Flow​

Der Client sollte die Schritte in dieser Reihenfolge ausführen:

  1. aktiven Designkontext und Blueprint für den gewünschten page_type laden.
  2. smartcloud-agent-composer/get-content-field-contract laden, wenn der Blueprint registrierte Felder verwendet.
  3. freigegebene Patterns listen und genehmigte Referenzinhalte bzw. Medien laden, wenn Blueprint Gutenberg-Inhalt nutzt.
  4. vorgeschlagenes Dokument oder Strukturierter Datensatz validieren (ohne Speichern).
  5. einen agenteneigenen Entwurf mit eindeutiger Idempotency anlegen.
  6. für jedes Beziehungfeld smartcloud-agent-composer/search-relation-targets aufrufen und nur die zurückgegebenen matches[].id verwenden; nicht smartcloud-agent-composer/list-content-drafts für Relation-Lookup nutzen.
  7. wenn Taxonomiezugriff erlaubt ist: smartcloud-agent-composer/get-taxonomy-contract, search-taxonomy-terms, genaues matches[].term_id wiederverwenden und einen Begriff nur erzeugen, wenn kein passender fehlt und create-taxonomy-term ausdrücklich bestätigt wurde.
  8. aktuelle Concurrency-Token des Entwurfs lesen, zugelassene Felder mit smartcloud-agent-composer/update-content-fields schreiben und durch smartcloud-agent-composer/assign-taxonomy-terms policykonforme Term-IDs zuweisen.
  9. strukturierte Werte mit smartcloud-agent-composer/inspect-content-fields sowie Zuordnungen mit smartcloud-agent-composer/inspect-taxonomy-terms prüfen.
  10. Vorschau laden und Validierungsresultate sowie URLs für menschliche Prüfung berichten.

Ein sicherer erster Aufruf ist:

Using page type <page-type>, load the active design context and blueprint, list
approved patterns, validate a minimal content plan, create an agent-owned draft,
and return its preview. Do not publish, delete normal content, upload media, or
change WordPress configuration.

Bestätigen Sie in WordPress, dass das Ergebnis ein Entwurf ist und keine veröffentlichte Seite verändert wurde.

Entwurf aktualisieren​

Composer verlangt das aktuelle modified_gmt und Revisions-Token für Updates. Ein Client muss den Entwurf unmittelbar vor Änderung lesen und diese Werte unverändert verwenden. Wenn ein anderer Editor den Entwurf zuvor gespeichert hat, gibt Composer einen Konflikt zurück; laden Sie erneut und prüfen Sie statt mit veralteten Tokens zu wiederholen.

Fehlerbehebung​

  • Endpoint fehlt: MCP Adapter und Composer aktiv bestätigen, danach WordPress nach Aufräumen von stale PHP-Prozessen neu laden.
  • Unauthorized/forbidden: als dedizierten Nutzer authentifizieren und Rolle smartcloud_agent prüfen; löse nicht durch Admin-Zugriff.
  • Keine aktive Konfiguration: einen Config Set validieren und explizit aktivieren.
  • Blueprint nicht gefunden: exakt den stabilen page_type aus dem aktiven Satz verwenden.
  • Pattern oder Block fehlt: Site scannen, Registrierung prüfen, geklonten Arbeits-Config-Set aktualisieren.
  • Provider nicht bereit: Theme & providers sowie konfigurierten Provider-Block prüfen.
  • Titel-Suche zeigt Treffer, liefert aber keine bearbeitbaren Elemente: smartcloud-agent-composer/list-content-drafts ist kein Relationsresolwer. Inhalt-Feld-Vertrag lesen, danach smartcloud-agent-composer/search-relation-targets für das deklarierte Beziehungenfeld aufrufen.
  • Taxonomie-Tool fehlt oder lehnt Taxonomie ab: Site-Discovery erneut ausführen, aktiven Config Set klonen, Taxonomie unter Composer taxonomy access aktivieren, validieren/aktivieren des Nachfolgers, dann MCP neu starten und Client-Katalog aktualisieren.
  • Konflikt: Entwurf erneut laden und aktuelle Concurrency-Token nutzen.
  • Vorschau ungültig: Validierungsreport prüfen; niemals fehlgeschlagenen Constraint umgehen.

Der direkte MCP-Pfad sendet Requests zwischen Client und WordPress; Composer selbst benötigt keinen OpenAI-Account, keinen Connector Tunnel und keine eigene WP-Suite-Subscription für diesen Flow.