Um servidor MCP para a IA construir no Bricks e no Elementor.

01Visão geral

O MarreiraMCP Builders funde os antigos plugins MarreiraMCP Bricks e MarreiraMCP Elementor num único produto. O servidor MCP é escrito em PHP dentro do próprio plugin — não há serviço Node separado —, exposto numa rota REST oculta do índice público. A IA conversa por JSON-RPC 2.0; o dono do site controla tudo por um painel e por um token com escopos.

Novo × antigo

Antes eram dois plugins separados, cada um mais simples. O unificado entrega mais poder e segurança para os dois builders de uma vez.

02Arquitetura

O núcleo (servidor MCP, CLI, auth, audit) é agnóstico de builder. Toda lógica específica vive num driver, e o Builder_Manager carrega apenas o driver ativo. Um builder por vez.

   Cliente MCP / IDE / WP-CLI
            │  Bearer <token>
            ▼
  ┌───────────────────────────────┐
  │  Núcleo (Marreira\MCP_Builders)│
  │  MCP_Server · Tool_Registry    │
  │  Rest_Guard · Audit_Log        │
  │  Batch_Runner · Context_Strategy│
  └───────────────┬───────────────┘
                  │ Builder_Manager (1 ativo)
        ┌─────────┴─────────┐
        ▼                   ▼
  ┌───────────┐       ┌────────────┐
  │Bricks_Driver│      │Elementor_Driver│
  │ árvore plana│      │ árvore aninhada│
  │ classes/paleta│    │ Kit (cores/fontes)│
  └───────────┘       └────────────┘

03Instalação & onboarding

Baixar marreira-mcp-builders-1.8.1.zip

• Instale o zip marreira-mcp-builders-1.8.1.zip em Plugins → Adicionar novo → Enviar e ative.
• Abra o menu MarreiraMCP e rode o assistente: escolha o builder (ele detecta o que está ativo no site), escolha o tier de IA (premium ou econômico) e gere o primeiro token — ele aparece uma única vez.
• Configure o cliente MCP com o endpoint e o token (abaixo).

04Conexão & endpoints

Autentique com Authorization: Bearer <token> sobre HTTPS. As rotas ficam ocultas do índice de /wp-json/.

POST /wp-json/marreira-mcp/v1/mcp
Authorization: Bearer mmcb_XXXX.XXXXXXXX
Content-Type: application/json

{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

4bConector (Claude.ai / ChatGPT)

No app de IA, adicione um conector (servidor MCP remoto) apontando para /wp-json/marreira-mcp/v1/mcp. O OAuth é automático: o app se registra, abre a tela de consentimento no seu WordPress (onde um administrador logado autoriza) e recebe o token. A aprovação acontece nessa tela — não é preciso pré-aprovar nada no painel.

Não conecta? Quase sempre é o firewall / CDN — não o plugin

Erros como “Não foi possível registrar no serviço de login” vêm de Cloudflare, WAF ou plugin de segurança bloqueando as requisições que o servidor da Anthropic/OpenAI faz ao seu site. O conector faz três chamadas de servidor (não de navegador) — registrar o app → pegar o token → usar as tools — com User-Agent de biblioteca (ex.: python-httpx). Bot Fight Mode e WAF costumam barrá-las antes de chegarem ao plugin, então a conexão falha mesmo com tudo certo aqui.

Libere estas rotas no firewall / CDN

/wp-json/marreira-mcp/*
/marreira-mcp-oauth/*
/.well-known/oauth-*

No Cloudflare:

• Security → Bots: desligue o Bot Fight Mode (ou libere essas rotas no Super Bot Fight Mode).
• Security → WAF → Custom rules: uma regra com ação Skip (pular Managed Rules, Rate Limiting e Bot Fight) quando o URI Path contiver /wp-json/marreira-mcp/, /marreira-mcp-oauth/ ou começar com /.well-known/oauth.
• Rate Limiting: isente essas rotas — o conector faz várias chamadas.

No host: se usar Wordfence, Imunify360, BitNinja ou mod_security, coloque as mesmas rotas na allowlist (um 520 costuma ser a origem derrubando a requisição).

05Tools

As tools do builder ativo aparecem em tools/list — sempre confirme os nomes ali. Além delas, o núcleo registra duas tools que valem para qualquer builder.

Do builder (exemplos)

Páginas e templates (CRUD), edição fina de elementos (insert / update / move / delete / duplicate), estilos globais (classes e paleta no Bricks; Kit de cores e fontes no Elementor), introspecção (list_elements, get_element_schema) e utilidades (get_capabilities, validate_tree, regenerate_css).

Do núcleo

06run_batch — a regra de ouro

Para aplicar mais de uma mudança, nunca dispare vários POSTs em sequência: muitas requisições remotas seguidas podem ser lidas por hosts e WAFs como um ataque. Agrupe tudo em um run_batch.

{
  "jsonrpc": "2.0", "id": 7, "method": "tools/call",
  "params": {
    "name": "run_batch",
    "arguments": {
      "commands": [
        { "tool": "create_bricks_page",
          "arguments": { "title": "Home", "elements": [ /* ... */ ] } },
        { "tool": "regenerate_css", "arguments": {} }
      ],
      "stop_on_error": false,
      "dry_run": false
    }
  }
}

A resposta traz o status por comando (results[]) e um resumo (ok / failed). Use dry_run: true para validar sem gravar.

07Modo de IA

O onboarding define um tier que muda como a IA deve consumir contexto — informado também em /describe.

08Tokens & abilities

Cada token é uma credencial estreita: guardamos apenas o hash HMAC-SHA256, com expiração opcional. As abilities limitam o que ele pode fazer — dê ao seu agente só o que ele precisa.

09CLI geral de WordPress

Além do builder, o plugin oferece um controle remoto de WordPress em /wp-json/marreira-mcp/v1/cli/... — no espírito do WP-CLI, porém por token com escopos e auditado.

10WP-CLI local

Para o dono operar pelo terminal do servidor, sem rede nem token — reusa o mesmo registry e o mesmo batch runner.

wp mmcb tools
wp mmcb call get_page --args='{"post_id":12}'
wp mmcb batch mudancas.json --dry-run
wp mmcb builder elementor
wp mmcb token create "agente-ia" --abilities=builder --expires=30

11Segurança

• Token só como hash HMAC-SHA256 (texto puro nunca é gravado nem logado); comparação com hash_equals.
• Escopos por token + expiração; throttle por IP (20 falhas / 5 min) e IP allowlist opcional.
• Revalidação do admin dono a cada requisição — se ele perde o papel, o token para de valer.
• Audit log de cada requisição, com mascaramento de dados sensíveis e retenção configurável.
• Guard anti-RCE recusa execução de código nos elementos; rotas ocultas do índice público.
• Trava dupla para exec/DB/arquivo e self-protection (não se autodesativa, não apaga o tema ativo).
• MMCB_TRUST_PROXY para ler o IP real atrás de proxy/CDN (desligado por padrão, contra spoofing).