Se connecter

Se connecter directement au serveur MCP de Composer

Composer enregistre des WordPress Abilities et un serveur MCP dédié. Le WordPress MCP Adapter séparé fournit le transport MCP que les clients compatibles utilisent pour découvrir et invoquer ces abilities.

Il s'agit du transport direct du modèle d'opérations de contenu gouverné décrit dans la vue d'ensemble d'Agent Composer. Le client fournit le raisonnement et la génération de contenu ; Composer contraint l'opération WordPress et crée un brouillon validé pour revue humaine.

Le point de terminaison Composer est :

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

Prérequis​

  • WordPress 6.9 ou version ultérieure et PHP 8.1 ou version ultérieure.
  • SmartCloud Agent Composer installé et actif.
  • Un Config Set validé et actif avec au moins un Blueprint.
  • Le WordPress MCP Adapter officiel installé et actif.
  • Un utilisateur WordPress dédié avec le rôle smartcloud_agent.
  • HTTPS pour toute connexion HTTP distante.

WordPress inclut l'Abilities API dans le cœur à partir de la version 6.9. Suivez les instructions de la version actuelle du MCP Adapter plutôt que de télécharger une branche de développement arbitraire. Son installation de package principale est composer require wordpress/mcp-adapter ; son dépôt officiel documente également un chemin de publication sous forme de plugin classique.

Créer l'identité d'exécution​

Créez un compte WordPress dédié tel que <agent-user> et attribuez-lui le rôle smartcloud_agent. N'utilisez pas un compte administrateur.

Ce rôle autorise l'exécution de brouillons par Composer et la capacité étroite d'ingestion distante d'images gérée par Composer, mais il n'accorde pas la vaste capacité upload_files de WordPress, ni la publication, la suppression de contenu normal, la gestion des plugins ou des thèmes, la gestion des utilisateurs, ou le HTML non filtré. Conservez les identifiants hors du JSON du Config Set, des journaux, des captures d'écran, des invites et du contrôle de source.

Pour les clients HTTP qui prennent en charge les WordPress Application Passwords, créez un mot de passe d'application pour ce compte dédié et stockez-le dans le coffre-fort secret du client. Ne le collez jamais dans un exemple de configuration MCP public.

Vérifier le serveur avant de connecter un client​

Ouvrez SmartCloud -> Agent Composer -> Overview en tant qu'administrateur et confirmez :

  • le Config Set actif attendu ;
  • le chemin du point de terminaison ;
  • l'état de préparation à l'exécution en mode brouillon uniquement ;
  • le thème actuel et l'état de préparation des fournisseurs.

Inspectez ensuite le serveur avec un inspecteur MCP compatible ou un client. Le dépôt du WordPress MCP Adapter documente les transports HTTP ainsi que les transports locaux WP-CLI/stdio. Une configuration HTTP générique doit contenir :

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

Les champs d'authentification exacts dépendent du client. N'exposez pas le point de terminaison de manière anonyme et ne mettez pas d'identifiants à longue durée de vie dans l'historique des commandes.

Workflow gouverné attendu​

Le client doit exécuter ces étapes dans l'ordre :

  1. Charger le contexte de conception actif et le Blueprint du page_type demandé.
  2. Charger smartcloud-agent-composer/get-content-field-contract lorsque le Blueprint utilise des champs enregistrés.
  3. Lister les patterns approuvés et lire le contenu de référence approuvé ou les médias existants lorsque le Blueprint utilise du contenu Gutenberg.
  4. Assembler et valider le document proposé ou l'enregistrement structuré sans enregistrer.
  5. Créer un brouillon détenu par l'agent avec une clé d'idempotence unique.
  6. Pour chaque champ de relation, appeler smartcloud-agent-composer/search-relation-targets et n'utiliser que les valeurs matches[].id renvoyées. N'utilisez pas smartcloud-agent-composer/list-content-drafts pour la recherche de relation.
  7. Lorsque l'accès à la taxonomie est activé, charger smartcloud-agent-composer/get-taxonomy-contract, rechercher avec search-taxonomy-terms, réutiliser un matches[].term_id exact, et ne créer un terme que lorsqu'aucun terme approprié n'existe et que create-taxonomy-term a été explicitement confirmé.
  8. Lire les jetons de concurrence actuels du brouillon, écrire les champs approuvés avec smartcloud-agent-composer/update-content-fields, et affecter les identifiants de termes approuvés par la politique avec smartcloud-agent-composer/assign-taxonomy-terms.
  9. Vérifier les valeurs structurées avec smartcloud-agent-composer/inspect-content-fields et les affectations de termes avec smartcloud-agent-composer/inspect-taxonomy-terms.
  10. Charger l'aperçu et signaler les résultats de validation ainsi que les URL pour revue humaine.

Une première demande sûre est la suivante :

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.

Confirmez dans WordPress que le résultat est un brouillon et qu'aucun contenu publié n'a changé.

Mise à jour d'un brouillon​

Composer exige le modified_gmt et le jeton de révision actuels pour les mises à jour. Un client doit relire le brouillon immédiatement avant de le modifier et soumettre ces valeurs sans changement. Si un autre éditeur a enregistré le brouillon en premier, Composer renvoie un conflit ; rechargez et examinez au lieu de réessayer avec des jetons obsolètes.

Dépannage​

  • Point de terminaison manquant : confirmez que le MCP Adapter et Composer sont actifs, puis rechargez WordPress après avoir supprimé les processus PHP obsolètes.
  • Unauthorized or forbidden : authentifiez-vous en tant qu'utilisateur dédié et confirmez le rôle smartcloud_agent ; ne résolvez pas cela en accordant le rôle Administrator.
  • No active configuration : validez puis activez explicitement un Config Set.
  • Blueprint not found : utilisez le page_type stable exact configuré dans l'ensemble actif.
  • Pattern or block missing : rescanez le site, confirmez l'enregistrement et mettez à jour un Config Set de travail cloné.
  • Provider not ready : inspectez Theme & providers et la configuration propre au plugin fournisseur.
  • Une recherche par titre trouve des correspondances, mais ne renvoie aucun élément modifiable : smartcloud-agent-composer/list-content-drafts n'est pas un résolveur de relation. Lisez le contrat du champ de contenu, puis appelez smartcloud-agent-composer/search-relation-targets pour le champ de relation déclaré.
  • A taxonomy tool is missing or rejects the taxonomy : rescanez la découverte du site, clonez le Config Set actif, activez cette taxonomie enregistrée sous Composer taxonomy access, validez et activez le successeur, puis redémarrez MCP et actualisez le catalogue client.
  • Conflict : rechargez le brouillon et utilisez ses jetons de concurrence actuels.
  • Preview invalid : lisez le rapport de validation ; ne publiez pas et ne contournez pas la contrainte en échec.

Le chemin MCP direct envoie les requêtes entre le client configuré et WordPress. Composer lui-même ne nécessite ni compte OpenAI, ni tunnel Connector, ni abonnement WP Suite pour ce workflow.