WP Rocket MCP Server: como lidar com o cache e as configurações usando ferramentas de IA

Aviso de afiliados v3.1
Aviso de afiliados v3.2 (somente celular)

Com o WP Rocket MCP Server ativado, ferramentas de IA como o Claude limpam o cache e mudam configurações sem que você abra o painel. MCP é um padrão de conexão que permite às ferramentas de IA controlar programas diretamente; aqui estão como conectar e desconectar com uma senha de aplicativo e as 12 funções que ficam disponíveis.

O que é MCP está explicado no post sobre os conceitos básicos do Claude MCP.

1️⃣ O que é o WP Rocket MCP Server?

O WP Rocket MCP Server fica no topo da aba [Configurações → WP Rocket → Tools], com o título [Connect your AI tool to WP Rocket]. Não há chave para ligar e desligar, e o botão [How to set up MCP] abre a documentação de ajuda.

WP Rocket Tools tab: MCP Server, Connect your AI tool to WP Rocket

Desde o WP Rocket 3.23 (9 de julho de 2026), ele vem em todas as licenças, e com o WP Rocket ativo o servidor MCP também fica aberto. Ele registra 12 funções na Abilities API, que está no núcleo do WordPress desde a versão 6.9, e o MCP Adapter já vem dentro do plugin, então não há nada para instalar à parte.

2️⃣ Como conectar o WP Rocket MCP Server

O jeito mais simples é uma conexão OAuth que adiciona o seu site ao Claude como conector personalizado; não precisa de senha nem de arquivo de configuração, só da aprovação no painel do WordPress. No claude.ai na web e no Claude Desktop, a ordem é a mesma.

  1. No Claude, em [Customize → Connectors], clique em [Add → Add custom connector].
  2. Coloque o nome do site no nome e [https://seu-dominio/wp-json/mcp/mcp-oauth-server] na URL do servidor MCP, e clique em [Continue].
Método de conexãoEndereço
Conexão OAuthhttps://seu-dominio/wp-json/mcp/mcp-oauth-serverCampo da URL do servidor MCP no conector personalizado
Senha de aplicativohttps://seu-dominio/wp-json/mcp/mcp-adapter-default-serverValor de WP_API_URL no arquivo de configuração
Troque [seu-dominio] pelo endereço do seu site. Na conexão OAuth basta o endereço da primeira linha; ao aprovar, o WordPress cria sozinho uma senha de aplicativo chamada [Claude]. A segunda linha serve para o método com o arquivo de configuração do Claude Desktop, mais abaixo.
Claude Add custom connector: WP Rocket MCP OAuth server URL
Claude Add custom connector: WP Rocket MCP OAuth server URL
  1. Deixe o método de autenticação no padrão detectado, clique em [Add] e depois em [Connect].
  2. Na tela de autorização do WordPress, clique em [Allow]. Se você não estiver logado como administrador, faça login primeiro.
WordPress authorize access screen for Claude MCP

Depois de conectar, a tela do conector mostra 3 ferramentas, todas em [Needs approval] por padrão. A conta gratuita só cria um conector personalizado, então só conecta um site; para vários sites é preciso uma conta Pro ou Max.

Claude connector tool permissions: Discover Abilities, Get Ability Info, Execute Ability
Claude connector tool permissions: Discover Abilities, Get Ability Info, Execute Ability

Se você perguntar num chat novo quais ferramentas MCP estão disponíveis no site, o Claude pergunta antes [Deny · Always allow · Allow once] para usar uma ferramenta.

Claude asks approval before using an MCP tool
Claude asks approval before using an MCP tool

Durante a conexão apareceu um erro como o da imagem abaixo,

Claude connector shows a connection problem

e a análise mostrou que ele vem de uma configuração da REST API.

Em sites com [Disable REST API] do Perfmatters em [Disable When Logged Out], nenhuma ferramenta aparece no conector mesmo depois da aprovação e da conexão, e logo ele muda para [Connection problem]. O Perfmatters vê as requisições do Claude como de um visitante sem login e as bloqueia antes que o MCP confira o token.

Em [Perfmatters → Code], crie um novo snippet PHP, cole o código abaixo sem a linha [<?php] e salve com o snippet ativado. O código só abre exceção para o endereço do MCP, então os outros bloqueios da REST API continuam.

⚙️ Tela de configurações do PerfmattersNovo snippet de código
perfmatters
⚙General
JSJavaScript
✎CSS
◷Preloading
▣Lazy Loading
AFonts
◍CDN
▥Analytics
</>Code
🔧Tools
☰Database
🔑License
?Support
<> Code
All Snippets / MCP REST API exception
ActiveSave Snippet
Name
MCP REST API exception
Location
Everywhere⌄
Type
PHPJSCSSHTML
Code
<?php
1// Let WP Rocket MCP (OAuth) requests through the Perfmatters REST API restriction
2add_filter('perfmatters_rest_api_exceptions', function($exceptions) {
3 $exceptions[] = '/mcp/mcp-oauth-server';
4 return $exceptions;
5});
  1. ①No menu [Code], clique em [New Snippet].
  2. ②Digite um nome e deixe [Location] em [Everywhere] e [Type] em [PHP].
  3. ③Pegue o código com o [Copy] desta tela e cole no campo de código abaixo da linha [<?php].
  4. ④Ligue o botão em [Active] e clique em [Save Snippet].

Depois de salvar, clique em [Reconnect] na tela do conector do Claude e as 3 ferramentas aparecem.

Esta correção do erro da REST API do WP Rocket MCP Server é para quem usa o Perfmatters, mas, se você já usa o Claude e a configuração da REST API de outro plugin gerar a mesma mensagem de erro, use este código como referência, peça ao Claude para adaptá-lo e aplique uma versão adequada ao seu próprio site WordPress.

No Claude Desktop também dá para conectar com uma senha de aplicativo. Crie uma senha no WordPress em [Usuários → Perfil → Senhas de aplicativo] e, no Claude Desktop, em [Settings → Developer], coloque no arquivo de configuração o item abaixo e abra o app de novo.

{
  "mcpServers": {
    "wp-rocket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://seu-dominio/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "seu-nome-de-usuario",
        "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "OAUTH_ENABLED": "false"
      }
    }
  }
}

