Iniciar sesión

Conectar directamente con el servidor MCP de Composer

Composer registra WordPress Abilities y un servidor MCP dedicado. El WordPress MCP Adapter, instalado por separado, proporciona el transporte MCP que los clientes compatibles utilizan para descubrir e invocar esas Abilities.

Este es el transporte directo para el modelo de operaciones de contenido gobernadas descrito en la introducción a Agent Composer. El cliente aporta el razonamiento y la generación de contenido; Composer limita la operación de WordPress y cree un borrador validado para revisión humana.

El endpoint de Composer es:

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

Requisitos previos​

  • WordPress 6.9 o posterior y PHP 8.1 o posterior.
  • SmartCloud Agent Composer instalado y activo.
  • Un Config Set validado y activo con al menos un Blueprint.
  • WordPress MCP Adapter oficial instalado y activo.
  • Un usuario dedicado de WordPress con el rol smartcloud_agent.
  • HTTPS para cualquier conexión HTTP remota.

WordPress incluye Abilities API en el núcleo desde la versión 6.9. Siga las instrucciones de la versión actual de MCP Adapter en lugar de descargar una rama de desarrollo cualquiera. Su instalación principal es composer require wordpress/mcp-adapter; el repositorio oficial también documenta una vía tradicional mediante una versión del plugin.

Crear la identidad de ejecución​

Cree una cuenta dedicada de WordPress, como <agent-user>, y asígnale el rol smartcloud_agent. No reutilice una cuenta de administrador.

El rol permite ejecutar borradores de Composer y usar la capacidad limitada de ingesta de imágenes remotas gestionada por Composer, pero no concede la capacidad amplia upload_files de WordPress ni permisos de publicación, eliminación de contenido normal, gestión de plugins o temas, gestión de usuarios o HTML sin filtrar. Mantenga las credenciales fuera del JSON de los Config Sets, registros, capturas de pantalla, prompts y control de versiones.

Para clientes HTTP compatibles con las contraseñas de aplicación de WordPress, crea una para esta cuenta dedicada y guárdala en el almacén de secretos del cliente. Nunca la pegue en un ejemplo público de configuración MCP.

Verificar el servidor antes de conectar un cliente​

Abra SmartCloud -> Agent Composer -> Overview como administrador y confirme:

  • el Config Set activo previsto;
  • la ruta del endpoint;
  • la disponibilidad de ejecución limitada a borradores;
  • la disponibilidad actual del tema y los proveedores.

Después, inspecciona el servidor con un cliente o inspector MCP compatible. El repositorio de WordPress MCP Adapter documenta tanto el transporte HTTP como los transportes locales WP-CLI/stdio. Una configuración genérica de cliente HTTP debe contener:

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

Los campos exactos de autenticación dependen del cliente. No exponga el endpoint de forma anónima ni guarde credenciales de larga duración en el historial de comandos.

Flujo gobernado esperado​

El cliente debe seguir estos pasos en orden:

  1. Cargar el contexto de diseño activo y el Blueprint del page_type solicitado.
  2. Cargar smartcloud-agent-composer/get-content-field-contract cuando el Blueprint use campos registrados.
  3. Enumerar los patrones aprobados y leer contenido de referencia o medios existentes cuando el Blueprint use contenido Gutenberg.
  4. Ensamblar y validar el documento o registro estructurado propuesto sin guardarlo.
  5. Crear un borrador propiedad del agente con una clave de idempotencia única.
  6. Para cada campo de relación, llamar a smartcloud-agent-composer/search-relation-targets y usar solo los valores matches[].id devueltos. No usar smartcloud-agent-composer/list-content-drafts para resolver relaciones.
  7. Cuando el acceso a taxonomías esté activado, cargar smartcloud-agent-composer/get-taxonomy-contract, buscar mediante search-taxonomy-terms, reutilizar un matches[].term_id exacto y crear un término únicamente si no existe ninguno adecuado y se confirma explícitamente create-taxonomy-term.
  8. Leer los tokens de concurrencia actuales del borrador, escribir los campos aprobados con smartcloud-agent-composer/update-content-fields y asignar los IDs de términos permitidos por la política mediante smartcloud-agent-composer/assign-taxonomy-terms.
  9. Verificar los valores estructurados con smartcloud-agent-composer/inspect-content-fields y las asignaciones de términos con smartcloud-agent-composer/inspect-taxonomy-terms.
  10. Cargar la vista previa e informar de los resultados de validación y las URL para la revisión humana.

Una primera solicitud segura sería:

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.

Confirme en WordPress que el resultado es un Borrador y que no ha cambiado ningún contenido publicado.

Actualizar un borrador​

Composer exige los valores actuales de modified_gmt y del token de revisión para actualizar. El cliente debe leer el borrador inmediatamente antes de cambiarlo y enviar esos valores sin modificarlos. Si otro editor guarda antes el borrador, Composer devuelve un conflicto; vuelva a cargarlo y revíselo en lugar de reintentarlo con tokens obsoletos.

Solución de problemas​

  • Falta el endpoint: confirme que MCP Adapter y Composer estén activos y vuelva a cargar WordPress después de limpiar procesos PHP obsoletos.
  • No autorizado o prohibido: autentíquese como el usuario dedicado y confirme el rol smartcloud_agent; no lo resuelva concediendo el rol Administrador.
  • No hay configuración activa: valide y active explícitamente un Config Set.
  • No se encuentra el Blueprint: use el page_type estable exacto configurado en el conjunto activo.
  • Falta un patrón o bloque: vuelva a escanear el sitio, confirme el registro y actualice un Config Set de trabajo clonado.
  • El proveedor no está preparado: revise Theme & providers y la configuración propia del plugin proveedor.
  • Una búsqueda por título informa de coincidencias, pero no devuelve elementos editables: smartcloud-agent-composer/list-content-drafts no resuelve relaciones. Lea el contrato de campos de contenido y llame a smartcloud-agent-composer/search-relation-targets para el campo de relación declarado.
  • Falta una herramienta de taxonomía o rechaza la taxonomía: vuelva a ejecutar el descubrimiento del sitio, clone el Config Set activo, active esa taxonomía registrada en Composer taxonomy access, valide y active el sucesor, reinicie MCP y actualice el catálogo del cliente.
  • Conflicto: vuelva a cargar el borrador y use sus tokens de concurrencia actuales.
  • Vista previa no válida: lea el informe de validación; no publique ni eluda la restricción que ha fallado.

La ruta MCP directa envía solicitudes entre el cliente configurado y WordPress. Composer no necesita una cuenta de OpenAI, un túnel Connector ni una suscripción a WP Suite para este flujo.