Nesta página
O Shopify AI Toolkit é um conjunto de ferramentas para desenvolvedores; o Universal Commerce Protocol (UCP) e os endpoints de comércio da Shopify são partes relacionadas, mas separadas, da plataforma. Este guia descreve o toolkit atual, os endpoints UCP na documentação para desenvolvedores da Shopify e o que essas interfaces fazem para quem opera lojas. A análise da Revize identificou que 5,2% dos pedidos são editados após o checkout (Revize, 2026); isso contextualiza operações pós-compra, não é uma afirmação sobre pedidos por IA.
O toolkit pode ajudar desenvolvedores a encontrar documentação e orientações atuais de API da Shopify em ferramentas de programação com IA compatíveis. Os lojistas devem avaliar integrações de comércio pelas próprias necessidades, pela documentação atual de endpoints Shopify e pelo comportamento de cada provedor de agentes. Este guia se concentra nessas partes verificáveis.
O que é o Shopify AI Toolkit?
O AI Toolkit da Shopify oferece um plugin, skills para agentes e um servidor Dev MCP local para ferramentas compatíveis de desenvolvimento com IA. A Shopify atualmente lista Claude Code, Codex, Antigravity CLI, Cursor, OpenClaw, Pi, VS Code e Hermes para o plugin; OpenClaw, Pi e Hermes funcionam apenas pelo plugin. Confira a documentação oficial do AI Toolkit para as etapas atuais de configuração e as ferramentas compatíveis. O Dev MCP roda localmente e não exige autenticação em uma loja Shopify para suas ferramentas de documentação e esquema.
O Dev MCP local expõe recursos de desenvolvimento pelo Model Context Protocol. Operações na loja usam um contexto separado e autenticado do Shopify CLI; instalar um servidor de documentação não autoriza acesso à loja de um lojista.
Os recursos úteis de desenvolvimento são concretos:
- Encontrar documentação atual: identifique a interface e a versão correta da API antes de gerar uma integração.
- Inspecionar esquemas GraphQL: confira nomes de campos, argumentos e tipos de retorno antes de criar uma consulta ou mutação.
- Validar código: confira GraphQL, Liquid e código de extensões gerados diante dos esquemas Shopify e teste o comportamento em execução localmente.
- Gerenciar uma loja pelo CLI: prepare uma operação com escopo definido, autentique a loja selecionada, revise consulta e variáveis e escolha quando executá-la. Mutações exigem ativação explícita.
A validação detecta erros de esquema e componentes; não comprova que uma alteração atende às regras comerciais do lojista. Revise as diferenças, as permissões solicitadas e a loja de destino antes da execução.
Interfaces MCP e UCP de comércio da Shopify
A Shopify documenta interfaces separadas de comércio para descoberta de catálogo, checkout e acesso a pedidos. Elas têm padrões de endpoints, autenticação e operações distintos; nenhuma deve ser tratada como uma interface universal de agentes.
1. Storefront Catalog por UCP
O endpoint de catálogo específico da loja Shopify é https://{shop}.myshopify.com/api/ucp/mcp, com search_catalog, lookup_catalog e get_product e um perfil de agente em meta.ucp-agent.profile. O guia de migração do Storefront MCP move ferramentas de catálogo/carrinho para UCP, mas mantém search_shop_policies_and_faqs em /api/mcp. Use a referência do Storefront Catalog para o contrato de descoberta.
Não presuma que esse endpoint abrange checkout ou alterações de pedidos. A Shopify documenta checkout e pedidos como interfaces separadas para agentes, com autenticação, permissões e operações compatíveis próprias.
2. Global Catalog
A Shopify documenta um endpoint Global Catalog em https://catalog.shopify.com/api/ucp/mcp para descoberta de catálogos em toda a Shopify. Suas ferramentas e requisitos de acesso diferem do endpoint de catálogo de uma loja específica. Consulte a visão geral de catálogos para agentes antes de desenvolver; não reutilize exemplos antigos de endpoints ou ferramentas Storefront MCP.
3. Order MCP — acesso a pedidos originados por agentes
O Order MCP da Shopify atualmente documenta uma ferramenta get_order para buscar o estado atual de pedidos originados pelo agente. Ela não dá acesso geral ao histórico completo de pedidos do cliente e não edita pedidos. A ferramenta exige o acesso relevante a pedidos e as permissões do perfil de agente. Leia a documentação de Order MCP antes de depender dele em um fluxo.
A Shopify também documenta recursos separados de checkout pelo Checkout MCP. Autenticação ou uma solicitação assinada é exigida, e o fluxo pode encaminhar o comprador para revisar ou concluir o checkout. Consulte a documentação de Checkout MCP para o contrato atual.
4. Customer Accounts MCP — solicitações autenticadas de clientes
Customer Accounts MCP continua compatível. Descubra mcp_api por https://{shop}/.well-known/customer-account-api; seu padrão de endpoint é https://{shop}/customer/api/mcp. OAuth com código de autorização e PKCE concede acesso específico do cliente a detalhes de pedidos, status e preferências de conta nessa loja. O app precisa de configuração de autenticação de clientes, domínio personalizado e acesso a dados protegidos de clientes. Use tools/list para descobrir operações compatíveis. Isso é distinto do escopo de pedidos originados por agentes do Order MCP; nenhum dos nomes implica edições arbitrárias de pedidos.
| Interface | Para que serve | Documentação atual |
|---|---|---|
| Shopify AI Toolkit / Dev MCP | Documentação de desenvolvimento e ferramentas de esquema | AI Toolkit |
| Storefront Catalog | Descoberta de produtos de um lojista | Storefront Catalog |
| Políticas e perguntas frequentes | Perguntas públicas sobre as políticas de um lojista | Ferramenta de políticas e perguntas frequentes — /api/mcp |
| Global Catalog | Descoberta de catálogos em toda a Shopify | Visão geral de catálogos para agentes |
| Checkout MCP | Sessão de checkout e encaminhamento do comprador | Checkout MCP |
| Order MCP | Ler o estado de pedidos compatíveis originados por agentes | Order MCP |
| Customer Accounts MCP | Solicitações de pedidos e contas autorizadas pelo cliente | Customer Accounts MCP — /customer/api/mcp, OAuth PKCE |
Universal Commerce Protocol (UCP): a camada sob as camadas
A Shopify descreve UCP como um protocolo aberto de comércio para interações entre agentes, lojistas, provedores de pagamento e provedores de credenciais. Sua documentação especifica fluxos de descoberta, checkout e pedidos. As implementações ainda têm endpoints, formatos de solicitação, autenticação e permissões distintos; um rótulo UCP não significa que qualquer cliente pode chamar qualquer ferramenta. Consulte a documentação de perfis de agentes e as referências específicas de endpoints antes de implementar um fluxo.
As principais áreas do protocolo incluem:
- Descoberta de catálogo — encontre produtos e busque detalhes compatíveis pelos endpoints de catálogo documentados.
- Checkout — crie ou continue o checkout pelo fluxo documentado, que pode exigir autenticação ou encaminhamento do comprador.
- Acesso a pedidos — busque informações compatíveis de pedidos conforme as regras documentadas de perfil e acesso; isso não implica que um agente possa editar ou reembolsar um pedido.
Para lojistas, confirme se o endpoint de catálogo Shopify relevante está disponível e configurado na loja. A existência de um endpoint não garante que um produto de IA específico o usará ou exibirá todos os itens. Revise nosso guia do Universal Commerce Protocol para desenvolvedores e a documentação atual do endpoint e teste com o cliente que pretende atender.
O que os lojistas podem verificar agora
1. O tráfego de busca por IA está crescendo, mas isso não comprova que MCP o causou. A Shopify informou em junho de 2026 que pedidos vindos de buscas por IA cresceram 13 vezes em um ano, com conversão 49% maior e valor médio de pedido 14% maior. São números de buscas por IA informados pela Shopify, não uma previsão para todos os lojistas nem evidência de que um endpoint MCP específico gerou os pedidos. Veja a atualização de junho de 2026 da Shopify.
2. Confira o fluxo pós-compra real. O Order MCP documentado pela Shopify pode ler informações compatíveis de pedidos originados por agentes; não edita pedidos. Os lojistas devem verificar o caminho voltado ao cliente para corrigir pedidos elegíveis, em vez de presumir que um endpoint de agentes o cobre.
3. Mantenha as informações dos produtos corretas. Títulos, opções, disponibilidade e políticas claros ajudam clientes e sistemas de comércio a interpretar um catálogo. Meça os resultados na sua loja, em vez de presumir que um formato específico garante classificação ou conversão.
Usar o AI Toolkit como desenvolvedor ou agência
Comece com uma tarefa de desenvolvimento: inspecione o esquema, gere uma consulta, valide-a e revise o resultado em uma loja de desenvolvimento.
Instale o plugin Shopify para seu cliente compatível ou siga o caminho documentado de instalação de skills ou Dev MCP. Plugins se atualizam automaticamente; skills instaladas manualmente exigem atualizações. Siga as instruções de configuração do cliente que realmente usa.
Para gerenciar a loja, autentique-se com Shopify CLI usando apenas os escopos necessários. O comando store execute executa uma operação Admin GraphQL revisada com essa autenticação armazenada. Por exemplo, isto lê os primeiros dez produtos de uma loja de desenvolvimento:
shopify store auth --store YOUR-DEV-STORE.myshopify.com --scopes read_products
shopify store execute --store YOUR-DEV-STORE.myshopify.com --query '{ products(first: 10) { nodes { id title } } }'Substitua o marcador pela sua loja de desenvolvimento. Leituras funcionam sem ativar mutações; gravações exigem --allow-mutations e os escopos correspondentes. Revise a mutação completa e as variáveis antes de ativar, verifique a loja de destino e teste o comportamento pretendido antes de uma alteração em produção.
Ativar compras por agentes na sua loja
Se planeja desenvolver com um endpoint de catálogo Shopify, siga o formato atual de solicitação Storefront Catalog, incluindo meta.ucp-agent.profile. Uma busca de produtos bem-sucedida não comprova acesso ao checkout ou a pedidos. Nosso guia de Shopify Catalog MCP explica as ferramentas de descoberta e seus limites.
Para um agente da marca, use os projetos de exemplo atuais da Shopify e a documentação específica de checkout do endpoint. Planeje uma implementação em etapas conforme seus requisitos de catálogo, autenticação, pagamento e suporte; um projeto de exemplo não é uma lista de integração em produção. Teste os detalhes de produtos visíveis ao cliente e os encaminhamentos de checkout antes do lançamento.
Onde a infraestrutura pós-compra se encaixa em um conjunto de agentes
Descoberta de produtos, checkout, acompanhamento de pedidos e edições pelos clientes precisam de interfaces compatíveis próprias. Nosso guia de endpoints Shopify MCP e UCP mapeia essas responsabilidades.
A Shopify documenta Order MCP como uma interface de leitura de pedidos compatíveis originados por agentes, com webhooks UCP de pedidos para atualizações do ciclo de vida. Ele não oferece um fluxo geral de edição. Revize oferece um portal voltado ao cliente para alterações elegíveis de endereço, variante, quantidade e cancelamento antes do processamento, sujeito à janela configurada pelo lojista. Adicionar produtos, trocar por outro produto, aplicar descontos e reembolsar em crédito na loja são recursos Pro. A edição pela equipe está em desenvolvimento. O portal exige o bloco do app Revize na página de status do pedido e também pode ser aberto pelo link Edit Order no e-mail. Veja Revize na Shopify App Store para detalhes do produto.
Perguntas frequentes
O que é o Shopify AI Toolkit em uma frase?
O AI Toolkit da Shopify é um conjunto de ferramentas para desenvolvedores, incluindo um plugin, skills para agentes e um servidor Dev MCP local. Os endpoints de agentes de comércio e UCP da Shopify são documentados separadamente.
O Shopify AI Toolkit é gratuito?
A documentação do AI Toolkit não lista um preço separado de assinatura do toolkit. Confira os termos atuais do plano Shopify, cliente de IA, app e endpoint para quaisquer cobranças ou requisitos de conta.
Minha loja precisa estar no Shopify Plus para usar MCP?
Não presuma que todo endpoint ou recurso de agentes está disponível em todos os planos. Confira a documentação atual de endpoints e planos Shopify para sua loja e a integração específica.
Qual é a diferença entre Storefront Catalog e Global Catalog?
O endpoint atual de catálogo específico da loja Shopify é documentado em /api/ucp/mcp; Global Catalog tem um endpoint separado. Suas ferramentas e requisitos de solicitação diferem. Veja a visão geral de catálogos da Shopify.
O que é o Universal Commerce Protocol?
UCP é um protocolo aberto de comércio descrito na documentação para desenvolvedores da Shopify. Leia a especificação atual e a documentação específica de endpoints antes de presumir que outra plataforma ou agente permite o mesmo fluxo.
ChatGPT, Claude e Gemini usarão todos os servidores MCP da Shopify?
Integrações de provedores mudam de forma independente. Confira a documentação atual de cada provedor e não presuma que ChatGPT, Claude ou Gemini permitem todos os endpoints UCP ou ferramentas Shopify.
Ativar compras por agentes prejudica minha taxa de conversão?
Não existe um efeito universal. Meça conversão, conclusão de checkout e contatos de suporte para o canal e a jornada específica que ativar.
Como o AI Toolkit trata a privacidade dos dados dos clientes?
Revise a documentação atual de privacidade, autenticação e tratamento de dados da Shopify e do provedor de IA para cada ferramenta usada. Os requisitos dependem do endpoint, cliente e informações solicitadas; não presuma que todas as chamadas são locais ou não contêm dados pessoais.
O agente de um concorrente pode comprar na minha loja por MCP?
O acesso do agente depende do endpoint, perfil, autenticação e controles atuais Shopify. Revise a documentação relevante e suas configurações de acesso antes de ativar um fluxo de terceiros; não presuma que a compatibilidade com o protocolo, por si só, concede acesso ao checkout.
Preciso fazer algo para minha loja aparecer nos resultados de busca de agentes?
Mantenha informações de produtos corretas e completas e confira as regras de elegibilidade e descoberta do canal desejado. A Shopify não promete que uma mudança específica de conteúdo fará um item aparecer nos resultados de um agente.
Qual é a relação entre AI Toolkit e Shopify Functions?
Shopify Functions e AI Toolkit têm finalidades diferentes. Functions implementa lógica de comércio compatível; o toolkit auxilia desenvolvedores. Confira a documentação do endpoint e de Functions para confirmar como uma integração específica interage com sua configuração. Nosso tutorial de migração para Shopify Functions cobre esse fluxo de desenvolvimento.
Como depurar o que um agente faz na minha loja?
Use os registros, diagnósticos e recursos de observabilidade documentados para o endpoint Shopify e cliente específicos. Um agente de terceiros pode expor seus próprios registros de conversa separadamente; confirme o que a integração registra e como esses dados são tratados.
Leitura relacionada
Estatísticas de edição de pedidos Shopify · Como vender no ChatGPT com Agentic Storefronts Shopify · Como permitir que clientes editem pedidos Shopify