Referencia de las herramientas de autoría de POM
Diez herramientas de solo lectura que indican a un cliente MCP cómo debe editarse un sitio POM, antes de que escriba nada. Son la diferencia entre el contenido generado que funciona y el contenido generado que simplemente parece que debería funcionar.
Las herramientas
| Herramienta | Responde |
|---|---|
pom_get_authoring_context |
¿Qué tipo de sitio es este y qué debo llamar a continuación? |
pom_get_available_blocks |
¿Qué bloques están permitidos para este objetivo de edición? |
pom_get_block_schema |
¿Qué esquema nativo y reglas de anidamiento se aplican a este bloque? |
pom_validate_block_content |
¿Cumple este documento de bloque el contrato del servidor? |
pom_get_available_shortcodes |
¿Qué shortcodes existen aquí? |
pom_get_shortcode_schema |
¿Qué atributos acepta este en concreto? |
pom_validate_builder_content |
¿Es válido el contenido de esta página? |
pom_get_available_mergetags |
¿Qué etiquetas de combinación son válidas en este contexto de plantilla? |
pom_get_template_schema |
¿Qué forma adopta este tipo de plantilla? |
pom_validate_template_markup |
¿Es válido este marcado de plantilla? |
Las diez son de solo lectura y no tienen puerta de escritura. Siguen aplicándose la autenticación, los permisos y los límites de solicitudes habituales.
Dos grupos de alcance
| Herramientas | Alcances | Permiso |
|---|---|---|
| Contexto, shortcodes, esquema de shortcode, validación del constructor | mcp:read, wp:content:read |
edit_posts, o edit_post para un objetivo concreto |
| Catálogo de bloques, esquema de bloque, validación de bloque | mcp:read, wp:content:read |
El permiso de edición del tipo de contenido, o edit_post para un objetivo existente |
| Etiquetas de combinación, esquema de plantilla, validación de plantilla | mcp:read, pom_theme:read |
edit_theme_options |
La división sigue el trabajo: el contenido de la página es un permiso de contenido y las plantillas son un permiso del tema. Un cliente que puede editar páginas no puede inspeccionar necesariamente las plantillas.
Los dos flujos de trabajo a los que sirven
Crear contenido de páginas
Lee primero el contexto y la fuente existente. Para Gutenberg, sigue block editor authoring, incluido el serializador de navegador instalado y un guardado real del editor. Para un documento del Classic Builder existente:
pom_get_authoring_contextpom_get_available_shortcodespom_get_shortcode_schemapara cada shortcode que vayas a usar- Redacta
pom_validate_builder_content- Corrige y vuelve a validar
- Escribe con una herramienta de contenido
Crear una plantilla
pom_get_template_schemapom_get_available_mergetags- Redacta
pom_validate_template_markup- Corrige y vuelve a validar
- Escribe con
pom_theme_upsert_html_template
Los pasos 2, 3 y 5 son los que un asistente se salta si no se le indica lo contrario. Consulta Validate builder or template markup before writing.
Por qué fallan las suposiciones
El contenido del constructor clásico de POM son shortcodes anidados, y el vocabulario es específico de este sitio: qué módulos habilita el tema, qué atributos acepta cada uno y qué anidamiento es legal.
Un asistente que redacta a partir de conocimientos generales produce un marcado con nombres de atributos plausibles que se ignoran silenciosamente, módulos que no existen y columnas fuera de las filas. Las escrituras de contenido de MCP rechazan las violaciones de la paleta del objetivo, mientras que los contratos de atributos incompletos siguen requiriendo inspección antes de confiar en su comportamiento.
Las herramientas de esquema eliminan las suposiciones; los validadores detectan lo que queda.
Los errores no son la única salida
Los validadores devuelven valid, issues y un summary. Los resultados de shortcode/plantilla incluyen pasos siguientes sugeridos; la validación de bloques identifica además su alcance en el servidor y la comprobación de navegador restante. Los problemas llevan una gravedad:
- error — el contenido no es válido;
valides falso y no deberías escribir. - aviso — inspecciona la limitación o decisión indicada; esto no demuestra que un atributo funcione.
Los avisos merecen leerse en lugar de descartarse. Son la forma en que la capa te dice que una página está usando un elemento desaconsejado, o que depende de estilos en línea en lugar de los atributos de shortcode que existen para ese cometido.
Capas relacionadas
Recursos contienen la guía más extensa a la que apunta la herramienta de contexto: la documentación del constructor, las guías de diseño y modelo de contenido, y las referencias de plantillas y etiquetas de combinación por contexto. Consulta MCP resources.
Prompts codifican flujos de trabajo completos que incluyen estas herramientas en el orden correcto. Cuando uno cubra tu tarea, empieza por él. Consulta Prompt recipes.