pom_theme_list_settings_schema: listar los esquemas de ajustes

Devuelve la estructura completa de la página de opciones de POM Theme: secciones, pestañas, ajustes y sus campos.

Argumentos

Ninguno. Devuelve todo.

Permisos

mcp:read y pom_theme:read, además de edit_theme_options.

Qué devuelve

page_slug, siempre pom-theme-options, y sections. Cada sección tiene un title y sus tabs; cada pestaña tiene un title y sus settings; cada ajuste tiene:

La sección config queda excluida: es infraestructura interna, no configuración.

Es un mapa, no los valores

Esta herramienta te indica qué puede configurarse y cómo se llama cada ajuste. No te dice a qué está establecido actualmente nada; eso es pom_theme_get_settings_values, que necesita una clave de ajuste que obtienes aquí.

Las dos juntas forman el par de lectura. Esta primero, siempre, porque las claves de ajuste no son adivinables.

Lista el esquema de ajustes y muéstrame las secciones y las pestañas.

Úsala para encontrar la clave correcta

Las claves de ajuste son identificadores internos, y las etiquetas que usa la gente no se corresponden con ellas de forma limpia. Alguien que pide cambiar «la barra lateral del blog» está describiendo algo que el esquema llama post_archive.

¿Qué ajuste y qué campo controlan el diseño de la barra lateral en el archivo del blog?

Equivocarse en esto produce pom_ai_mcp_theme_setting_not_found o, peor, una lectura correcta del ajuste equivocado.

requires_initialization explica los valores vacíos

Un ajuste marcado de esta manera no contiene nada hasta que se ha guardado una vez desde el panel de administración de WordPress. Leerlo devuelve un conjunto vacío, y eso no es un fallo.

Así que una respuesta values vacía para tal ajuste significa «nadie lo ha configurado todavía», no «este ajuste está roto». Guardarlo una vez en el panel de administración rellena los valores predeterminados.

El esquema no dice qué se puede escribir

Esta es la limitación importante. Cada campo que define POM Theme aparece aquí, y pom_theme_update_setting rechazará casi todos: su lista permitida contiene dos campos por defecto.

Por lo tanto, el esquema es un mapa de la configuración del tema, no un menú de lo que MCP puede cambiar. Un asistente que lea el esquema y se ofrezca a ajustar cualquier campo que encuentre será rechazado con pom_ai_mcp_theme_field_denied en casi todos los intentos.

Trata el esquema como documentación de la interfaz de administración, y la lista permitida como la pregunta aparte, mucho más breve, de qué puede escribir un cliente conectado.

La respuesta es grande

Una instalación completa de POM Theme tiene muchas secciones, cada una con pestañas y docenas de campos. Espera una respuesta considerable y pide solo la parte que necesitas en lugar de una recitación:

Lista el esquema y muéstrame solo las secciones relacionadas con la tipografía.

Los resúmenes de campos son estructurales

Cada resumen de campo describe su tipo y su forma, que es como sabes si un valor debe ser texto, una opción o algo complejo. Los campos tipados como código —CSS, HTML, JavaScript— se almacenan como archivos en lugar de valores en línea, por eso leerlos necesita la opción resolve_code_files en la herramienta de valores.

Los campos de JavaScript aparecen en el esquema y nunca pueden escribirse; ese rechazo es incondicional.

Problemas comunes

Relacionado

• pom_theme_get_settings_values — los valores
• pom_theme_update_setting — lo que realmente se puede escribir
• Recurso de esquema de ajustes del tema