Como o Napster Agent se conecta à sua loja Shopify

📢 Mudança de nome: O Napster Agent era anteriormente conhecido como Napster Spaces. Esta mudança entrou em vigor em agosto de 2026.

Guia de Integração · Atualizado em 18 de fevereiro de 2026 · 5 min de leitura

Visão geral

O Napster Agents se integra ao Servidor MCP de Storefront (Model Context Protocol) do Shopify para oferecer aos seus clientes uma experiência de compra com tecnologia de IA. Por meio dessa conexão, um assistente de IA pode pesquisar seu catálogo de produtos, gerenciar carrinhos de compra e guiar os compradores até o checkout — tudo dentro de uma conversa natural.

Observação: nenhuma configuração é necessária. O Napster Agents se conecta automaticamente aos dados já existentes da sua loja por meio do endpoint MCP integrado do Shopify. Não é preciso instalar nenhum aplicativo, escrever código ou fazer qualquer configuração no seu painel administrativo do Shopify.

Como funciona

Quando um cliente usa o Napster Agents para fazer compras na sua loja, veja o que acontece:

1. O cliente faz uma pergunta. Um comprador que está navegando pela sua loja pergunta sobre produtos por meio do assistente de IA do Napster Agents — como conversar com um vendedor experiente.

2. A IA pesquisa seu catálogo. O assistente consulta o servidor MCP de Storefront da sua loja para encontrar produtos correspondentes, com preços, imagens, descrições e links diretos.

3. O carrinho é gerenciado. O assistente pode criar um carrinho, adicionar itens, atualizar quantidades, remover produtos e compartilhar um link de checkout — tudo dentro da conversa.

4. O cliente conclui a compra. O comprador é direcionado ao checkout nativo do Shopify da sua loja para finalizar a compra usando os métodos de pagamento e as opções de envio já configurados.

Tudo passa pela infraestrutura segura do Shopify. Os dados de produtos, preços e estoque são exibidos em tempo real — sem sincronização ou duplicação de dados.

Pesquisa no catálogo de produtos

A ferramentasearch_shop_catalogpermite que o assistente de IA pesquise todo o seu catálogo de produtos em nome do cliente. Ela aceita consultas em linguagem natural, para que os compradores possam descrever o que desejam da mesma forma que perguntariam a uma pessoa real.

O que os clientes podem fazer

  • Buscar produtos por nome, categoria ou descrição
  • Pedir recomendações com base em preferências ou casos de uso
  • Ver resultados que incluem nomes de produtos, preços, imagens e links diretos para a sua loja

O que é retornado ao cliente

Campo Descrição
Nome do produto O título do produto correspondente
Preço e moeda O preço atual na moeda da sua loja
ID da variante A variante específica (usada internamente para operações de carrinho)
URL do produto Link direto para a página do produto na sua loja
URL da imagem Imagem em destaque do produto
Descrição do produto A descrição do produto cadastrada no seu painel administrativo do Shopify

Exemplo de interação

Cliente: "Estou procurando grãos de café orgânicos, de preferência do tipo comércio justo."

Napster Agent AI: "Encontrei 3 opções na loja! Aqui estão as principais:

  • Mistura Orgânica de Comércio Justo — US$ 18,99
  • Origem Única Etíope — US$ 22,50
  • Torrado Orgânico Descafeinado — US$ 16,99

Gostaria de adicionar algum desses ao seu carrinho?"

Gerenciamento do carrinho de compras

O Napster Agents oferece funcionalidade completa de carrinho por meio de duas ferramentas:get_carteupdate_cart.

Recuperando o carrinho

get_cartrecupera o conteúdo atual do carrinho de um cliente, incluindo todos os itens, quantidades, preços e uma URL direta de checkout. O assistente de IA pode mostrar ao cliente o carrinho em qualquer momento da conversa.

Importante: o carrinho existe no Napster Agents e não é compartilhado com o Shopify.

Atualizando o carrinho

update_cartprocessa todas as modificações do carrinho:

  • Criar um novo carrinho— quando um cliente adiciona o primeiro item, um carrinho é criado automaticamente.
  • Adicionar itens— os produtos encontrados na pesquisa do catálogo são adicionados usando o ID da variante.
  • Atualizar quantidades— os clientes podem alterar a quantidade de qualquer item no carrinho.
  • Remover itens— definir a quantidade como 0 remove o produto por completo.

Checkout

