Conecte o Chatfuel MCP ao WooCommerce MCP
Os preços promocionais que você define no WooCommerce chegam às respostas do seu Agente de IA no WhatsApp, no Instagram e em outras conversas. Quando clientes escrevem que pagaram por transferência, o assistente passa para Processando os pedidos que você confirmar e salva como nota do pedido o que pedem para presente, tudo pelo Claude Desktop ou pelo Cursor.
O que a integração faz
As tools que o assistente usa em cada lado, com os nomes que cada servidor dá a elas.
| Tool | O que faz |
|---|---|
list_chats | Lista as conversas com clientes com canal, status e etapa do lead. |
get_chat | Mostra as últimas mensagens de uma conversa com um cliente, com canal, status e etapa do lead. |
send_chat_message | Envia ao cliente, na conversa dele, o texto que você aprovou e passa a conversa para o chat ao vivo. |
return_chat_to_ai | Devolve ao Agente de IA uma conversa que está no chat ao vivo, depois do seu sim, e o Agente de IA responde a última mensagem do cliente. |
get_knowledge_base | Mostra o que o Agente de IA usa para responder: dados da empresa, instruções, horário de atendimento, FAQ, serviços e profissionais. |
add_faq | Adiciona perguntas e respostas ao FAQ que o Agente de IA usa para responder. |
update_faq | Muda ou remove entradas do FAQ depois da sua confirmação. Uma entrada removida não pode ser recuperada. |
test_reply | Envia uma mensagem de cliente de teste para uma conversa de teste e devolve a resposta do Agente de IA. |
list_posts | Lista os posts e reels recentes da conta do Instagram e da página do Facebook conectadas ao seu bot. |
setup_comment_replies | Configura respostas com IA ou fixas aos comentários, a todos ou por palavra-chave; no Instagram e no Facebook, também uma DM e a escolha dos posts. |
| Tool | O que faz |
|---|---|
mcp-adapter-discover-abilities | Lista as habilidades que a sua loja expõe por MCP, incluindo as de produtos e pedidos do WooCommerce. |
mcp-adapter-get-ability-info | Mostra o esquema de entrada e saída de uma habilidade, para o assistente saber o que enviar. |
mcp-adapter-execute-ability | Executa uma habilidade, como woocommerce/orders-query, com o usuário do WordPress cuja senha de aplicativo você conectou. |
woocommerce/products-query | Busca produtos por ID, palavra-chave, SKU, status ou estoque e mostra preço, preço promocional, estoque e o link da página do produto. |
woocommerce/product-create | Cria um produto com nome, preços, descrições, status e estoque, inclusive um produto agrupado que reúne outros. |
woocommerce/product-update | Muda o preço normal ou promocional, as descrições, o status ou o estoque de um produto existente. |
woocommerce/product-delete | Manda um produto para a lixeira, ou apaga de vez só quando pedirem para forçar. |
woocommerce/orders-query | Busca pedidos por número, status, cliente, e-mail de cobrança ou data, com o total, a forma de pagamento e, se pedido, os itens. |
woocommerce/order-notes-query | Lista todas as notas de um pedido, da mais recente para a mais antiga. |
woocommerce/order-update-status | Muda o status de um pedido, por exemplo de Aguardando para Processando, com uma nota opcional. |
woocommerce/order-add-note | Adiciona uma nota a um pedido sem mudar o status. A nota fica privada para a equipe, a menos que seja marcada como nota para o cliente. |
O que pedir ao assistente
Preço promocional no WooCommerce → o Agente de IA informa com o link
QuandoVocê coloca o Sérum de vitamina C em promoção por uma semana, e no WhatsApp e no Instagram perguntam quanto ele custa agora e onde comprar.
- O WooCommerce MCP encontra o sérum com
woocommerce/products-querye define o preço promocional comwoocommerce/product-update. As duas rodam pormcp-adapter-execute-ability, e o resultado traz o link da página do produto. - O Chatfuel MCP lê o FAQ com
get_knowledge_base. Depois do seu sim,update_faqreescreve a resposta do sérum com o preço promocional e o link; se ainda não houver resposta,add_faqcria uma. test_replyfaz a pergunta ao Agente de IA numa conversa de teste e mostra a resposta antes que algum cliente a receba.
ResultadoQuem perguntar numa conversa recebe R$ 95 em vez de R$ 119 e um link para comprar. Um preço promocional definido assim não tem data de fim, então peça ao assistente para tirá-lo no WooCommerce e no FAQ ao mesmo tempo.
PeçaColoque o nosso Sérum de vitamina C em promoção no WooCommerce: R$ 95 em vez de R$ 119. Depois atualize a resposta dele no FAQ do Chatfuel com o preço promocional e o link do produto, e teste o que o Agente de IA responde a “quanto custa o sérum de vitamina C?”
“Paguei por transferência” na conversa → o pedido vai para Processando
QuandoUma cliente escreve no WhatsApp que pagou o pedido #1052 por transferência. O WooCommerce deixa esses pedidos como Aguardando até você ver o dinheiro no banco.
- O Chatfuel MCP lista com
list_chatsas conversas que esperam a equipe e lê cada uma comget_chat: o número do pedido e a referência da transferência que cada cliente escreveu. - O WooCommerce MCP abre cada pedido com
woocommerce/orders-query: Aguardando, Transferência bancária direta e o total. Você confere o banco, ewoocommerce/order-update-statuspassa para Processando, com uma nota, só os pedidos que você indicar. - O assistente escreve uma confirmação para cada conversa, e
send_chat_messageenvia cada uma depois do seu sim a esse texto exato.
ResultadoOs pedidos pagos vão para Processando, o sinal do WooCommerce para enviar, e cada cliente fica sabendo na conversa de onde escreveu.
PeçaEncontre as conversas em que clientes dizem que pagaram por transferência e confira cada pedido no WooCommerce. Vou dizer quais transferências caíram: passe esses pedidos para Processando com uma nota e escreva uma confirmação para cada conversa.
Produto agrupado no WooCommerce → o link por DM para cada comentário
QuandoVocê posta um reel com a sua rotina da manhã, o Creme hidratante e o Protetor solar mineral FPS 50, e quer que quem comentar receba uma página só para comprar os dois.
- O WooCommerce MCP encontra os dois produtos com
woocommerce/products-querye, comwoocommerce/product-create, cria o produto agrupado Rotina glow da manhã, que mostra os dois numa página só. O resultado traz o link. - O Chatfuel MCP encontra o reel com
list_posts, esetup_comment_repliesresponde aos comentários que dizem “ROTINA”: uma resposta pública curta e o link por DM. add_faqadiciona a rotina com os dois preços, para o Agente de IA mandar o mesmo link quando alguém perguntar numa conversa.
ResultadoQuem comenta a palavra-chave recebe um link só para comprar o creme e o protetor, e nas conversas a resposta é a mesma.
PeçaNo WooCommerce, crie um produto agrupado “Rotina glow da manhã” com o nosso Creme hidratante e o Protetor solar mineral FPS 50. Depois configure no Chatfuel as respostas do nosso último reel: quem comentar “rotina” recebe uma resposta pública curta e o link por DM. Adicione a rotina ao FAQ.
Presente pedido na conversa → uma nota privada no pedido
QuandoUm cliente pede pelo Instagram para embrulhar o pedido online para presente e incluir um cartão. A sua equipe separa os pedidos pelo WooCommerce, não pela conversa.
- O Chatfuel MCP encontra a conversa com
list_chatse lê a solicitação comget_chat: o número do pedido e o texto do cartão. - O WooCommerce MCP confirma com
woocommerce/orders-queryque o pedido #1067 ainda está em Processando e salva a solicitação comwoocommerce/order-add-notecomo nota privada, que só a equipe vê. send_chat_messageconfirma para o cliente depois do seu sim a esse texto exato, ereturn_chat_to_aipode devolver a conversa ao Agente de IA.
ResultadoO texto do cartão fica no pedido que a equipe separa, palavra por palavra, e o cliente sabe que foi anotado.
PeçaEncontre a conversa em que um cliente pede para embrulhar um pedido para presente. Confira o pedido no WooCommerce, adicione a solicitação e o texto do cartão como nota privada do pedido e escreva uma resposta curta para eu aprovar.
Como conectar
Prepare a loja
No WooCommerce 11.3 ou mais recente, instale e ative o plugin MCP Adapter. Crie um usuário do WordPress para o assistente, por exemplo com a função Gerente de loja, e uma senha de aplicativo no perfil dele.
Adicione os dois servidores
O Chatfuel entra pelo diretório do Claude ou pela URL no Cursor. A loja vai na configuração do Claude Desktop ou no mcp.json do Cursor pelo auxiliar @automattic/mcp-wordpress-remote, que precisa do Node.js.
Cite os dois na mensagem
Diga o que fazer no WooCommerce e no Chatfuel. O WooCommerce aplica uma mudança assim que o assistente a executa, então peça o plano antes; o Chatfuel pede o seu sim antes de escrever para um cliente ou mudar o seu bot.
- No Claude Desktop, adicione o Chatfuel pelo diretório de conectores e entre na sua conta do Chatfuel.
- Abra Settings › Developer › Edit Config e adicione um servidor woocommerce_store que rode npx -y @automattic/mcp-wordpress-remote@latest.
- No env dele, coloque em WP_API_URL o endereço da loja seguido de /wp-json/mcp/mcp-adapter-default-server e preencha WP_API_USERNAME e WP_API_PASSWORD. Salve e reinicie o Claude Desktop; o claude.ai no navegador não consegue adicionar esse servidor.
- Chatfuel MCP
- claude.ai/directory/chatfuel
- WooCommerce MCP, no seu computador
npx -y @automattic/mcp-wordpress-remote@latest
- O WooCommerce documenta só clientes de desktop, e o servidor entra com uma senha de aplicativo do WordPress, que o ChatGPT não tem onde receber.
- O guia do MCP Adapter do WordPress diz que o ChatGPT conecta apps por OAuth, que o WordPress não oferece, então hoje ele não chega ao endpoint da sua loja.
- O Chatfuel MCP pode ser usado sozinho no ChatGPT; para o WooCommerce, use o Claude Desktop ou o Cursor.
- Chatfuel MCP
- chatgpt.com/plugins
- WooCommerce MCP
- Indisponível no ChatGPT
- Coloque o Chatfuel no ~/.cursor/mcp.json com a URL https://mcp.chatfuel.com/panel e entre na conta quando o Cursor pedir.
- Em mcpServers, adicione woocommerce_store com o comando npx e os args -y @automattic/mcp-wordpress-remote@latest.
- Dê a ele um env com WP_API_URL (o endereço /wp-json/mcp/mcp-adapter-default-server da loja), WP_API_USERNAME e WP_API_PASSWORD, e reinicie o Cursor.
- Chatfuel MCP
https://mcp.chatfuel.com/panel- WooCommerce MCP, no seu computador
npx -y @automattic/mcp-wordpress-remote@latest
O que você precisa
- Um bot do Chatfuel com pelo menos um canal de conversa conectado: WhatsApp, Instagram, Facebook, TikTok ou o chat do site. As respostas a comentários precisam do Instagram ou de uma página do Facebook.
- Uma loja WooCommerce auto-hospedada na versão 11.3 ou mais recente (WordPress 7.0 ou mais recente), com HTTPS e links permanentes diferentes de Simples.
- O plugin MCP Adapter do WordPress.org, ativo na loja. Esse é o único passo para entrar na Developer Preview de MCP do WooCommerce; o WooCommerce não tem uma configuração própria para ativar.
- Um usuário do WordPress só com o acesso que estes casos pedem, como Gerente de loja, e uma senha de aplicativo criada no perfil dele.
- Claude Desktop ou Cursor num computador com Node.js, que roda o auxiliar @automattic/mcp-wordpress-remote.
Limites
- O WooCommerce chama o suporte a MCP de Developer Preview: habilidades e configuração podem mudar numa próxima versão. O WooCommerce pede para testar antes de usar em produção, e o guia do MCP Adapter sugere começar numa cópia de staging.
- Cada loja tem o próprio servidor, então não há endereço hospedado nem listagem em diretório. O ChatGPT e o claude.ai no navegador não conseguem se conectar.
- O WooCommerce não pede confirmação: um preço promocional ou um status de pedido novo vale assim que o assistente executa a habilidade, como uma mudança no wp-admin.
- A habilidade de pedidos do WooCommerce mostra status, total, forma de pagamento e e-mail de cobrança, não o nome nem o telefone do cliente. Uma conversa só se liga a um pedido pelo número ou pelo e-mail que o cliente escreveu.
- Nenhum dos servidores vê a sua conta bancária, e o assistente não abre a foto de um comprovante na conversa. Cada transferência é você quem confirma.
- O Agente de IA do Chatfuel não lê a sua loja. Preços e links chegam às conversas pelo FAQ quando você pede, e uma resposta ao cliente só sai até 24 horas depois da última mensagem dele no WhatsApp, ou 7 dias no Instagram e no Messenger.
- Uma resposta por palavra-chave num post desliga a resposta do Chatfuel a todos os outros comentários daquela plataforma, a menos que você peça as duas. No TikTok sai só a resposta pública, sem DM.
- As habilidades cobrem produtos e pedidos. Cupons, reembolsos, clientes e configurações de frete não estão disponíveis no WooCommerce MCP.
Perguntas frequentes
Sim. O WooCommerce registra as habilidades de produtos e pedidos no WordPress, e o plugin oficial MCP Adapter as serve em /wp-json/mcp/mcp-adapter-default-server da sua loja. O WooCommerce o classifica como Developer Preview.
Não há formulário nem lista de espera. Atualize para o WooCommerce 11.3 ou mais recente, rode wp plugin install mcp-adapter --activate ou instale o MCP Adapter em Plugins e conecte com uma senha de aplicativo. O endpoint antigo /wp-json/woocommerce/mcp e as chaves da API REST pararam de funcionar no 11.3.
Hoje não. Os dois apps web adicionam servidores com login OAuth, e o WordPress não tem um servidor OAuth próprio, segundo o guia do MCP Adapter. Use o Claude Desktop ou o Cursor com o auxiliar, ou o Claude Code com um cabeçalho Authorization.
Não. Ele vê o pedido Aguardando no WooCommerce e o que o cliente escreveu, não o seu banco. Você diz quais transferências caíram; ele passa esses pedidos para Processando e escreve as respostas, e o Chatfuel envia cada uma depois do seu sim.
Um separado, com a menor função que dê conta do trabalho, como Gerente de loja para produtos e pedidos. Tudo roda como esse usuário, e você pode revogar a senha de aplicativo dele em Usuários › Perfil quando quiser.
O servidor padrão do MCP Adapter mostra três ferramentas: descobrir habilidades, ler o esquema de uma e executá-la. As habilidades do WooCommerce, como woocommerce/orders-query, são encontradas pela primeira e executadas por mcp-adapter-execute-ability.
Mais integrações
Conecte o Chatfuel MCP
Comece o teste grátis, adicione o Chatfuel ao seu assistente e pergunte sobre WooCommerce e as suas conversas em um só lugar.