Gestiona sitios web multisitio desde la conexión del sitio principal

Los superadministradores de la red pueden usar una única conexión MCP del sitio principal para gestionar contenido, medios, términos de taxonomía, menús, POM Theme ajustes, modelos de contenido, plantillas, formularios y búsqueda facetada en los sitios de la misma red de WordPress. Las operaciones del catálogo de WooCommerce y de POM Cache están disponibles cuando sus integraciones están instaladas. El sitio principal necesita una licencia vigente de POM AI Unlimited, mensual o anual.

Activa POM AI en cada destino de forma individual o en toda la red. Un destino delegado no necesita licencia local, clave de API, conexión OAuth ni un ajuste MCP habilitado. Se requiere WordPress 6.9 o superior; POM AI incluye el MCP Adapter oficial.

Configura la conexión

  1. Activa POM AI en el sitio principal y en cada destino.
  2. Conecta la licencia Unlimited del sitio principal en Settings → POM AI → License.
  3. Habilita POM AI MCP en Settings → POM AI → AI Toolsy, a continuación, Enable OAuth en Settings → POM AI → MCP server.
  4. Usa enlaces permanentes bonitos y HTTPS en el sitio principal. Asegúrate de que los eventos programados de WordPress se ejecuten en cada destino con el tema y los plugins de ese sitio cargados. Los destinos pueden usar enlaces permanentes simples.
  5. Como superadministrador, abre Network Admin → Settings → POM AI Network MCPSelecciona Enable network delegation y los grupos de escritura necesarios, y guarda.
  6. Autoriza al cliente frente a la URL MCP del sitio principal. Las lecturas de red requieren mcp:read y network:sites:read; las escrituras de red también requieren mcp:write y network:sites:writeCada herramienta de destino requiere además sus propios ámbitos mostrados por el descubrimiento, como wp:content:write o pom_theme:write.

Las concesiones existentes no adquieren nuevos ámbitos automáticamente. Vuelve a autorizar para los ámbitos que falten. El consentimiento cubre los sitios elegibles actuales y futuros de esta red; el actor debe seguir siendo superadministrador.

Elige los grupos de escritura

Opción de red Concede
Allow delegated page writes Solo la operación de guardado de páginas con revisiones
Allow all supported content, forms, media and taxonomy writes Tipos de contenido admitidos, formularios, nombres/slugs/imágenes/orden de términos, medios, menús y metadatos de contenido
Allow POM Theme settings, content models, templates and search configuration Configuración de tema admitida, definiciones de CPT/taxonomía, plantillas, consultas guardadas y contextos de facetas
Allow supported WordPress site settings Opciones de WordPress permitidas y asignaciones de páginas de portada/entradas/privacidad
Allow WooCommerce catalog and coupon writes Operaciones de comercio admitidas
Allow site cache maintenance Limpieza de POM Cache

Un permiso de escritura de páginas existente sigue limitado a páginas. Los grupos más amplios empiezan deshabilitados. Algunas operaciones necesitan más de un grupo, como asignar scripts de tema existentes al contenido. Cada escritura en un sitio también necesita tu aprobación.

Trabaja en un destino

El envío y pom_get_task se devuelven de inmediato. La operación en sí se ejecuta en el cron de WordPress del destino; no requiere una solicitud HTTP entre sitios. Espera el poll_after_seconds devuelto y consulta la misma tarea en la conexión del sitio principal mientras terminal sea falso. Su phase distingue entre esperar el envío, esperar el cron del destino y ejecutar. Usa el result de una tarea completada para cada paso siguiente; detente e inspecciona los errores para failed, expired o uncertain.

Un destino delegado carga su catálogo de herramientas cuando su trabajador reclama una operación. La delegación de red no habilita el endpoint MCP independiente de ese destino ni requiere una configuración OAuth local. Un MCP de sitio habilitado de forma independiente sigue disponible mediante su propia configuración.

Cada destino puede tener su siguiente operación programada de forma independiente, de modo que un sitio esperando al cron no impide que otro sitio empiece. POM AI sigue ejecutando solo una operación pesada a la vez en toda la instalación. Mantén habilitado el ejecutor de eventos programados del destino y respeta el retraso de consulta.

