Servidor MCP: deixe os clientes pesquisarem na sua loja pelo Claude e pelo ChatGPT

Cada vez mais pessoas começam a comprar dentro de uma janela de chat. Elas pedem ao Claude ou ao ChatGPT "botas de trilha impermeáveis tamanho 43 por menos de 120 euros" e esperam que o assistente volte com produtos que possam comprar. O assistente só consegue recomendar o que consegue ler. Uma loja que é apenas um site é rastreada de vez em quando. Uma loja com servidor MCP próprio é pesquisada ao vivo, com seus filtros, preços e estoque reais, toda vez que alguém pergunta.

Desde a versão 3.4.7, o HUSKY adiciona um servidor MCP à sua loja WooCommerce. MCP (Model Context Protocol) é o padrão para conectar assistentes de IA a dados externos. Com o servidor ativado, um assistente conectado à sua loja filtra o catálogo exatamente como o formulário de filtros do HUSKY e responde com seus produtos, preços e links. Depois o cliente abre a página do produto e compra no seu site, como de costume.

Teste agora na nossa loja de demonstração: adicione https://demo.products-filter.com/hello-mcp como conector no Claude ou no ChatGPT e peça algo, por exemplo "roupas vermelhas por menos de 30 dólares".

O que você ganha com isso

• Um assistente de compras para seus clientes, sem custo para você e para eles. Você não paga por nenhum serviço de IA. O cliente usa o assistente que já tem, adiciona um endereço e conversa com o seu catálogo com as próprias palavras e no próprio idioma.
• Catálogos grandes ficam fáceis de pesquisar. Em uma loja com milhares de produtos e dezenas de atributos, as pessoas desistem de formulários de filtro longos. O assistente lê todos os seus filtros, combina e refina o resultado passo a passo: "só o que tem em estoque", "os mais baratos", "o mesmo em azul".
• Respostas confiáveis. O assistente não adivinha a partir de uma cópia antiga do seu site. Cada busca passa pela mesma consulta do seu formulário de filtros, então ele vê os mesmos filtros, a mesma lógica (OR, AND, NOT IN), os mesmos valores e as mesmas contagens que um visitante vê.
• Tráfego para as páginas dos seus produtos. Todo resultado leva à página do produto. Se a busca reduziu um produto variável a uma única variação, o link a abre com essa variação já selecionada, por exemplo ?attribute_pa_color=red&attribute_pa_size=42.
• Seus idiomas e moedas. Com WPML ou Polylang, o assistente pode pesquisar no idioma do cliente. Com o FOX Currency Switcher, ele pode mostrar os preços na moeda do cliente, e o link do produto também abre nessa moeda.
• Um aviso visível. Uma caixa no seu site informa aos clientes que eles podem comprar com o assistente de IA, e as ferramentas de IA encontram o seu servidor sozinhas por meio de arquivos de descoberta padrão.

É seguro para a minha loja?

O servidor foi feito para mostrar o catálogo público e nada além disso.

• Desativado por padrão. Até você ativá-lo, o servidor, seus endereços, os arquivos de descoberta, o link no head, a seção do llms.txt e a caixa do shortcode não existem no seu site.
• Somente leitura. As três ferramentas apenas leem. Nada pode ser comprado, adicionado ao carrinho, editado ou excluído pelo servidor. Nenhum link de checkout é retornado.
• Funciona como um visitante anônimo. Ele nunca retorna rascunhos, produtos privados, produtos protegidos por senha ou produtos ocultos do catálogo. Se o WooCommerce oculta os itens sem estoque, o servidor também os oculta. No modo "Em breve" do WooCommerce, as ferramentas se recusam a responder.
• Sem contas, sem chaves, sem dados pessoais. O servidor não exige login porque lê apenas o que qualquer visitante pode ver. Ele não define cookies e não guarda nada sobre quem o chama.
• Limites de requisições. Cada endereço tem um limite rigoroso, por padrão 60 requisições por minuto com picos de 20. Acima do limite, quem chama recebe HTTP 429 com o número de segundos de espera. O bloqueio é temporário e termina sozinho, sem nada para desbloquear manualmente.
• Um limite separado para plataformas de IA. Os clientes que usam o claude.ai ou o ChatGPT chegam à sua loja a partir dos servidores do próprio assistente, então muitos clientes compartilham poucos endereços. As faixas de endereços que a Anthropic e a OpenAI publicam para esse fim têm um limite próprio, mais alto, para que uma loja popular não bloqueie os próprios clientes.
• Cache. Buscas idênticas repetidas vêm de um cache curto (90 segundos por padrão), então a mesma pergunta feita cem vezes não executa cem consultas ao banco de dados. Qualquer alteração em produtos, estoque, preços, termos ou configurações de filtro limpa o cache.
• Origens de navegador. Se você não quer que clientes MCP baseados em navegador, em outros sites, usem o seu servidor, liste as origens que você permite.

