|

WordPress MCP Server: conectar o Claude Code com o plugin Adapter

O WordPress MCP Server é o ponto de conexão que abre as funções de um site WordPress no formato MCP (Model Context Protocol) para que uma IA como o Claude possa chamá-las como ferramentas. O que o site pode fazer é registrado na Abilities API, incluída no núcleo desde o WordPress 6.9, e o plugin Adapter transforma essa lista em ferramentas MCP para a IA.

Veja o passo a passo para instalar o plugin Adapter 0.7.0 e depois conectar o Claude Code.

1️⃣ Criar uma senha de aplicativo

O servidor padrão do MCP Adapter só processa solicitações autenticadas como um usuário do WordPress, por isso no Claude Code você registra uma senha de aplicativo em vez da senha de login. No painel, em [Users] > [Profile], digite um nome em [Application Passwords] e clique em [Add Application Password] para criá-la. O valor aparece uma única vez, na criação, então copie-o na hora.

Lista de senhas de aplicativo para a conexão MCP do WordPress com o Claude Code adicionado

No teste foi usada uma conta de administrador, mas em um site em produção o certo é criar um usuário dedicado só com as permissões necessárias e gerar a senha com essa conta. Isso porque tudo o que o Claude Code executa é processado dentro das permissões desse usuário.

2️⃣ Registrar o servidor MCP do WordPress no Claude Code

A documentação oficial do WordPress indica o proxy Node.js [@automattic/mcp-wordpress-remote] para conexões HTTP, mas o Claude Code oferece suporte direto ao MCP via HTTP, então o registro é feito sem proxy. O Node.js também não estava instalado no servidor Linux testado.

O valor de autenticação é a string [usuario:senha_de_aplicativo] convertida para Base64, criada no terminal com o comando abaixo.

printf '%s' 'usuario:senha_de_aplicativo' | base64

Ao registrar, coloque o valor convertido depois de [Basic]; o endereço é o do servidor padrão: o domínio do site seguido de [/wp-json/mcp/mcp-adapter-default-server].

claude mcp add --transport http --scope user wordpress https://example.com/wp-json/mcp/mcp-adapter-default-server --header "Authorization: Basic VALOR_AUTH"

No comando, [wordpress] é o nome do registro, e a string convertida vai no lugar de [VALOR_AUTH]. Registrando com [--scope user], sessões abertas em qualquer pasta usam essa conexão.

3️⃣ Verificar a conexão e as Abilities executáveis

Execute [claude mcp list]; se [✔ Connected] aparecer no fim da linha com o nome do registro, a conexão está feita. As ferramentas do WordPress aparecem a partir de uma nova sessão.

claude mcp list
wordpress: https://example.com/wp-json/mcp/mcp-adapter-default-server (HTTP) - ✔ Connected

É fácil imaginar que, conectado, a consulta de informações do site vai funcionar na hora, mas o servidor padrão só executa Abilities marcadas com [mcp.public]. No site de teste, as Abilities encontradas foram as 12 que o WP Rocket publica, incluindo limpar o cache, verificar o estado do cache e consultar a pontuação de desempenho das páginas. Ao pedir o estado do cache do WP Rocket em uma nova sessão, [wp-rocket/get-cache-health] foi executada e retornou 4 pré-carregamentos concluídos e 0 pendentes.

As Abilities do núcleo do WordPress para informações do site, do usuário e do ambiente não foram executadas e deram o erro [is not exposed via MCP (mcp.public!=true)]. As Abilities do núcleo só se abrem quando [mcp.public] é ativado com o filtro [wp_register_ability_args], e o método está explicado no blog oficial de desenvolvedores do WordPress.

Claude Code Authorization: Basic Site WordPress Servidor padrão do MCP Adapter mcp-adapter-default-server Executar Erro WP Rocket 12 Abilities Com mcp.public Abilities do núcleo 3, incluindo informações do site Sem mcp.public 4 concluídos, 0 pendentes
Em telas estreitas, deslize o diagrama para o lado.

🔢 FAQ & conteúdo recomendado

Ele está no diretório oficial de plugins do WordPress como [MCP Adapter] (autor WordPress.org), então você pode buscá-lo e instalá-lo no painel em [Plugins] > [Add New]. Em fevereiro de 2026 o blog oficial de desenvolvedores mandava baixar pelas versões do GitHub, mas na verificação de outubro de 2026 a versão 0.7.0 já podia ser instalada direto do diretório.

O MCP Adapter 0.7.0 exige WordPress 6.9 ou superior e PHP 7.4 ou superior, porque a Abilities API que o Adapter converte entrou no núcleo a partir do WordPress 6.9.

Com [claude mcp remove wordpress --scope user] você o remove das configurações do Claude Code. Para cortar também o acesso do lado do site, clique em [Revoke] na linha correspondente em [Application Passwords] no seu perfil.

ℹ️ 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: 4   +   9   =