Recopila y guarda cada resultado con prontitud. Los resultados están disponibles hasta una hora después de la finalización; los recibos de tareas terminadas más antiguos pueden eliminarse antes cuando el trabajo nuevo necesite capacidad. Si falta un recibo, inspecciona el destino antes de repetir una escritura. Las entradas de auditoría de ejecución de red aparecen en el registro MCP del sitio principal e identifican el ID de blog del destino.

  1. Llama a pom_network_get_contexty, a continuación, pom_network_list_sitesSigue next_offset cuando esté presente.
  2. Selecciona el blog_id solicitado y llama a pom_network_discover_siteLee su site, herramientas, esquemas, ámbitos requeridos y grupos de escritura.
  3. Llama a pom_network_read_site con el blog_idseleccionado, el name de herramienta descubierto y sus argumentsIncluye el UUID site_id del destino dentro de arguments.
  4. Previsualiza una escritura descubierta con pom_network_execute_site y arguments.dry_run: true.
  5. Envía la escritura exacta prevista, incluyendo expected_revision donde se requiera. Para varias operaciones conocidas, enruta pom_site_prepare_write_job a este destino para una única aprobación combinada. Revisa en el diálogo de confirmación del cliente o mediante el enlace devuelto del sitio principal, que identifica claramente el destino. No necesitas iniciar sesión en el destino.
  6. Ejecuta cada operación original con el approval_id devuelto dentro de argumentsLee el estado del trabajo con pom_site_get_write_job mediante pom_network_read_site.
  7. Inspecciona el resultado, vuelve a leer el objetivo y verifica su editor o frontend. Después de crear un CPT, una taxonomía o una consulta, o de activar una función del tema, haz una solicitud nueva y vuelve a descubrir los contratos dependientes.

blog_id selecciona el sitio; site_id verifica su identidad. Los ID de entradas, términos y medios pertenecen a ese destino. Usa los esquemas devueltos en lugar de copiar el catálogo de otro sitio. El hecho de que una herramienta aparezca listada no significa que su ámbito o grupo de escritura esté habilitado.

Para trabajo iterativo, enruta pom_site_request_work_session al destino y autoriza explícitamente sus grupos seleccionados en el sitio principal. Las sesiones duran una, cuatro u ocho horas desde la aprobación y permiten hasta 500 operaciones identificadas por separado. Usa work_session_id y un nuevo operation_id para cada escritura permitida, y luego inspecciona pom_site_get_work_sessionLas herramientas de eliminación y los planes compuestos siguen necesitando una revisión exacta. Revoca la sesión desde su enlace de revisión del sitio principal. Consulta Authorize a network work session.

Tareas comunes

Tarea Herramientas del destino
Leer y editar páginas, entradas y elementos CPT públicos wp_get_posts, pom_site_get_content, pom_site_save_content
Inspeccionar cualquier taxonomía gestionable wp_get_taxonomies, wp_get_terms, wp_get_term
Cambiar campos o imágenes de términos wp_create_term, wp_update_term, wp_delete_term
Renombrar términos sin cambiar los slugs wp_rename_terms
Establecer posiciones de términos en un lote wp_reorder_terms
Crear CPT, taxonomías y campos personalizados pom_theme_configure_content_model
Descubrir y aplicar parches a los ajustes del tema pom_theme_get_settings_catalog, pom_theme_get_setting_contract, pom_theme_patch_settings
Configurar consultas de listado y contextos de facetas pom_site_get_listing_catalog, pom_site_save_query, pom_site_save_facets, pom_site_reindex_facets

La red enruta el catálogo de herramientas del sitio revisado. No ejecuta capacidades arbitrarias de WordPress ni enruta recursivamente otra puerta de enlace de red/cuenta. La administración de usuarios, las credenciales, la creación de código ejecutable y la edición de reglas de permisos quedan fuera del catálogo de autoría. Los recursos y los prompts están disponibles en conexiones directas; usa las herramientas de descubrimiento y autoría enrutadas para el trabajo en red.

Verifica y recupera

Las respuestas enrutadas contienen blog_id, isError y resultInspecciona el error interno y cualquier campo complete, approval_required o de estado del plan. Un dry_run: true a nivel de contenedor fuerza una previsualización del destino.

Si una respuesta no puede confirmarse, inspecciona el destino antes de reintentar: es posible que la operación se haya completado. Si las revisiones o aprobaciones están obsoletas, vuelve a leer y previsualizar. Ninguna operación revierte automáticamente un sitio web completo.

Borra la opción de escritura de un área para rechazar sus escrituras y previsualizaciones. Borra Enable network delegation para detener el enrutamiento. Revoca la concesión OAuth del sitio principal para detener a ese cliente. Ninguna de estas acciones deshace los cambios completados.

Las conexiones independientes de subsitios siguen requiriendo la licencia propia válida del subsitio, autorizada por dominio, y su propia autenticación, ámbitos y permisos. Nunca heredan la concesión de red. La autoría delegada no habilita servicios de IA respaldados por cuenta para los usuarios de subsitios.

Para destinos no disponibles, comprueba la activación, el estado del sitio, la red seleccionada, la URL del destino y su ejecutor de eventos programados. Para rechazos por autorización, comprueba la licencia del sitio principal y la autorización del dominio. Los fallos temporales de verificación rechazan la delegación sin interrumpir el sitio web.