Requisitos

HUSKY 3.4.7 ou mais recente, WordPress 6.0 ou mais recente, WooCommerce, PHP 7.4 a 8.5. No WordPress 6.9 e mais recente, as ferramentas também são registradas na WordPress Abilities API.

1. Ative o servidor

1. Abra as configurações do HUSKY e vá para a aba MCP Server.
2. Defina Enable MCP server como Yes.
3. Clique em Save changes. Enquanto você não salvar, o endereço não responde.

A aba agora mostra Your MCP server address com um botão Copy.

2. O endereço do seu servidor

Seu próprio endereço. Em Your own address (pretty URL), digite qualquer caminho livre, por exemplo ai-shop. O campo verifica o caminho enquanto você digita e avisa se uma página, post, categoria ou arquivo já o utiliza. Um endereço curto é mais fácil de passar aos clientes. O endereço padrão continua funcionando, e o server card, o llms.txt, o link no head e a caixa do shortcode passam a usar o curto. Funciona com qualquer estrutura de links permanentes, inclusive a simples, desde que o servidor web repasse endereços desconhecidos ao WordPress (as regras padrão do .htaccess e do nginx try_files fazem isso).

Para clientes MCP: transporte Streamable HTTP, sem autenticação, versões de protocolo 2026-07-28, 2025-11-25 e 2025-06-18 no mesmo endereço.

3. Avise seus clientes

Um servidor que ninguém conhece não ajuda ninguém. O HUSKY oferece duas formas de divulgá-lo: uma para pessoas, outra para ferramentas de IA.

Uma caixa nas suas páginas

Coloque o shortcode [woof_mcp_connect] onde quiser: em uma página, em um post ou em um widget Text ou Shortcode na barra lateral ou no rodapé. No editor de blocos, use o bloco AI assistant connection (HUSKY MCP). A caixa mostra o endereço do seu servidor com um botão Copy e três passos curtos para o Claude, o ChatGPT e outros assistentes.

O título e o texto são definidos uma vez na aba MCP Server, em Box for your shop pages, ou a cada uso:

[woof_mcp_connect title="Shop with your AI assistant" text="Add this address to Claude or ChatGPT and just say what you are looking for."]

Os textos podem ser traduzidos com o campo de tradução de rótulos de taxonomia do HUSKY, como o restante do filtro.

Um bom lugar para a caixa é a barra lateral da loja, o rodapé ou uma página curta, como "Compre com IA", ligada ao seu menu.

Arquivos de descoberta para ferramentas de IA

Agentes e diretórios de IA procuram descrições de um site legíveis por máquina. Enquanto o servidor está ativado, o HUSKY as publica para você:

• llms.txt. É um arquivo de texto simples na raiz do seu site que diz às ferramentas de IA o que o site é e onde procurar. O HUSKY adiciona a ele uma seção com o seu servidor MCP:
• se o Rank Math ou o plugin Website LLMs.txt gera o seu llms.txt, a seção é adicionada ao arquivo deles;
• se o seu site não tem llms.txt, o HUSKY serve um em /llms.txt enquanto o servidor está ativado;
• um arquivo llms.txt físico nunca é alterado. A aba mostra a seção pronta para colar nele.
• Server card em <your address>/server-card, com o nome, a descrição e os endereços do servidor.
• /.well-known/ai-catalog.json, que aponta para o server card.
• Links no head da página (<link rel="ai-catalog"> e <link rel="service-desc">) em todas as páginas.

Você pode desativar a seção do llms.txt e o link no head na aba, em Discovery.

4. Como um cliente se conecta