No Windows é preciso ter o Node.js, porque o comando npx precisa rodar. Para desconectar, basta revogar essa senha de aplicativo.

3️⃣ O que as ferramentas de IA podem fazer

As 12 funções do WP Rocket rodam pelas três ferramentas MCP que o Claude vê ([Discover Abilities], [Get Ability Info], [Execute Ability]) e se dividem em três grupos: configurações, cache e Rocket Insights.

🤖 12 funções MCP do WP Rocket6 de leitura · 6 de alteração
⚙️ Configurações2
Ler valores das configuraçõesLeitura
wp-rocket/get-options
Mudar um valor de configuraçãoAlteração
wp-rocket/set-option
🗂️ Cache4
Limpar o cache do site inteiroAlteração
wp-rocket/clear-website-cache
Limpar o cache de URLs indicadasAlteração
wp-rocket/clear-url-cache
Verificar o status de cache de uma URLLeitura
wp-rocket/get-cache-status
Progresso do pré-carregamento e URLs restantes estimadasLeitura
wp-rocket/get-cache-health
📊 Rocket Insights6
Ler as pontuações do Rocket InsightsLeitura
wp-rocket/get-insights-scores
Ler a pontuação do Rocket Insights de uma páginaLeitura
wp-rocket/get-page-insights-score
Ler as recomendações do Rocket InsightsLeitura
wp-rocket/get-recommendations
Adicionar uma página para testar no Rocket InsightsAlteração
wp-rocket/add-page-insights
Remover uma página do Rocket InsightsAlteração
wp-rocket/remove-page-insights
Testar uma página de novoAlteração
wp-rocket/retest-page-insights

