Nesta página
Shopify MCP abrange várias interfaces com finalidades diferentes. O guia de migração Storefront MCP da Shopify mapeia antigas ferramentas de catálogo e carrinho para UCP, preservando a ferramenta de políticas/perguntas frequentes e Customer Accounts MCP. Escolha a interface pela tarefa do comprador e confira esquema e autorização. Este guia também explica onde se encaixa um fluxo de edição pós-compra voltado ao cliente.
A versão resumida da camada técnica
MCP (Model Context Protocol) é uma interface de ferramentas usada por clientes de IA. A documentação atual de comércio Shopify também descreve endpoints UCP (Universal Commerce Protocol) para descoberta de catálogo, checkout e acesso a pedidos. Um cliente deve usar o esquema, a autenticação e as permissões atuais do endpoint; nomes e recursos de endpoints não são intercambiáveis.
| Interface | Para que serve | Documentação atual |
|---|---|---|
| Catálogo específico da loja | Descoberta de produtos de um lojista | Storefront Catalog — https://{shop}.myshopify.com/api/ucp/mcp |
| Global Catalog | Descoberta de produtos em toda a Shopify | Visão geral de catálogos para agentes |
| Políticas e perguntas frequentes | Respostas sobre políticas e perguntas frequentes de um lojista | Ferramenta de políticas e perguntas frequentes — https://{shop}/api/mcp |
| Checkout MCP | Sessão de checkout e encaminhamento do comprador | Checkout MCP |
| Order MCP | Ler informações compatíveis de pedidos originados por agentes | Order MCP |
| Customer Accounts MCP | Solicitações autenticadas de pedidos e contas de clientes | Customer Accounts MCP — https://{shop}/customer/api/mcp descoberto, OAuth com código de autorização e PKCE |
| Dev MCP | Documentação de desenvolvimento e ferramentas de esquema | Shopify AI Toolkit |
A documentação Storefront Catalog lista search_catalog, lookup_catalog e get_product e exige o perfil em meta.ucp-agent.profile. Checkout e Order MCP têm regras de acesso e operações compatíveis diferentes. Para ferramentas de descoberta e seus limites, veja nosso guia de Shopify Catalog MCP.
Nossa recomendação: desenvolva com o endpoint documentado atual
Mapeie integrações antigas ferramenta por ferramenta: descoberta de produtos usa Storefront Catalog, operações de carrinho usam Cart MCP e checkout usa Checkout MCP. Mantenha consultas de políticas em /api/mcp. Teste o esquema de solicitação e as regras de acesso de cada substituição em desenvolvimento antes de mover o tráfego.
O endpoint de catálogo pode permitir descoberta de produtos, mas não comprova, por si só, que um agente pode criar um checkout, ler o pedido de um comprador ou alterá-lo. São fluxos separados. O Dev MCP do AI Toolkit é para desenvolvedores e é distinto dos endpoints de comércio voltados ao comprador.
O que um agente de IA realmente faz na sua loja
A sequência depende do agente e da interface Shopify usada. Uma solicitação de catálogo pode buscar produtos ou seus dados. Um fluxo de checkout pode exigir autenticação ou solicitação assinada e encaminhar o comprador para revisar ou concluir a compra. Order MCP documenta get_order para pedidos compatíveis originados por agentes; não é uma API geral de histórico de pedidos entre canais. Leia o escopo de cada endpoint antes de conectá-lo ao suporte ou processamento.
O acesso autenticado do cliente é uma integração separada
Customer Accounts MCP permite que um assistente trate detalhes de pedidos, status e preferências de conta do cliente conectado nessa loja. Descubra mcp_api em https://{shop}/.well-known/customer-account-api e autentique com OAuth 2.0, código de autorização e PKCE. A configuração exige domínio personalizado, autenticação de clientes e acesso adequado a dados protegidos de clientes. Após autenticar, use tools/list para inspecionar ferramentas e esquemas reais; não presuma edições arbitrárias nem acesso a contas entre lojistas.
Order MCP usa credenciais do agente para ler pedidos feitos por esse agente. O guia de webhooks de pedidos da Shopify descreve atualizações UCP do ciclo de vida e registro do lado Shopify por um gerente de parceiros. Nosso guia de operações de pedidos por agentes Shopify cobre entrega e conciliação.
O fluxo pós-compra é separado
Um endpoint de descoberta ou checkout não oferece uma operação geral de edição de pedidos. A documentação atual Order MCP descreve a leitura do estado de pedidos compatíveis originados por agentes; não os edita. Essa distinção importa quando um cliente precisa corrigir endereço, quantidade ou variante após o checkout.
Uma loja deve oferecer um caminho voltado ao cliente para alterações elegíveis conforme a política e o estado do processamento. O app de edição de pedidos pelos clientes da Revize permite alterações de endereço, quantidade, variante e cancelamento antes do processamento durante a janela configurada pelo lojista. Trocar por outro produto, adicionar produtos, aplicar descontos e reembolsar em crédito na loja são recursos Pro. O portal exige o bloco do app Revize na página de status e também está disponível pelo link Edit Order no e-mail. Veja nosso guia de edição de pedidos Shopify para o fluxo e os limites do editor nativo.
O que a Shopify documenta hoje
Estes são os recursos documentados a verificar diante das referências atuais Shopify:
- Descoberta de catálogo específica da loja pelo endpoint UCP, com ferramentas documentadas de catálogo e perfil de agente.
- Um endpoint Global Catalog separado para descoberta mais ampla de produtos.
- Checkout MCP com seus próprios requisitos de autenticação ou solicitação assinada e possível encaminhamento do comprador.
- Order MCP com a ferramenta
get_orderpara pedidos compatíveis originados por agentes. - Customer Accounts MCP para solicitações autorizadas específicas do cliente e a ferramenta de políticas/perguntas frequentes para questões públicas da loja.
- Um conjunto local de ferramentas para desenvolvedores pelo AI Toolkit e Dev MCP Shopify.
Um nome de endpoint, por si só, não estabelece acesso irrestrito à loja, histórico universal de contas de cliente ou permissão de edição. Use o escopo documentado de cada interface. Nosso guia do Shopify AI Toolkit explica separadamente as ferramentas para desenvolvedores.
O que faríamos neste trimestre
- Escolha o endpoint pela tarefa. Use a documentação atual Storefront Catalog para descoberta de produtos, Checkout MCP para checkout e Order MCP para leituras compatíveis de pedidos.
- Confira requisitos de perfil e acesso. Solicitações Storefront Catalog incluem
meta.ucp-agent.profile; confira separadamente os requisitos exatos de cada outro endpoint. - Teste em desenvolvimento. Valide esquema da solicitação, campos retornados, autenticação e encaminhamento do comprador antes de planejar um lançamento voltado ao cliente.
- Audite o pós-compra separadamente. Garanta um caminho para clientes revisarem ou solicitarem alterações elegíveis; não espere que MCP edite um pedido concluído.
- Confira novamente a documentação antes do lançamento. APIs de agentes e suporte de clientes Shopify podem mudar; use documentação primária atual em vez de exemplos copiados.
Conclusão
Defina quais dados o cliente precisa e de quem vem a autorização de acesso. Descoberta de catálogo, checkout, respostas públicas de políticas, contas de cliente e leituras de pedidos originados por agentes têm contratos distintos. Nosso guia do Universal Commerce Protocol para desenvolvedores explica a negociação de recursos por trás das interfaces UCP.
Para lojistas, mantenha atendimento e edição pós-compra como partes explícitas do projeto. O Order MCP documentado pode ler pedidos compatíveis originados por agentes; não oferece um fluxo geral de edição. Portal de edição para clientes, política do lojista e prazo de processamento continuam sendo considerações separadas.
Perguntas frequentes
Qual é o endpoint atual do Shopify MCP?
Use /api/ucp/mcp para Storefront Catalog e as ferramentas documentadas de carrinho e checkout. Consultas públicas de políticas continuam em /api/mcp; solicitações autenticadas de clientes usam o endpoint descoberto de Customer Accounts MCP. Escolha o endpoint compatível com a tarefa específica.
Qual endpoint Shopify devo usar para descoberta de produtos?
Use o endpoint documentado específico da loja para o catálogo de um lojista ou o endpoint Global Catalog separado para descoberta mais ampla. Confira a visão geral de catálogos para ferramentas e requisitos atuais de solicitação.
O que é UCP?
UCP é o protocolo aberto de comércio Shopify para interações documentadas entre agentes, lojistas e provedores de credenciais e pagamentos. Use referências específicas de endpoints, pois descoberta, checkout e operações de pedidos não compartilham um modelo universal de permissões.
Preciso de um perfil de agente?
A documentação Storefront Catalog exige o perfil em meta.ucp-agent.profile. Confira a documentação de cada outro endpoint, em vez de presumir que o mesmo requisito ou permissão vale em toda parte.
Um agente de IA pode concluir o checkout?
A Shopify documenta Checkout MCP separadamente. O fluxo atual exige autenticação ou solicitação assinada e pode encaminhar o comprador para revisar ou concluir o checkout. Consulte a referência Checkout MCP para o caminho compatível.
Shopify MCP está disponível em todos os planos?
Disponibilidade e acesso dependem do endpoint e da configuração da loja. Confira a documentação atual de planos e endpoints Shopify para a integração específica; não deduza acesso do plano por um exemplo MCP.
Como Global Catalog difere de Storefront Catalog?
Storefront Catalog se limita a um lojista. Global Catalog é um endpoint separado de descoberta para buscar produtos em toda a Shopify. Seus endpoints e contratos de ferramentas diferem.
O que Order MCP faz?
A Shopify documenta uma ferramenta get_order para ler o estado atual de pedidos compatíveis originados por agentes. Não é um endpoint geral de histórico de pedidos de todos os canais de um cliente.
Como Customer Accounts MCP difere de Order MCP?
Customer Accounts MCP usa a autorização OAuth do cliente para solicitações de contas e pedidos dessa loja. Order MCP usa acesso com escopo por agente e só pode buscar pedidos feitos por esse agente. Descubra o esquema de cada ferramenta antes de escolher uma operação de atendimento.
Shopify MCP resolve alterações de pedidos após a compra?
Não. A documentação atual Order MCP descreve leituras, não edições. Alterações voltadas ao cliente precisam de um fluxo separado e continuam sujeitas à política e ao estado de processamento da loja.
Como testar um endpoint Shopify?
Siga a referência oficial desse endpoint e teste a solicitação documentada em desenvolvimento. Confirme autenticação, dados de perfil exigidos, campos retornados e encaminhamentos de checkout antes do lançamento.
O que a Shopify informou sobre o crescimento das buscas por IA?
A Shopify informou em junho de 2026 que pedidos vindos de busca por IA cresceram 13 vezes em um ano, com conversão 49% maior e valor médio de pedido 14% maior. Esses números descrevem os relatórios Shopify de busca por IA, não o desempenho de um endpoint MCP específico. Veja o relatório Shopify.
Qual é a etapa prioritária de implementação?
Escolha uma tarefa específica, siga a documentação atual do endpoint Shopify correspondente e teste a solicitação e a experiência do cliente completas. Mantenha distintos os fluxos de catálogo, checkout, leitura de pedidos e edição pós-compra.
Leitura relacionada
Como vender no ChatGPT com Agentic Storefronts Shopify · Como permitir que clientes editem pedidos Shopify