A aba mostra cada trecho abaixo já com o seu endereço preenchido e um botão Copy ao lado de cada um. Substitua https://your-shop.com/ai-shop pelo seu próprio endereço.

Claude (claude.ai, Claude Desktop)

1. Abra Customize → Connectors (claude.ai/customize/connectors).
2. Clique em Add custom connector e cole o endereço.
3. Deixe os campos de OAuth vazios e clique em Add.

Em um chat, ative o conector no menu de ferramentas e peça, por exemplo: "Encontre tênis vermelhos tamanho 42 por menos de 150 euros."

ChatGPT

1. Abra chatgpt.com/plugins, pressione + e escolha Add custom MCP server.
2. Informe um nome, cole o endereço em Server URL e escolha No authentication.
3. Confirme, escolha Create as a plugin, depois digite @ em um chat e selecione-o.

Quais planos e funções do workspace podem adicionar conectores personalizados é decidido pela Anthropic, pela OpenAI e pelo administrador do workspace, não pela sua loja.

Claude Code

claude mcp add --transport http my-shop https://your-shop.com/ai-shop

Cursor

.cursor/mcp.json em um projeto, ou ~/.cursor/mcp.json para todos os projetos:

{
    "mcpServers": {
        "my-shop": {
            "url": "https://your-shop.com/ai-shop"
        }
    }
}

VS Code (GitHub Copilot)

.vscode/mcp.json, ou o comando MCP: Add Server → HTTP:

{
    "servers": {
        "my-shop": {
            "type": "http",
            "url": "https://your-shop.com/ai-shop"
        }
    }
}

Qualquer outro cliente MCP

Adicione-o como servidor remoto: Streamable HTTP, sem autenticação. Para verificar o servidor a partir de um terminal:

npx @modelcontextprotocol/inspector --cli https://your-shop.com/ai-shop --transport http --method tools/list

5. O que o assistente pode fazer

Pedidos que seus clientes podem fazer:

• "Notebooks com 16 GB de RAM por menos de 800, em estoque."
• "Algo como esta jaqueta, mas impermeável e azul."
• "Os fones de ouvido mais baratos em promoção, com o link."
• "Gibt es diese Schuhe in Größe 42? Preise bitte in Euro."

Instructions for agents. Cada assistente recebe um texto curto sobre como usar as ferramentas: chamar o schema primeiro, usar apenas valores de filtro reais, fornecer links. Você pode editá-lo na aba, em Instructions for agents, por exemplo para incluir a sua política de devolução ou o tom que você deseja. Reset to default restaura o texto da sua versão do HUSKY. Enquanto você mantém o padrão, recebe as melhorias dele nas atualizações.

Nome, título e descrição exibidos aos agentes são tirados do título do seu site e podem ser alterados na aba.

6. Idiomas e moedas

• WPML e Polylang. O assistente pode informar um idioma. Resultados, contagens, nomes e links ficam então nesse idioma, e apenas produtos desse idioma são retornados. Sem um idioma informado, usa-se o idioma padrão.
• FOX Currency Switcher. Os preços ficam na sua moeda base, a menos que o assistente peça outra. A escolha de moeda de um cliente, o geo-IP e os cookies nunca afetam o servidor. Quando uma moeda é solicitada, os preços são convertidos pelo FOX exatamente como na sua vitrine, inclusive os preços fixos por moeda, e os links dos produtos levam a moeda (?currency=EUR), de modo que a página do produto abre com o mesmo preço que o assistente informou.

7. Limite de requisições e configurações de cache

• A lista padrão de plataformas de IA contém apenas faixas que os fornecedores publicam na própria documentação: Anthropic (Claude) e OpenAI (conectores do ChatGPT). Enquanto você mantém a lista padrão, ela acompanha as atualizações do HUSKY. Se você a editar, a sua lista é mantida, e Reset to default carrega a lista da sua versão do HUSKY.
• 0 desativa um limite. Rate limit: Off desativa todos.
• Os contadores ficam no cache de objetos persistente (Redis, Memcached) ou no APCu, quando disponíveis; caso contrário, no banco de dados.

8. Solução de problemas

9. Para desenvolvedores

No WordPress 6.9 e mais recente, as mesmas três operações são registradas na WordPress Abilities API (husky/get-filter-schema, husky/search-products, husky/get-product), de modo que o WordPress MCP Adapter também pode expô-las.