Só dá para mudar opções que estão na lista de permitidas; as cinco marcadas como [Proibido para IA] na tela abaixo não podem ser alteradas.

🤖 Configurações do WP Rocket que a IA pode mudarGuia de configuração do WP RocketGuia de configuração do Perfmatters5 proibidas para IA
Painel (Dashboard)
My AccountMinha Conta
Rocket AnalyticsAnalytics do RocketProibido para IA
Rocket Insights
SettingsConfigurações
Performance MonitoringMonitoramento de DesempenhoA IA pode mudar
Content Delivery
RocketCDN
RocketCDN FreeRocketCDN grátisProibido para IA
Other CDN
Your CDNUsar outra CDNA IA pode mudar
Exclude Files from CDNExcluir arquivos da CDNA IA pode mudar
Otimizar Arquivos (File Optimization)
CSS FilesArquivos CSS
Minify CSS filesMinificar os arquivos CSSA IA pode mudar
Excluded CSS FilesArquivos CSS ExcluídosA IA pode mudar
Optimize CSS deliveryOtimizar a entrega do CSSA IA pode mudar
Só o método do Remove Unused CSS pode ser alterado.
Remover CSS não utilizadoA IA pode mudar
CSS safelistLista de CSS seguroA IA pode mudar
JavaScript FilesArquivos JavaScript
Minify JavaScript filesMinificar os arquivos JavaScriptA IA pode mudar
Combine JavaScript filesCombinar os arquivos JavaScriptProibido para IA
Excluded JavaScript FilesArquivos JavaScript ExcluídosA IA pode mudar
Load JavaScript deferredAdiar o carregamento do JavaScriptA IA pode mudar
Excluded JavaScript FilesArquivos JavaScript ExcluídosA IA pode mudar
Delay JavaScript executionAtrasar a execução do JavaScriptA IA pode mudar
One-click exclusionsExclusões de um cliqueProibido para IA
Excluded JavaScript FilesArquivos JavaScript ExcluídosA IA pode mudar
Safe Mode for Delay JavaScript ExecutionModo Seguro para Atraso na Execução do JavaScriptProibido para IA
Mídia (Media)
LazyLoadCarregamento adiado
Enable for imagesHabilitar para imagensA IA pode mudar
Enable for CSS background imagesAtivar para as imagens de fundo do CSSA IA pode mudar
Enable for iframes and videosHabilitar para iframes e vídeosA IA pode mudar
Replace YouTube iframe with preview imageSubstituir o iframe do YouTube pela imagem de pré-visualizaçãoA IA pode mudar
Excluded images or iframesImagens e iFrames excluídosA IA pode mudar
Image DimensionsDimensões da imagem
Add missing image dimensionsAdicionar dimensões de imagens faltandoA IA pode mudar
FontsFontes
Preload fontsFontes (pré-carregamento)A IA pode mudar
Self-host Google FontsAuto-hospedar Fontes GoogleA IA pode mudar
Pré-Carregar (Preload)
Preload CachePré-carregar o cache
Activate PreloadingAtivar o Pré-CarregamentoA IA pode mudar
Exclude URLsExcluir URLsA IA pode mudar
Preload LinksPré-carregar Links
Enable link preloadingAtivar o pré-carregamento dos linksA IA pode mudar
Regras Avançadas (Advanced Rules)
Cache LifespanVida útil do cache
Clear cache afterLimpar o cache apósA IA pode mudar
Never Cache URL(s)URL(s) Jamais em Cache
Never Cache URL(s)URL(s) Jamais em CacheA IA pode mudar
Never Cache CookiesCookies Jamais em Cache
Never Cache CookiesCookies Jamais em CacheA IA pode mudar
Never Cache User Agent(s)User Agent(s) Jamais em Cache
Never Cache User Agent(s)User Agent(s) Jamais em CacheA IA pode mudar
Always Purge URL(s)Sempre Esvaziar URL(s)
Always Purge URL(s)Sempre Esvaziar URL(s)A IA pode mudar
Cache Query String(s)String(s) de Consulta em Cache
Cache Query String(s)String(s) de Consulta em CacheA IA pode mudar
Banco de Dados (Database)
Post CleanupLimpeza de Post — vale para revisões, rascunhos automáticos e posts na lixeira.
RevisionsRevisõesA IA pode mudar
Auto DraftsRascunhos AutomáticosA IA pode mudar
Trashed PostsPosts na LixeiraA IA pode mudar
Comments CleanupLimpeza de Comentários — exclui comentários de spam e excluídos.
Spam CommentsComentários SpamA IA pode mudar
Trashed CommentsComentários na LixeiraA IA pode mudar
Transients CleanupLimpeza de Transientes — limpa todos os transientes armazenados no banco de dados.
All transientsTodos os transientesA IA pode mudar
Database CleanupLimpeza do Banco de Dados
Optimize TablesOtimizar TabelasA IA pode mudar
Automatic CleanupLimpeza automática
Schedule Automatic CleanupAgendar Limpeza AutomáticaA IA pode mudar
FrequencyFrequênciaA IA pode mudar
Heartbeat
Heartbeat
Control HeartbeatControlar HeartbeatA IA pode mudar
Reduce or disable Heartbeat activityReduz ou desabilita a atividade Heartbeat
Behavior in backendComportamento no painelA IA pode mudar
Behavior in post editorComportamento no editor de postA IA pode mudar
Behavior in frontendComportamento na interfaceA IA pode mudar
Complementos (Add-ons)
One-click Rocket Add-onsComplementos de um clique do Rocket
User CacheCache de UsuárioA IA pode mudar
VarnishA IA pode mudar
WebP CompatibilityCompatibilidade com WebPA IA pode mudar
Rocket Add-onsComplementos do Rocket
CloudflareA IA pode mudar
SucuriA IA pode mudar

