Fale com sua loja como se fosse seu assistente de IA

Esta é a primeira parte de uma série de três partes sobre WooCommerce MCP. Esta postagem aborda o que é o MCP, como funciona e como começar a usar as habilidades integradas. A segunda parte aborda a construção de suas primeiras habilidades personalizadas. A terceira parte se aprofunda com demonstrações avançadas e considerações de produção.

Tenho me aprofundado em algo realmente interessante no WooCommerce: o Integração do protocolo de contexto do modelo (MCP). O MCP foi lançado pela primeira vez como versão beta na versão 10.3 e vem amadurecendo ao longo dos lançamentos. Agora, com WooCommerce 10.7 e WordPress 6.9+, a pilha é sólida o suficiente para construir algumas coisas realmente úteis sobre ela. Então, fui em frente e fiz exatamente isso.

Imagine isto: estamos conversando com um assistente de IA e dizemos algo como “Mostre-me meus produtos com pouco estoque” ou “Crie um produto chamado Winter Hoodie por US$ 39,99.“Nossa loja WooCommerce responde, faz o trabalho e devolve os resultados. Sem cliques no painel do WordPress, sem chamadas manuais da API REST. Apenas uma conversa natural se transformando em ações reais da loja.

É isso que o MCP permite. Ao longo deste post, usarei Código Claude como assistente de IA, mas o MCP funciona com qualquer cliente compatível: Cursor, VS Code ou qualquer outro que fale o protocolo MCP. Use o que funcionar melhor para você.

Vamos explorar isso juntos!

Pense em PCM como um tradutor universal entre ferramentas de IA e nossa loja WooCommerce. Normalmente, se quisermos que a IA interaja com a nossa loja, precisaríamos:

Crie integrações personalizadas de API REST.
Cuide da autenticação nós mesmos.
Escreva um monte de código para analisar as respostas.

O MCP muda tudo isso. É um padrão de código aberto que permite que assistentes de IA como Claude, Cursor ou VS Code conversem diretamente com sistemas como WooCommerce usando linguagem natural.

Com MCP:

A IA pode descobrir o que nossa loja pode fazer.
A IA pode realizar essas ações com segurança.
Tudo funciona dentro de nossas permissões existentes.

Então, quando dizemos: “Liste todos os produtos abaixo de US$ 20 USD”, o MCP traduz isso em algo que o WooCommerce entende, executa com segurança e traz de volta os resultados.

Três peças trabalham juntas para que isso aconteça, e todas elas se baseiam na segurança existente do WooCommerce.

Os blocos de construção

API de habilidades do WordPress

O API de habilidades do WordPress é uma forma dos plugins do WordPress registrarem “Habilidades”, basicamente coisas que eles podem fazer. Pense nisso como um menu: o WooCommerce diz ao WordPress: “Aqui está tudo o que posso fazer”, e os assistentes de IA podem ler esse menu e escolher o que precisam. Cada habilidade tem um nome como:

woocommerce/products-list: listar todos os produtos
woocommerce/orders-create: crie um novo pedido

A API Abilities fornecida no WordPress 6.9 como um recurso principal. Ele fornece um registro padronizado ao qual qualquer plug-in pode ser conectado, de modo que o WooCommerce não precisa mais agrupá-lo separadamente. Para aqueles que constroem Habilidades Personalizadas, elas estão registradas no wp_abilities_api_init gancho (mais sobre isso na segunda parte da série).

Adaptador MCP para WordPress

O Adaptador MCP é o tradutor. Ele pega mensagens MCP de assistentes de IA e as converte em algo que o WordPress entende. Pense nele como o intermediário que fala tanto “protocolo de IA” quanto “WordPress”.

API REST do WooCommerce

A ponte atual de habilidades do MCP para os endpoints da API REST existentes. Isso significa que as permissões existentes da API REST ainda controlam tudo e a segurança permanece exatamente a mesma.

No futuro, as Habilidades poderão ir além do REST e fazer coisas ainda mais poderosas. Mas, por enquanto, isso nos dá uma base sólida e segura.

O fluxo de comunicação

Quando digitamos “listar todos os produtos” no Claude Code, eis o que acontece passo a passo:

AI Client (Claude, etc.)

    ↓ (MCP protocol over stdio/JSON-RPC)

Local MCP Proxy (mcp-wordpress-remote)

    ↓ (HTTP/HTTPS requests with authentication)

Remote WordPress MCP Server (mcp-adapter)

    ↓ (WordPress Abilities API)

WooCommerce Abilities

    ↓ (REST API calls or direct operations)

WooCommerce Core

Em termos simples, Claude Code envia uma mensagem para uma pequena ferramenta proxy em execução em nossa máquina. O proxy o converte em uma solicitação da web segura e a envia para o endpoint MCP do nosso site WordPress. O Adaptador MCP procura qual habilidade deve ser executada, o retorno de chamada da habilidade é executado (consulta de pedidos, produtos, etc.) e o resultado retorna da mesma maneira.