Quando o cliente estiver pronto para comprar, o assistente fornece um link direto para o checkout do Shopify da sua loja. O pagamento é processado pelo seu fluxo de checkout padrão, incluindo quaisquer personalizações, métodos de pagamento e opções de envio que você tenha configurado.

Exemplo de interação

Cliente: "Adicione 2 pacotes da mistura orgânica de comércio justo ao meu carrinho."

Napster Agent AI: "Feito! Adicionei 2× Mistura Orgânica de Comércio Justo (US$ 18,99 cada) ao seu carrinho. Total do carrinho: US$ 37,98. Pronto para finalizar a compra ou prefere continuar navegando?"

Cliente: "Na verdade, coloca três pacotes."

Napster Agent AI: "Atualizado! Seu carrinho agora tem 3× Mistura Orgânica de Comércio Justo. Novo total: US$ 56,97. Aqui está o seu link de checkout, para quando estiver pronto →"

Endpoint MCP da sua loja

Cada loja Shopify tem um endpoint MCP dedicado, ao qual o Napster Agents se conecta automaticamente. Nenhuma configuração é necessária.

Formato do endpoint

https://{your-store}.myshopify.com/api/mcp

Substitua{your-store}pelo domínio da sua loja no Shopify. Por exemplo, se a sua loja écool-beans-coffee.myshopify.com, o endpoint será:

https://cool-beans-coffee.myshopify.com/api/mcp

Principais detalhes

  • Não é necessária autenticação— o endpoint é acessível publicamente, assim como a sua loja. Ele expõe apenas dados que já estão visíveis na sua loja on-line.
  • Dados em tempo real— as alterações feitas no seu painel administrativo do Shopify são refletidas imediatamente.
  • Seguro por design— acesso somente leitura ao catálogo e operações padrão de carrinho. Sem acesso ao painel administrativo, sem dados de conta de clientes, sem histórico de pedidos.

Referência de funcionalidades

A tabela abaixo resume todas as ferramentas do MCP de Storefront e o status de cada uma na integração com o Napster Agents:

Ferramenta O que ela faz Status
search_shop_catalog Pesquisa o catálogo de produtos usando consultas em linguagem natural e retorna produtos correspondentes com detalhes completos. Ativo
get_cart Recupera o conteúdo atual do carrinho, incluindo itens, quantidades e URL de checkout. Ativo
update_cart Cria carrinhos, adiciona itens, atualiza quantidades e remove itens. Ativo
search_shop_policies_and_faqs Responde a perguntas sobre políticas da loja, FAQs e informações gerais da loja. Não utilizado

Observação: a pesquisa de políticas e FAQ não está ativa. Asearch_shop_policies_and_faqsferramenta está disponível no servidor MCP de Storefront do Shopify, mas atualmente não é usada pelo Napster Agents. Esse recurso pode ser adicionado em uma atualização futura.

Perguntas frequentes

Preciso instalar alguma coisa? Não. O endpoint MCP de Storefront já vem incorporado a todas as lojas Shopify. O Napster Agents se conecta a ele automaticamente — sem aplicativos, sem código e sem configuração no painel administrativo.

Isso vai afetar minha loja on-line já existente? De forma alguma. O endpoint MCP opera em paralelo à sua loja. Ele lê os mesmos dados de produtos publicamente visíveis e não modifica configurações da loja, temas ou dados de clientes.

Quais dados de produtos são compartilhados? Apenas dados já publicamente visíveis na sua loja: nomes de produtos, descrições, preços, imagens, informações de variantes e URLs. Nenhum dado privado ou restrito ao administrador é exposto.

O assistente de IA pode processar pagamentos? Não. O assistente ajuda os clientes a montar o carrinho e depois os direciona para o checkout padrão do Shopify. Todo o processamento de pagamento ocorre pelo fluxo de checkout já existente.

Com que rapidez as alterações de produtos são refletidas? As alterações são refletidas em tempo real. Quando você atualiza o preço, o título, a descrição ou a disponibilidade de um produto no seu painel administrativo do Shopify, essas mudanças ficam disponíveis imediatamente por meio do endpoint MCP.

Isso é seguro? Sim. O endpoint oferece acesso somente leitura ao catálogo e operações padrão de carrinho. Ele não consegue acessar seu painel administrativo, contas de clientes, histórico de pedidos ou qualquer dado privado.

Obter ajuda

Se você tiver dúvidas sobre a integração com o Napster Agents ou precisar de assistência:

Artigos relacionados