Nesta página
A Shopify documenta duas interfaces oficiais do Catalog MCP: o Global Catalog pesquisa produtos entre lojistas da Shopify, enquanto o Storefront Catalog fica limitado à loja de um lojista. Ambos usam o recurso de catálogo UCP da Shopify e oferecem ferramentas para pesquisar, consultar e selecionar variantes. A interface documentada do Catalog MCP serve para descoberta de produtos; ela não oferece operações do Shopify Admin para editar pedidos ou o catálogo.
Em 13 de outubro de 2026, a Shopify também anunciou o Shop MCP, que adiciona carrinhos, checkout e busca de pedidos de clientes conectados por meio de outra conexão MCP. Isso amplia o comércio com agentes, mas não transforma o Catalog MCP em um editor da Admin API.
Resposta rápida: Use Catalog MCP para descobrir produtos e selecionar variantes, com Global Catalog para buscas entre lojistas e Storefront Catalog para uma loja. Checkout e consulta de pedidos de clientes conectados pertencem a interfaces separadas de comércio, incluindo Shop MCP.
O que é o MCP do catálogo da Shopify?
O Catalog MCP é uma interface oficial da Shopify para que agentes de IA descubram e consultem informações sobre produtos. O Global Catalog pesquisa entre lojistas elegíveis da Shopify; o Storefront Catalog fica limitado à loja de um lojista. Ambos implementam o recurso de catálogo UCP da Shopify e usam as mesmas três ferramentas MCP, mas o escopo e os campos das respostas variam.
O fluxo típico tem duas etapas. Primeiro, search_catalog encontra produtos por texto, imagem ou identificadores; lookup_catalog resolve IDs conhecidos de produtos ou variantes. Em seguida, get_product retorna os detalhes do produto selecionado, combinações de opções disponíveis e links de checkout. Isso permite descobrir produtos e selecionar variantes sem conceder amplo acesso à Admin API ao agente.
O pacote separado @shopify/dev-mcp oferece documentação e ferramentas para desenvolvedores da Shopify. Ele é diferente do Catalog MCP e do Shop MCP, que adiciona recursos de carrinho, checkout e pedidos de clientes conectados.
Como funciona o acesso ao catálogo da Shopify via MCP
A camada de protocolo: o que o MCP faz
O MCP define como um cliente descobre e chama ferramentas disponibilizadas por um servidor. O UCP define o recurso de comércio e o formato das solicitações e respostas do catálogo. No Catalog MCP atual da Shopify, o agente envia uma solicitação ao endpoint da Shopify e inclui o URL do seu perfil de agente UCP. As ferramentas retornadas dependem dos recursos declarados nesse perfil. A Shopify hospeda esse serviço; não é necessário criar um servidor MCP próprio para usar as ferramentas de catálogo documentadas.
A camada de API: Admin ou Storefront
A Shopify documenta dois endpoints de Catalog MCP:
- Global Catalog:
https://catalog.shopify.com/api/ucp/mcppesquisa entre lojistas da Shopify. - Storefront Catalog:
https://{storeDomain}/api/ucp/mcppesquisa em uma única loja.
Ambos exigem um perfil de agente e não requerem chave de API para solicitações padrão. As ferramentas retornam dados de descoberta do catálogo; não funcionam como proxy da Shopify Admin API. Para alterar produtos ou pedidos, é necessário outro app ou integração com as APIs e permissões adequadas da Shopify. O acesso ao catálogo tem limites de frequência; resultados de busca e imagens de produtos não podem ser armazenados em cache. A Shopify marca alguns atributos da resposta como inferidos, então eles podem estar ausentes ou variar em precisão. Consulte as diretrizes de uso atuais antes de apresentar resultados aos clientes.
| Recurso | Global Catalog MCP | Storefront Catalog MCP |
|---|---|---|
| Busca de produtos | Entre lojistas Shopify elegíveis | No catálogo de um lojista |
| Endpoint | https://catalog.shopify.com/api/ucp/mcp |
https://{storeDomain}/api/ucp/mcp |
| Autenticação padrão | Perfil de agente; sem chave de API | Perfil de agente; sem chave de API |
| Ferramentas de descoberta | search_catalog, lookup_catalog, get_product |
As mesmas três ferramentas de catálogo |
| Limite de solicitações de consulta | Até 50 IDs de produtos ou variantes | Até 10 IDs de produtos ou variantes |
| Detalhes de produtos | Opções, sinais de disponibilidade e links de checkout | Opções, sinais de disponibilidade e links de checkout limitados à loja |
| Gravações de produtos, estoque ou pedidos | Não expostas | Não expostas |
| Execução de checkout | Exige uma interface separada de checkout | Exige uma interface separada de checkout |
O que o MCP do catálogo da Shopify realmente permite fazer
As ferramentas documentadas do Catalog MCP cobrem estas tarefas:
- Busca por texto: encontrar produtos a partir de um pedido em linguagem natural.
- Busca por imagem ou similaridade: o Global Catalog aceita consultas por imagem e IDs de produtos para descobrir itens semelhantes.
- Filtrar resultados: usar filtros compatíveis, como disponibilidade, preço, destino ou origem do envio e atributos do produto.
- Consultar IDs conhecidos: recuperar dados atuais de produtos ou variantes; uma consulta ao Global Catalog resolve até 50 identificadores e o Storefront Catalog até 10.
- Ver detalhes de um produto:
get_productretorna detalhes completos, combinações de opções e sinais de disponibilidade. - Refinar a variante: enviar opções escolhidas, como cor ou tamanho, para obter a variante correspondente e seu link de checkout.
- Pesquisar globalmente ou em uma loja: escolher Global Catalog para vários lojistas ou Storefront Catalog para uma única loja.
São funções de descoberta. As ferramentas do catálogo não alteram preços, metacampos ou estoque, não editam pedidos nem executam o checkout.
O que o MCP do catálogo significa para as operações pós-compra
O Catalog MCP pode ajudar um agente a encontrar um produto ou consultar as opções listadas, mas não lê pedidos da Shopify nem realiza alterações pós-compra. Mantenha essas responsabilidades separadas: use as ferramentas documentadas de agentes da Shopify para descobrir produtos e um app de gestão de pedidos ou uma integração autorizada para alterá-los.
O app de edição de pedidos pelos clientes da Revize permite alterações por autoatendimento antes do processamento e dentro de uma janela definida pelo lojista. O lojista escolhe as ações disponíveis. Os clientes usam o bloco do app Revize ativado na página de status do pedido ou de agradecimento da Shopify, ou o link Edit Order no e-mail de confirmação. O Revize valida o estoque em tempo real em trocas de variante. A janela, sozinha, não retém o fulfillment; o lojista precisa configurar o modo de retenção e as regras apropriadas. Consulte o guia de edição de pedidos da Shopify para ver o editor nativo.
Comércio com agentes de IA e MCP do catálogo: o que já funciona e o que vem pela frente
As ferramentas atuais de agentes da Shopify têm funções distintas:
- Catalog MCP: busca, consulta, detalhes e descoberta de variantes pelo Global ou Storefront Catalog.
- Shop MCP: servidor MCP separado anunciado em 13 de outubro de 2026. Ele pode pesquisar o catálogo, criar carrinhos, iniciar checkout em lojas Shopify, concluir o Shop Pay depois da confirmação do cliente e buscar pedidos de clientes conectados. No lançamento, o status do pedido é verificado consultando
get_checkout; as notas de lançamento dizem que webhooks ainda não estão disponíveis. - Shopify dev MCP: documentação e ferramentas para desenvolvedores, não operações de catálogo ou pedidos para lojistas.
Para configurar, siga o guia atual do Catalog da Shopify ou as notas de lançamento do Shop MCP. Não presuma que uma ferramenta de um servidor esteja disponível em outro.
Lista de verificação de implementação
Se você está avaliando o Shopify Catalog MCP:
- Decida se o agente deve pesquisar entre vários lojistas ou em uma loja.
- Leia as instruções do endpoint e do perfil de agente apropriados.
- Teste busca, consulta de IDs e seleção de variantes, inclusive com opções indisponíveis ou ambíguas.
- Respeite os limites de frequência e a regra contra armazenamento em cache de resultados e imagens.
- Atribua descoberta de produtos, checkout e edição pós-compra às ferramentas que oferecem explicitamente cada função.
Perguntas frequentes
Catalog MCP é um produto específico da Shopify?
Sim. O Global Catalog MCP da Shopify pesquisa entre lojistas elegíveis, enquanto o Storefront Catalog MCP fica limitado a uma loja. O servidor @shopify/dev-mcp, voltado a desenvolvedores, é separado.
O que é, exatamente, o Model Context Protocol?
MCP é um protocolo que permite a um cliente de IA descobrir e chamar ferramentas disponibilizadas por um servidor. Na implementação de catálogo da Shopify, o UCP define o recurso de comércio e o formato das solicitações e respostas transmitidas pelo MCP.
Preciso de um desenvolvedor para configurar o MCP do catálogo da Shopify?
Você precisa de um cliente compatível com MCP e de um perfil de agente, depois configura o endpoint Catalog da Shopify adequado. A Shopify hospeda o servidor documentado, então não é necessário criar um servidor MCP próprio para essas ferramentas. Recursos avançados do agente podem exigir desenvolvimento.
Quais planos da Shopify permitem usar o MCP do catálogo?
A documentação do Catalog descreve endpoints e autenticação por perfil de agente, não uma matriz de planos. Consulte a documentação atual da Shopify e confirme a elegibilidade da sua loja para o recurso de catálogo ou agente que deseja usar.
O MCP pode alterar meu catálogo da Shopify ou apenas ler os dados?
Não. O Catalog MCP oferece ferramentas para descoberta de produtos, não para editar produtos ou pedidos. O Shop MCP é separado e adiciona carrinho, checkout e busca de pedidos de clientes conectados. Alterações pela Admin API exigem outro app ou integração autorizada.
Qual é a diferença entre o MCP do catálogo e o Shopify Flow?
O Flow executa fluxos acionados por eventos no Shopify Admin. O Catalog MCP permite que um agente chame ferramentas de descoberta de produtos sob demanda. Eles podem se complementar, mas o Catalog MCP não aciona nem executa um fluxo do Flow.
Quais permissões da Admin API o MCP do catálogo exige?
Os endpoints hospedados do Catalog MCP usam um perfil de agente e não exigem token da Admin API nem chave de API para solicitações padrão. Se outra integração usar operações da Admin API, solicite apenas as permissões necessárias.
O MCP do catálogo atende a cenários B2B da Shopify?
As ferramentas do Catalog MCP são documentadas para descoberta de produtos. Elas não expõem atribuições de empresas nem um fluxo completo de pedidos B2B. Verifique o suporte B2B atual na API ou no recurso de agente que pretende usar; não presuma que dados da Admin API exclusivos do Plus estejam disponíveis no Catalog MCP.
Quais clientes de IA funcionam com o MCP do catálogo da Shopify?
Use um cliente compatível com MCP que se conecte ao endpoint e forneça um perfil de agente. As notas do Shop MCP de 13 de outubro descrevem fluxos de login para clientes MCP como Claude e ChatGPT; o suporte e o comportamento dependem do cliente.
Consultar dados do catálogo via MCP afeta o desempenho?
A Shopify não publica na documentação citada uma garantia fixa de tempo de resposta para o Catalog MCP. A latência depende do cliente, da solicitação e das condições do serviço. Respeite os limites de frequência e não armazene resultados do catálogo em cache.
Como proteger meu servidor MCP do catálogo da Shopify?
Use o perfil de agente necessário, proteja a configuração do cliente, siga as regras de uso da Shopify e revise quais informações de produto o agente exibe. Solicitações padrão do Catalog MCP não usam token da Admin API; outras integrações podem exigir credenciais e controles de acesso próprios.
Posso usar o MCP do catálogo para recomendações de produtos em tempo real na vitrine?
O Catalog MCP foi criado para descoberta de produtos e seleção de variantes por agentes. Ele retorna dados de produtos e links de checkout; a Shopify não o documenta como uma API de storefront de baixa latência. Para uma experiência de loja personalizada, escolha a interface que atenda aos requisitos de desempenho e apresentação.
Leitura relacionada
Estatísticas de edição de pedidos Shopify · Guia de endpoints Shopify MCP e UCP · Guia do Universal Commerce Protocol para desenvolvedores · Guia do Shopify AI Toolkit · Guia de gestão de pedidos Shopify · Guia de cancelamento de pedidos Shopify pelos clientes · Como vender no ChatGPT com Agentic Storefronts Shopify · Tutorial de migração para Shopify Functions · Como permitir que clientes editem pedidos Shopify