Guia de Integração · Atualizado em 18 de fevereiro de 2026 · 5 min de leitura
Visão geral
O Spaces 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 Spaces 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 Spaces 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 Spaces — 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."
Spaces 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 Spaces 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 Spaces 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."
Spaces 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."
Spaces 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 Spaces se conecta automaticamente. Nenhuma configuração é necessária.
Formato do endpoint
https://{your-store}.myshopify.com/api/mcpSubstitua{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 Spaces:
| 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. A
search_shop_policies_and_faqsferramenta está disponível no servidor MCP de Storefront do Shopify, mas atualmente não é usada pelo Spaces. 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 Spaces 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 Spaces ou precisar de assistência:
- Central de Ajuda do Shopify— para dúvidas gerais sobre gerenciamento e configuração da loja.
- Documentação para desenvolvedores do Shopify— para mais informações sobre o servidor MCP de Storefront, consulteshopify.dev/docs/apps/build/storefront-mcp/servidores/storefront
- Suporte do Spaces— para dúvidas específicas sobre a integração com o Spaces e a experiência de compra com IA.