O proxy local (@automattic/mcp-wordpress-remote) é uma pequena ferramenta Node.js que instalamos uma vez durante a configuração e depois esquecemos. Seu trabalho é traduzir entre a forma como os clientes de IA se comunicam (stdio) e a forma como o WordPress funciona (HTTP).

O MCP chegou como versão beta no WooCommerce 10.3 com habilidades de produtos e pedidos. A atualização desde então foi a migração do Adaptador MCP v0.3.0 em 10.4, que atualizou a camada de transporte. Desde então, a superfície do MCP tem permanecido estável em 10.5, 10.6, 10.6.1 e 10.7, e é nisso que estamos construindo.

MCP ainda está em visualização do desenvolvedorportanto, as habilidades integradas são limitadas ao CRUD do produto e do pedido (criar, ler, atualizar, excluir). Mas a base é sólida e é aí que entram as Habilidades Personalizadas.

Pronto para uso, o WooCommerce vem com nove habilidades MCP:

Produtos: woocommerce/products-list, products-get, products-create, products-update, products-delete

Pedidos: woocommerce/orders-list, orders-get, orders-create, orders-update

Isso já é poderoso o suficiente para criar fluxos de trabalho muito interessantes. Mas onde fica realmente interessante é Habilidades personalizadase é nisso que nos aprofundaremos na segunda parte desta série.

Pré-requisitos

Um site de teste (WooCommerce MCP está na visualização do desenvolvedor)
WooCommerce 10.7 (ou 10.3+)
WordPress 6.9+ (para a API principal do Abilities)
Node.js 22+ (exigido pelo mais recente mcp-wordpress-remote)
Chave API REST com permissões read_write
Um cliente MCP (usarei Claude Code). Nota: Claude Code requer um plano Claude Pro ou Max (US$ 20/mês +) ou créditos API Antrópicos. Não está disponível no nível gratuito.

Habilitando o MCP

Opção 1: Vá para Painel WordPress → WooCommerce → Configurações → Avançado → Características e habilitar WooCommerce MCP.

Opção 2: Habilitar via WP-CLI

wp option update woocommerce_feature_mcp_integration_enabled yes

Configurando a conexão

Crie uma chave de API

Vá para Painel WordPress → WooCommerce → Configurações → Avançado → API REST.
Clique em “Adicionar chave.”
Defina as permissões para “Ler/Escrever.”
Salve a chave e o segredo do consumidor.

Configurar o código Claude

Abra o Terminal e execute:

claude mcp add woocommerce_mcp 

  --env WP_API_URL=https://yourstore.com/wp-json/woocommerce/mcp 

  --env CUSTOM_HEADERS='{"X-MCP-API-Key": "YOUR_CONSUMER_KEY:YOUR_CONSUMER_SECRET"}' 

  -- npx -y @automattic/mcp-wordpress-remote@latest

Importante:

Substituir yourstore.com com o URL real do site de teste.
Substitua o YOUR_CONSUMER_KEY:YOUR_CONSUMER_SECRET parte com as credenciais reais da API.
Reinicie o Claude Code para carregar a nova configuração.

Para desenvolvimento local com HTTP: Para testar localmente sem HTTPS, adicione este filtro:

add_filter( 'woocommerce_mcp_allow_insecure_transport', '__return_true' );

Vamos explorar as habilidades padrão que acompanham o WooCommerce. Eles funcionam imediatamente com zero código personalizado.

Liste todos os produtos

Pergunte ao cliente de IA: “Liste todos os produtos da loja.”

O que acontece nos bastidores:

MCP chama a habilidade: woocommerce/products-list
Retorna dados do produto com nomes, preços, status do estoque, etc.

Crie um produto

Experimente isto: “Crie um produto chamado ‘Demo Hoodie’ com preço de US$ 29,99.”

Chamadas MCP:

Habilidade: woocommerce/products-create
Resultado: Um novo produto aparece na loja!

Atualizar um produto

Dizer: “Atualize o preço do Demo Hoodie para $ 39,99.”

Chamadas MCP:

Habilidade: woocommerce/products-update
O preço muda instantaneamente!

Crie um pedido

Tentar: “Crie um pedido para o produto ID 56 com quantidade 2.”

Chamadas MCP:

Habilidade: woocommerce/orders-create
Uma nova ordem é criada!

Muito incrível, certo? Essas habilidades integradas fazem com que o gerenciamento de lojas assistido por IA pareça natural. E isso é apenas o começo!

Na segunda parte, iremos além dos recursos integrados e criaremos habilidades personalizadas do zero – incluindo um painel de análise de vendas de hoje, um alerta de estoque baixo e uma ferramenta de pesquisa de clientes. Vejo você lá!

Kamlesh é engenheiro de felicidade na WooCommerce. Ele adora ajudar os clientes a aproveitar ao máximo o WordPress e o WooCommerce — quanto mais ele vê o que é possível para eles, mais animado ele fica. Fora de Woo, você o encontrará explorando novas tecnologias ou gadgets, viajando sem planos fixos ou assistindo críquete com uma intensidade irracional.