4️⃣ Exemplos de uso

Depois de conectar o testpilotweb.com, pedi ao Claude [limpe só o cache da página inicial], e a janela de aprovação mostrou primeiro a função a executar (wp-rocket/clear-url-cache) e o endereço.

Claude approval prompt for wp-rocket/clear-url-cache with the homepage URL

Ao clicar em [Allow once], só os arquivos de cache da página inicial foram apagados no servidor, e o cache dos outros posts continuou lá.

Dá para conferir as configurações perguntando, sem entrar no painel; quando perguntei [o Delay JavaScript execution está ativado agora?], ele respondeu com o valor da configuração e o estado da lista de exclusões.

Claude answers whether Delay JavaScript execution is enabled

Na primeira vez num chat, aparecem antes duas janelas de aprovação para ler a lista e as descrições das funções, e como até as funções de leitura passam pelo [Execute Ability], a janela de aprovação aparece mesmo ao ler configurações.

5️⃣ Pontos de atenção

As tarefas em que a ferramenta de IA muda configurações ou limpa o cache só rodam depois da sua aprovação. A senha de aplicativo pode ser revogada a qualquer momento na tela em que foi criada.

A verificação do status do cache e a estimativa do pré-carregamento só dão resultado com o [Preload Cache] do WP Rocket ativado.

Se não conectar, olhe primeiro o arquivo de configuração. Muitas vezes falta uma vírgula entre os itens, ou o arquivo foi salvo sem trocar o endereço, o nome de usuário e a senha.

