claude-plugins/wordpress/skills/mcp-wpmeteor/SKILL.md

name, description, layer

name	description	layer
mcp-wpmeteor	MCP dedicado multi-site (node stdio, ligação `wpmeteor` em ~/.omp/agent/mcp.json) para gerir o WP Meteor (delay/reorder de JavaScript não crítico) em qualquer site do bundle Descomplicar® via WP-CLI/SSH — estado do plugin, config completa, toggle de módulo, delay do ultimate-reorder, exclusões manuais, telemetria detected. Site é um parâmetro em cada tool. Usar quando "gestão wp meteor", "wpmeteor mcp", "desligar ultimate reorder via mcp", "mudar delay wp meteor", "exclusões wp meteor mcp", "activar módulo elementor-pp".	wiki

/mcp-wpmeteor — MCP dedicado multi-site ao WP Meteor

Projecto em /media/ealmeida/Dados/Dev/mcp-wpmeteor/ (TypeScript, SDK MCP oficial, stdio). Sem código PHP novo no WordPress: cada tool executa wp option get / wp option patch via ssh server sobre o WP-CLI já instalado. O plugin não regista nenhum comando WP-CLI próprio (confirmado por grep a todo o código-fonte — ver skill wp-meteor); toda a config vive numa única option, wp-meteor-settings.

Relação com a skill wp-meteor: essa skill é a fonte de conhecimento completa — os 5 módulos reais, a semântica exacta do delay, as duas camadas de exclusão automática embutidas (gdpr, Compatibility), os mecanismos de bypass automático, diagnóstico de CLS/CWV. Esta skill é o "como executar" — qual tool chamar para cada operação. Consultar wp-meteor para entender uma definição antes de a alterar por aqui.

Âmbito

Config do WP Meteor: 5 módulos, delay do ultimate-reorder, exclusões manuais (exclude.value), leitura da telemetria detected. Não cobre: activação/desactivação do próprio plugin (emcp-tools activate-plugin/deactivate-plugin já cobre isso genericamente), diagnóstico de CLS/CWV com Chrome DevTools (workflow manual, ver skill wp-meteor §"Testar isoladamente via Chrome DevTools").

Sites conhecidos

Chamar wpmeteor_list_sites para a lista actual com path e nota de estado. Verificado ao vivo 19-08-2026: só emanuelalmeida tem o WP Meteor instalado — os outros 7 sites reais do bundle (descomplicar, starter, ccv, care, ecommerce-demo, e-commerce, ecommerce) não o têm. Também aceita um path absoluto directamente para sites fora desta lista.

Tools (8)

Tool	Read-only	Uso
wpmeteor_list_sites	sim	Aliases conhecidos, path WP, nota de estado
wpmeteor_get_status	sim	Instalado/activo/versão
wpmeteor_get_config	sim	Option wp-meteor-settings completa
wpmeteor_set_module	não	Liga/desliga um dos 5 módulos (ultimate-reorder, gdpr, exclude, elementor-animations, elementor-pp) — escrita atómica de <module>.enabled, não toca nos outros
wpmeteor_set_delay	não	ultimate-reorder.delay — string numérica; "0" = zero delay, N positivo = timeout fixo de N segundos, negativo (ex. "-1") = só corre na primeira interacção
wpmeteor_get_exclusions / wpmeteor_set_exclusions	sim/não	exclude.value — array de URLs/palavras-chave/regex. Set é substituição completa, não merge. Não liga o módulo exclude sozinho
wpmeteor_get_detected	sim	Telemetria interna (detected), sem tool de escrita — não é configurável

Todas exigem site como primeiro parâmetro.

Padrão de escrita — atómico por chave, não read-modify-write

Diferente do mcp-wpfc (que faz merge em JS de toda a option WpFastestCache), aqui cada escrita usa wp option patch update wp-meteor-settings <key-path...> [--format=json] — o próprio WP-CLI localiza e substitui só a chave aninhada pedida, atomicamente, sem ler+reescrever a option inteira. Menos risco de pisar uma gravação concorrente do wp-admin.

Segurança

Allowlist fixa de 1 option (wp-meteor-settings) e 5 módulos conhecidos (src/wpcli.ts, MODULES). Escritas via base64 em stdin, nunca interpoladas no comando SSH remoto.

Confirmado antes de escrever a bridge (lição de mcp-wpfc/skill wp-fastest-cache §16.2): wp-meteor-settings é um array PHP nativo — wp option get sem --format=json devolve array(...) desestruturado, não uma string. --format=json é portanto o padrão correcto aqui em leitura e escrita (ao contrário do WP Fastest Cache, onde --format=json corrompe a option). Qualquer MCP novo sobre wp option deve continuar a verificar isto primeiro, caso a caso — não assumir nenhum dos dois padrões por omissão.

Verificação

Construído e testado ponta-a-ponta contra produção 19-08-2026 (emanuelalmeida.pt, único site com o plugin instalado): wpmeteor_get_status confirmou activo v3.4.18 lá e ausente em descomplicar; wpmeteor_get_config/wpmeteor_get_exclusions leram a config real; wpmeteor_set_module, wpmeteor_set_delay e wpmeteor_set_exclusions escreveram e relerem correctamente com valores já-correntes (round-trip idempotente, sem alterar comportamento do site); wpmeteor_get_detected confirmou array vazio. Integridade final da option confirmada por leitura SSH directa, idêntica ao estado original.

Skills relacionadas

• wp-meteor — mapeamento completo de todos os módulos, semântica do delay, exclusões automáticas embutidas, mecanismos de bypass, diagnóstico de CLS/CWV.
• mcp-wpfc — mesma convenção (MCP multi-site, site por parâmetro), mas para o WP Fastest Cache; ver lá o gotcha de formato de armazenamento que motivou a verificação prévia aqui.