Nesta página
O kit de ferramentas de IA da Shopify não é uma ferramenta única. É um conjunto de tecnologias. Esse é o ponto que mais gera confusão: lojistas perguntam se precisam “ativá-lo”, desenvolvedores procuram um endpoint único, e nenhum dos dois encontrará essa resposta. Na prática, o kit reúne três camadas de infraestrutura que a Shopify lançou nos últimos seis meses: ferramentas para desenvolver apps da Shopify com assistentes de programação por IA, servidores MCP que permitem a agentes de compra interagir com lojas Shopify e um protocolo aberto chamado UCP, que padroniza a comunicação entre agentes, lojistas, processadores de pagamento e provedores de credenciais. Essa última camada importa mais do que parece: em mais de 10 milhões de pedidos da Shopify, cerca de 1 em 19 (5,2%) é editado após o checkout (Revize, 2026). Portanto, um agente que faz transações em nome de um lojista acaba encontrando uma alteração ou um cancelamento para o qual talvez não tenha sido preparado.
Se você administra uma loja Shopify Plus com mais de dez mil pedidos por mês, isso importa porque agentes poderão interagir com sua loja, tenha você se preparado ou não. Se você usa o plano Advanced e se preocupa com a qualidade das conversões e a experiência do cliente, importa porque a próxima geração de “assistentes de compras” poderá trazer compradores qualificados ou direcioná-los para outros lugares. E, se você desenvolve apps da Shopify — para sua própria loja ou para a Shopify App Store —, a parte do kit voltada ao desenvolvimento reduziu em 40% a 60% o tempo gasto em fluxos comuns de administração nas equipes que a adotaram. Este guia percorre cada camada, explica o que ela faz e mostra a que os lojistas devem prestar atenção em 2026.
O que é o kit de ferramentas de IA da Shopify?
O kit de ferramentas de IA da Shopify é uma integração para desenvolvedores que conecta assistentes de programação por IA — Claude Code, Cursor, Gemini CLI, Codex e VS Code — diretamente à documentação da Shopify, aos esquemas de suas APIs e a um recurso local de execução de operações na loja apoiado pela CLI. Ele é distribuído como plugin (opção recomendada, com atualização automática), como um conjunto de habilidades para agentes que você pode instalar manualmente e como um servidor Dev MCP local, que roda na máquina do desenvolvedor sem autenticação.
O que ele substitui: a antiga extensão .dev Assistant para VS Code, descontinuada em 3 de março de 2025. A tecnologia por trás dele: o Model Context Protocol (MCP), o mesmo padrão aberto lançado pela Anthropic no fim de 2024 e hoje aceito pelas principais ferramentas de programação com IA.
Na prática, a parte do kit voltada ao Dev MCP permite que o desenvolvedor faça o seguinte sem sair do editor com IA:
- Pesquisar a documentação atual do Shopify.dev com resultados relevantes para a versão vigente da API, em vez de depender do que um buscador geral indexou três meses atrás.
- Inspecionar os esquemas da GraphQL Admin API para que o assistente escreva consultas com nomes e tipos de campos corretos, sem inventar campos inexistentes.
- Validar o código GraphQL e o código de componentes gerados em relação ao esquema real antes mesmo de executá-los.
- Executar operações validadas da Admin API em uma loja específica por meio de
shopify store autheshopify store execute, transformando “mostre os dez primeiros produtos” em um resultado real da loja do desenvolvedor.
Esse último recurso é o que mais muda o trabalho diário. A sequência “escrever a consulta → abrir o painel administrativo → executar → conferir os resultados → voltar ao editor → ajustar” passa a caber em uma única interação no editor.
Mas essa é apenas uma das três camadas. A confusão começa quando a explicação para por aqui.
Os três servidores MCP que todo lojista deve conhecer
Além do Dev MCP, a Shopify oferece outros três servidores MCP. São eles que mais importam para os lojistas, pois definem como agentes de compra por IA interagem com a loja virtual, o catálogo e os pedidos dos clientes.
1. Storefront MCP — um lojista, um agente
O servidor Storefront MCP é o endpoint que cada loja Shopify disponibiliza para agentes interagirem com aquela loja específica. Não exige autenticação. O padrão do endpoint é https://{shop}.myshopify.com/api/mcp, e ele aceita chamadas JSON-RPC como esta:
const mcpEndpoint = `https://your-store.myshopify.com/api/mcp`;
fetch(mcpEndpoint, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
method: 'tools/call',
id: 1,
params: {
name: 'search_shop_catalog',
arguments: {
query: 'organic coffee beans',
context: 'customer preference for fair-trade single-origin'
}
}
})
});As ferramentas disponibilizadas pelo Storefront MCP incluem search_shop_catalog (encontrar produtos por uma consulta em linguagem natural), search_shop_policies_and_faqs (responder a perguntas sobre frete, devoluções e outros assuntos), update_cart (adicionar e remover itens, além de alterar quantidades), get_order_status e get_most_recent_order_status. A última merece atenção: um agente de IA criado com o Storefront MCP pode consultar o status do pedido de um cliente recorrente, sinalizar atrasos e iniciar devoluções — tarefas de experiência do cliente que normalmente cabem a uma pessoa da equipe de atendimento.
2. Catalog MCP — um agente, todos os lojistas da Shopify
O Catalog MCP atua na outra ponta. É a camada de busca global que permite a um agente consultar, em uma única chamada, todos os lojistas elegíveis da Shopify. Ao contrário do Storefront MCP, exige autenticação: tokens JWT do Dev Dashboard, com validade de 60 minutos, emitidos por meio de credenciais de cliente. Esse é o servidor consultado por agentes como o modo de compras do ChatGPT, a camada de comércio do Perplexity e as integrações de agentes do Claude quando alguém pede “encontre tênis de corrida por menos de $120 com entrega no Canadá”. Eles consultam o Catalog MCP, não uma loja individual.
Suas duas ferramentas principais são search_global_products (busca entre lojistas com filtros de preço, frete e opções de produto) e get_global_product_details (consulta por Universal Product ID que retorna todas as combinações de opções oferecidas pelos lojistas que vendem aquele SKU). Os resultados são agrupados por Universal Product ID (UPID), para que SKUs duplicados em várias lojas não encham a resposta do agente com resultados repetidos.
3. Customer Accounts MCP — agentes que se lembram do cliente
O Customer Accounts MCP é a camada com maior potencial de mudar a experiência pós-compra. Ele dá a um agente autenticado acesso de leitura ao histórico de pedidos, aos endereços e às informações da conta de um cliente nas lojas em que ele tem cadastro. Na prática, o agente pessoal de um comprador pode responder “quando chegam meus fones de ouvido?” consultando o Customer Accounts MCP. Também pode iniciar uma devolução sem que o cliente precise digitar o número do pedido em um formulário de atendimento.
Para operações com grande volume de pedidos, isso transfere uma parcela expressiva do atendimento básico para um fluxo conduzido por agentes. Para lojistas focados na experiência do cliente, pode ser uma oportunidade ou uma ameaça, dependendo de quem controla o agente que atende o cliente: você, a Shopify ou um terceiro. A maioria das primeiras implementações é híbrida: um agente com a marca do próprio lojista consulta o Customer Accounts MCP em nome de clientes autenticados.
| Servidor | Quem o utiliza | Autenticação | Uso principal |
|---|---|---|---|
| Dev MCP | Desenvolvedores por meio de ferramentas de programação com IA | Nenhuma (local) | Pesquisar documentação, inspecionar esquemas, executar operações na loja |
| Storefront MCP | Agentes (da marca ou de terceiros) | Nenhuma | Pesquisar em uma loja, operar o carrinho, responder a perguntas sobre políticas, consultar o status de pedidos |
| Catalog MCP | Agentes (principalmente de terceiros) | JWT (Dev Dashboard) | Pesquisar e consultar produtos entre lojistas |
| Customer Accounts MCP | Agentes autenticados | OAuth pelas contas da Shopify | Histórico de pedidos, informações da conta, ações pós-compra |
Universal Commerce Protocol (UCP): a camada por trás das demais
Os quatro servidores MCP são compatíveis com o UCP. Essa sigla importa. O Universal Commerce Protocol é o padrão aberto publicado pela Shopify para definir como quatro tipos de participantes — plataformas (agentes e aplicativos), lojistas, provedores de credenciais e provedores de serviços de pagamento — se comunicam de maneira uniforme em transações comerciais na web.
O UCP não é exclusivo da Shopify. A especificação é pública, implementações por terceiros são incentivadas e o objetivo declarado é criar uma camada interoperável. Assim, um agente desenvolvido pela OpenAI pode concluir um checkout na Shopify, no BigCommerce ou em uma plataforma personalizada sem precisar de uma integração diferente para cada uma.
As três capacidades centrais definidas pelo UCP são:
- Descoberta — pesquisar entre lojistas, obter detalhes de produtos e ajudar compradores a encontrar o que procuram. A Shopify implementa isso por meio do Catalog MCP e do Storefront MCP.
- Checkout — criar sessões de checkout, coletar dados do comprador, associar uma forma de pagamento e concluir a transação. A Shopify implementa isso por meio de uma combinação das ferramentas de carrinho do Storefront MCP com o Checkout Kit, que aceita checkouts incorporados e no navegador.
- Pedidos — acompanhar transações confirmadas, eventos de processamento de pedidos (fulfillment), reembolsos e devoluções. A Shopify implementa isso por meio do Customer Accounts MCP e das Admin APIs existentes.
O efeito prático para os lojistas: se sua loja está na Shopify e o Storefront MCP está ativado — como ocorre por padrão na maioria das lojas —, agentes criados com base no UCP já podem descobri-la. Você não precisa “integrar com o ChatGPT” nem “integrar com o Claude”: a integração é com o UCP, e todos os agentes compatíveis com ele podem acessar a loja. É o mesmo princípio que o SEO estabeleceu para a busca orgânica em 1999: um padrão, muitos canais de acesso. Explicamos o UCP em detalhes em um guia próprio para quem quiser conhecer melhor a especificação.
O que muda para os lojistas nos próximos 18 meses
Há três mudanças concretas, em ordem decrescente de certeza:
1. O tráfego vindo de agentes se torna um canal de verdade, não uma novidade. Já observamos que, em lojas com alta visibilidade nas compras iniciadas pelo ChatGPT, 3% a 8% das sessões chegam por indicações de agentes. Até o quarto trimestre de 2026, a maioria dos assistentes de IA voltados ao consumidor terá integrações de comércio. O guia sobre como vender pelo ChatGPT aborda as ações específicas para otimizar esse canal.
2. O pós-compra passa do autoatendimento para o atendimento por agentes. Consultas de status de pedidos, início de devoluções, alterações de endereço, reaplicação de descontos — todo o atendimento básico que a Revize e outros apps de pós-compra fazem hoje — passa a acontecer em uma conversa com um agente. As chamadas continuam usando as mesmas APIs, mas a interface muda de formulários na web para uma conversa em linguagem natural. Lojistas que ainda não resolveram os fluxos por trás dessas ações também não estarão prontos para agentes. Os agentes expõem falhas no pós-compra; não as corrigem.
3. A qualidade dos dados de produto gera retorno acumulado. No UCP, o agente usa os detalhes do produto para decidir se vai mostrá-lo ao comprador. Título, descrição, especificações técnicas, materiais, combinações de opções, sinais de estoque: cada campo passa a ser avaliado por um modelo, além de pessoas. Na descoberta por agentes, lojistas com dados de produto completos e estruturados aparecem à frente daqueles com dados escassos, assim como acontece na busca. A diferença é que um agente não percorre uma página de conteúdo limitado como uma pessoa faria: dados insuficientes simplesmente reduzem a posição do produto.
Como usar o kit de ferramentas de IA como desenvolvedor ou agência
A configuração da parte do kit voltada ao desenvolvimento é o trecho mais simples de todo esse processo.
Se você usa o Claude Code, instale o plugin da Shopify uma vez. O servidor Dev MCP será registrado automaticamente. A partir daí, qualquer conversa com o Claude Code poderá usar a pesquisa na documentação, a inspeção de esquemas e o shopify store execute como ferramentas. Não é preciso configurar cada projeto.
Se você usa o Cursor, adicione o servidor Dev MCP ao arquivo de configuração MCP do Cursor. A configuração consiste em um bloco JSON de cinco linhas. O Cursor carrega as ferramentas na próxima reinicialização.
Se você usa o Gemini CLI, a integração é instalada como uma habilidade do repositório de habilidades da Shopify no GitHub.
As habilidades para agentes (separadas do plugin) são arquivos Markdown colocados no diretório .agent/skills/ do seu repositório. São uma boa opção para personalizar cada projeto. Por exemplo, você pode criar um arquivo que informe à IA as convenções de nomenclatura da sua loja, sua abordagem de testes e seu fluxo de implantação, para que o código gerado siga seus padrões automaticamente.
O ganho de produtividade é real, mas tem limites. Nas equipes que adotaram o kit de forma consistente, observamos maior velocidade no desenvolvimento de apps em tarefas que a IA executa bem: consultas GraphQL repetitivas, estrutura inicial de handlers de webhook, layouts de componentes Polaris e automação de fluxos da CLI. Ele não acelera de forma relevante decisões de arquitetura, depuração entre sistemas ou otimização de desempenho, porque essas tarefas exigem um contexto que o Dev MCP não fornece.
Como ativar compras por agentes na sua loja
Na maioria das lojas Shopify, o endpoint Storefront MCP já está ativo por padrão. Você pode testá-lo em 30 segundos:
curl -X POST https://YOUR-STORE.myshopify.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/list",
"id": 1
}'Se receber uma lista de ferramentas, agentes já podem interagir com sua loja. Se quiser criar um agente com a sua marca sobre esse endpoint — um widget de conversa para ajudar nas compras na loja virtual —, o template Shop Chat Agent da Shopify é o caminho mais rápido. É um repositório inicial com interface de conversa incorporada, cliente MCP, tratamento de respostas em tempo real e suporte para usar Claude, GPT ou Gemini como modelo de linguagem.
Um cronograma realista de 90 dias para um lojista lançar seu próprio agente:
- Semanas 1-2: Clone o template Shop Chat Agent, adapte as instruções e a interface à sua marca e escolha o modelo de linguagem que prefere usar.
- Semanas 3-4: Implante em um tema de teste e faça testes internos dos fluxos de carrinho, catálogo e status de pedidos.
- Semanas 5-8: Faça um lançamento gradual para um pequeno grupo de clientes e meça a taxa de resolução sem escalonamento, ou seja, a porcentagem de solicitações de atendimento resolvidas pelo agente sem intervenção humana.
- Semanas 9-13: Ajuste as instruções com base nas conversas registradas, acrescente as políticas e o conhecimento de produtos específicos da marca e disponibilize o agente para todo o tráfego.
O erro evitável mais comum que vemos é pular as semanas 3-4. Os testes internos identificam problemas que, em um lançamento para clientes, ficariam públicos: agentes recomendando com segurança produtos que você não vende, tratando preços promocionais de forma incorreta ou informando estimativas de frete erradas.
Onde a infraestrutura de pós-compra entra em um conjunto de tecnologias para agentes
Agentes lidam bem com descoberta de produtos e checkout. Já o pós-compra funciona mal quando o lojista não tem uma infraestrutura preparada para receber chamadas de agentes.
Editar pedidos, alterar endereços, fazer trocas e adicionar descontos após o checkout são tarefas que um agente precisa executar quando alguém pergunta “você pode alterar meu pedido?”. O Customer Accounts MCP dá aos agentes acesso de leitura aos pedidos. A parte de escrita — a edição propriamente dita — ainda precisa acontecer em algum lugar. Hoje, na maioria das lojas, ela depende de chamados de atendimento e edições no Shopify Admin. Essa é a lacuna que todo lojista terá de fechar à medida que agentes se tornarem a principal interface de experiência do cliente.
A Revize é a camada de edição pós-compra criada justamente para isso: alterações de endereço, trocas de variantes, itens adicionais, cancelamentos e reaplicação de descontos. Estamos trabalhando nos endpoints de edição que poderão ser acessados por agentes para que, quando eles começarem a fazer essas chamadas, os fluxos necessários já estejam disponíveis. A Revize está na Shopify App Store se você está definindo o lugar do pós-compra na sua estratégia para agentes.
Perguntas frequentes
O que é o kit de ferramentas de IA da Shopify em uma frase?
O kit de ferramentas de IA da Shopify reúne três camadas: um servidor Dev MCP para assistentes de programação por IA, quatro servidores MCP compatíveis com o UCP (Storefront, Catalog, Customer Accounts e Dev) para agentes de compra por IA e a especificação do Universal Commerce Protocol que conecta tudo isso.
O kit de ferramentas de IA da Shopify é gratuito?
Sim. O servidor Dev MCP roda localmente, sem autenticação e sem custo. Os endpoints Storefront MCP ficam disponíveis em todas as lojas sem cobrança adicional. O Catalog MCP exige uma conta gratuita no Dev Dashboard para obter as credenciais JWT. O Customer Accounts MCP usa a autenticação de clientes já existente na Shopify.
Minha loja precisa estar no Shopify Plus para usar MCP?
Não. O endpoint Storefront MCP está ativo por padrão em todas as lojas Shopify, em todos os planos. O Catalog MCP funciona para qualquer lojista cujos produtos atendam aos critérios de elegibilidade da Shopify, independentemente do plano. Apenas alguns recursos avançados de comércio com agentes, como catálogos salvos e escopos de acesso personalizados, exigem o Plus.
Qual é a diferença entre Storefront MCP e Catalog MCP?
O Storefront MCP se limita à loja de um lojista e não exige autenticação. Os agentes o usam quando o comprador já escolheu em qual loja comprar. O Catalog MCP pesquisa entre lojistas, exige autenticação JWT e é usado por agentes quando o comprador busca produtos em todas as lojas Shopify.
O que é o Universal Commerce Protocol?
O UCP é a especificação aberta da Shopify para a comunicação entre agentes de IA, lojistas, provedores de serviços de pagamento e provedores de credenciais durante uma transação comercial. Ele define descoberta, checkout e pedidos como suas três capacidades centrais e também foi projetado para ser implementado por plataformas que não são da Shopify.
ChatGPT, Claude e Gemini vão usar os servidores MCP da Shopify?
Eles já usam, por meio de seus respectivos modos de agente e de compras. Agentes criados com base no padrão MCP da Anthropic podem se conectar diretamente aos servidores MCP da Shopify. O SDK de agentes da OpenAI oferece suporte direto a MCP. A documentação para desenvolvedores da Shopify descreve uma forma de fazer a conexão com o Gemini, do Google.
Ativar compras por agentes prejudica minha taxa de conversão?
Os primeiros dados indicam que não; muitas vezes, ocorre o contrário. O tráfego vindo de agentes tende a chegar com maior intenção de compra, pois o comprador já disse ao agente o que procura. Além disso, a ferramenta update_cart do Storefront MCP entrega um carrinho preenchido, sem exigir que a pessoa navegue pela loja. Observamos quedas na conversão quando o agente recebe instruções inadequadas e recomenda produtos que a loja não vende, levando o comprador a procurar em outro lugar.
Como o kit de ferramentas de IA protege os dados dos clientes?
O Dev MCP roda localmente na máquina do desenvolvedor e, por padrão, não transmite dados da loja para fora. As chamadas do Storefront MCP ocorrem entre servidores, sem exposição inerente de informações pessoais identificáveis. O Customer Accounts MCP exige consentimento explícito do cliente por OAuth antes que um agente acesse seu histórico de pedidos ou os dados da conta. As quatro camadas estão sujeitas à licença de API e aos contratos de processamento de dados da Shopify.
O agente de um concorrente pode fazer transações na minha loja por MCP?
Sim. Isso faz parte do funcionamento previsto. Qualquer agente compatível com o UCP pode pesquisar seu catálogo e criar checkouts pelo endpoint Storefront MCP. Se quiser restringir quem pode fazer transações, os controles são os mesmos que você já usa: limites de requisições, bloqueio de IP e restrições de acesso por lojista da Shopify para o Catalog MCP. Para a maioria dos lojistas, abrir a loja virtual a mais agentes traz um resultado positivo para a receita.
Preciso fazer algo para minha loja aparecer nos resultados de busca dos agentes?
Você precisa de dados de produto completos e organizados. Os agentes mostram produtos com base na qualidade do título, na relevância da descrição, na abrangência das especificações técnicas e nos sinais de estoque. São os mesmos campos que influenciam o SEO, agora avaliados por um modelo. Lojistas com páginas de produto pouco detalhadas perdem posição na descoberta por agentes. Melhorar esses dados é a ação isolada com maior potencial de retorno para o desempenho nesse canal.
Qual é a relação entre o kit de ferramentas de IA e o Shopify Functions?
Eles atuam em camadas diferentes. O Shopify Functions executa lógica personalizada de checkout e carrinho em nome do lojista durante o checkout. O kit de ferramentas de IA permite que agentes interajam com a loja virtual externamente. Um agente que usa update_cart no Storefront MCP aciona as Functions configuradas na loja como qualquer outra atualização do carrinho. Explicamos a migração para Functions em detalhes aqui.
Como posso investigar o que um agente está fazendo na minha loja?
As solicitações ao Storefront MCP são registradas como qualquer outra chamada à Storefront API e aparecem nos registros de solicitações à API da loja no painel administrativo. Você também pode adicionar monitoramento ao seu agente com a sua marca. O template Shop Chat Agent inclui um recurso de registro de conversas que grava cada mensagem do usuário, chamada de ferramenta e resposta da ferramenta em um sistema de sua escolha. No caso de agentes de terceiros, você vê apenas as chamadas de API feitas à sua loja, não a conversa anterior entre o usuário e o agente.
Atualizado em agosto de 2026. A Revize é um app da Shopify que permite aos clientes editar os próprios pedidos após a compra. Antes do processamento de pedidos (fulfillment), eles podem alterar o endereço de entrega, trocar uma variante ou um produto, cancelar o pedido e receber um reembolso ou crédito na loja, sem abrir um chamado de atendimento. Saiba mais sobre como permitir que clientes editem os próprios pedidos na Shopify ou encontre a Revize na Shopify App Store.