🧭 Posts relacionados ao WP Rocket e ao Perfmatters 15 artigos · 3 ferramentas
🗂️ O que é o WP?
📋 Guia de configuração do WP Rocket 📄 Guia do Perfmatters 📄 WP Rocket With Perfmatters 📄 WP Rocket MCP Server 📄 WP Rocket e URLs em coreano 📄 nginx njs 📄 Cache multilíngue do WP Rocket 📄 Cache e gclid
📄 Teste de velocidade do WP Rocket 📝 Plugins de cache e otimização 📝 Caso de melhoria de velocidade
📋 Cache: definição e todos os campos 📄 Cache do site & cache interno do servidor
📋 TOP 7 melhores hospedagens 📄 Hospedagem rápida 2026
🛠️ Detector de WordPress 🛠️ Consulta WHOIS de domínio 🛠️ Qual é o meu IP
Guia de configuração do WP Rocket: configurações básicas por menu e cupom de 20%
WordPress · WP Rocket
Guia de configuração do WP Rocket: configurações básicas por menu e cupom de 20%
Post que reúne as configurações básicas de cada menu do WP Rocket e os preços.
Ver post →Conteúdo atual
Review & guia do plugin Perfmatters: como configurar a otimização de desempenho do WordPress após 5 anos de uso
WordPress · Perfmatters
Review & guia do plugin Perfmatters: como configurar a otimização de desempenho do WordPress após 5 anos de uso
Configurações recomendadas do Perfmatters por menu e como usar o Script Manager.
Ver post →Conteúdo atual
Como usar o WP Rocket With Perfmatters: guia de configuração dos recursos de otimização
WordPress · Perfmatters
Como usar o WP Rocket With Perfmatters: guia de configuração dos recursos de otimização
Como configurar quando você usa o WP Rocket e o Perfmatters juntos.
Ver post →Conteúdo atual
WP Rocket MCP Server: como lidar com o cache e as configurações usando ferramentas de IA
WordPress · MCP
WP Rocket MCP Server: como lidar com o cache e as configurações usando ferramentas de IA
Como lidar com o cache e as configurações do WP Rocket a partir de ferramentas de IA.
Ver post →Conteúdo atual
Diagrama do fluxo de requisições de URL em coreano com WP Rocket
WordPress · WP Rocket
WP Rocket e URLs em coreano
Por que o nginx não encontra o arquivo de cache por causa de maiúsculas e minúsculas na codificação de requisições de URL em coreano, e como corrigir com njs.
Ver post →Conteúdo atual
Diagrama das variáveis do nginx njs e dos caminhos dos arquivos de cache
Server · nginx
nginx njs: instalar o módulo, configurar js_set e aplicar com reload para criar variáveis JavaScript
Como instalar o módulo njs, que cria variáveis com funções JavaScript dentro da configuração do nginx, e aplicar as variáveis js_set com um reload.
Ver post →Conteúdo atual
Diagrama do fluxo de salvamento de posts com o cache multilíngue do WP Rocket
WordPress · WP Rocket
Cache multilíngue do WP Rocket
Por que salvar um rascunho apaga o cache das versões traduzidas junto com a pasta inteira do idioma, e o código que evita isso.
Ver post →Conteúdo atual
Fluxo em que uma requisição com consulta de anúncio vai ao servidor de origem quando o CDN não tem cópia, passa do nginx ao Apache e o WP Rocket remove a consulta e responde com o mesmo arquivo de cache
Server · Cache
Cache e gclid: consulta do clique no anúncio, chave de cache da página e primeiro byte medido
Mede pelo primeiro byte como a consulta gclid adicionada ao fim das URLs de clique em anúncios é ignorada e a resposta vem do arquivo de cache da URL sem consulta.
Ver post →Conteúdo atual

ℹ️ Aviso de afiliados
O conteúdo deste site contém links de afiliados. Quando um visitante compra um produto ou serviço por meio de um desses links, o site recebe uma comissão do vendedor. O valor que o comprador paga (em promoções, ele diminui ↓) não aumenta por causa disso. Preços, descontos e informações de estoque valem para o momento em que o texto foi escrito e podem ter mudado, por isso confirme com o vendedor antes de comprar. Os produtos são escolhidos e avaliados por critérios próprios, e o recebimento de comissão não influencia a ordem de apresentação nem o conteúdo das avaliações.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Demonstre sua humanidade: 0   +   3   =