Nesta página
Em mais de 10 milhões de pedidos da Shopify, cerca de 1 em 19 (5,2%) é editado após o checkout (Revize, 2026). Veja como o MCP do catálogo da Shopify funciona na prática: um lojista pergunta a um assistente de IA quais produtos da coleção de verão têm menos de 10 unidades no depósito de Chicago. A IA consulta o catálogo da loja, cruza os dados de estoque por local e devolve uma lista filtrada em cerca de quatro segundos. Essa precisão também importa além da reposição: em mais de 10 milhões de pedidos da Shopify, cerca de 1 em 19 (5,2%) é editado após o checkout (Revize, 2026), e cada edição precisa de dados atualizados de estoque para ser processada corretamente. Sem tabelas dinâmicas. Sem exportações do painel administrativo. Sem alguém cruzando os dados manualmente.
Isso já acontece em produção. Equipes de lojas Plus usam esse fluxo hoje.
Mas há um ponto que a maioria das explicações deixa de fora: “Catalog MCP” não é um produto separado da Shopify já disponível. É uma capacidade que você monta. Duas definições simples ajudam a entender o restante deste artigo. Uma API é a porta pela qual um software solicita dados a outro, como quando um caixa lê o código de um produto para consultar seu preço no sistema. MCP (Model Context Protocol) é uma linguagem compartilhada, lançada pela Anthropic em novembro de 2024, que permite a um assistente de IA usar essas portas sem criar uma integração específica para cada uma. “Catalog MCP” significa, simplesmente, dar à IA acesso aos dados dos produtos da sua loja por meio dessa linguagem compartilhada.
Entender o que a Shopify oferece nativamente e o que você precisa montar com suas APIs é essencial. Se você confundir as duas coisas, poderá criar fluxos baseados em premissas que falham em produção. Este guia explica como tudo funciona, o que de fato é possível em meados de 2026, como as permissões se comportam em condições reais e o que isso significa para equipes que gerenciam operações pós-compra em escala.
Resposta rápida: O MCP do catálogo da Shopify reúne as ações que um agente de IA pode realizar com os dados de produtos, estoque, coleções e preços da sua loja por meio do Model Context Protocol. Ele funciona com a Admin API ou a Storefront API da Shopify, conectadas a um servidor MCP que você configura ou desenvolve. Em meados de 2026, as operações de leitura (busca, filtragem, consulta de estoque e acesso a metacampos) têm bom suporte e estão prontas para uso em produção. As operações de escrita (atualização de preços, edição de produtos e alterações de variantes) funcionam com as permissões de API adequadas, mas exigem uma configuração cuidadosa. Não é um recurso pronto para ativar na Shopify. É uma integração que vale a pena implementar.
O que é o MCP do catálogo da Shopify?
O MCP do catálogo da Shopify reúne as operações que um agente de IA pode realizar com os dados de produtos da sua loja depois que você conecta um servidor MCP às APIs da Shopify. O protocolo por trás disso, Model Context Protocol, foi disponibilizado como código aberto pela Anthropic em novembro de 2024 e, desde então, tornou-se a interface padrão do setor entre assistentes de IA e fontes externas de dados.
A arquitetura é simples. O MCP fica entre a IA (Claude, GitHub Copilot, GPT-4o) e a API da Shopify (Admin ou Storefront). A IA envia uma solicitação em linguagem comum ao servidor MCP. O servidor a transforma em uma chamada GraphQL estruturada (GraphQL é apenas o formato preciso de consulta aceito pelos sistemas da Shopify). A Shopify devolve os dados. A IA apresenta a resposta. Em termos simples: você pergunta com suas próprias palavras, uma camada intermediária traduz a solicitação para a linguagem da loja e traz a resposta de volta. Ninguém precisa escrever código para obter essa resposta.
A Shopify oferece um servidor MCP oficial: @shopify/dev-mcp, disponível no npm desde o início de 2025. Ele é voltado a ferramentas de desenvolvimento e dá a assistentes de IA acesso à documentação, às bibliotecas de componentes e aos utilitários de desenvolvimento da Shopify. Não é isso que os lojistas procuram quando buscam informações sobre o MCP do catálogo.
Operações de catálogo, como “mostre todos os SKUs sem estoque” ou “atualize os preços de 40 variantes de uma vez”, vêm de servidores MCP criados pela comunidade ou desenvolvidos sob medida que usam a Admin API (GraphQL) ou a Storefront API da Shopify. As duas APIs são maduras e bem documentadas. A camada MCP acrescenta a interface em linguagem natural e o catálogo de ferramentas de que um agente de IA precisa para chamá-las.
O guia do Universal Commerce Protocol explica como essa padronização na camada de protocolos está mudando o que agentes de IA podem fazer em diferentes partes do comércio eletrônico.
Como funciona o acesso ao catálogo da Shopify via MCP
O acesso ao catálogo da Shopify via MCP usa uma estrutura de três camadas: um cliente de IA, um servidor MCP e uma API da Shopify. Cada camada tem uma função específica e pode ser substituída sem reescrever as outras. Essa modularidade torna o MCP útil com diferentes ferramentas de IA e configurações de loja.
A camada de protocolo: o que o MCP faz
O MCP define um esquema de “ferramentas” (funções que podem ser chamadas) e “recursos” (objetos de dados que podem ser lidos). Quando um agente de IA precisa de dados do catálogo, ele chama uma ferramenta MCP como get_products ou search_catalog. O servidor MCP registra essas ferramentas, cuida da autenticação e encaminha a chamada à API da Shopify.
A camada de API: Admin ou Storefront
Em linguagem simples: a Admin API é a entrada da equipe na sua loja. Ela oferece acesso amplo e permite alterar preços, estoque e pedidos. Já a Storefront API é a vitrine pública: só permite leitura e se limita ao que um comprador pode ver. Para trabalhar com o catálogo, quase sempre você precisa da entrada da equipe. Em termos técnicos, a Admin API da Shopify usa GraphQL, permite operações de escrita e oferece suporte a atualizações de estoque, edição de produtos, escrita em metacampos (campos de dados personalizados associados a produtos, como um guia de tamanhos ou código de fornecedor) e gerenciamento de coleções. A Storefront API é voltada ao público e, por definição, só permite leitura: atende bem a agentes de IA que auxiliam compradores, mas não basta para gerenciar as operações do catálogo.
| Recurso | Admin API via MCP | Storefront API via MCP |
|---|---|---|
| Ler todos os dados de produtos | Sim | Apenas campos públicos |
| Ler o estoque por local | Sim | Apenas o status de disponibilidade |
| Ler e escrever em metacampos | Sim | Apenas leitura de metacampos públicos |
| Atualizar preços de produtos | Sim (com as permissões necessárias) | Não |
| Gerenciar coleções | Sim | Apenas leitura |
| Acessar produtos em rascunho | Sim | Não |
| Acessar dados de pedidos | Sim | Não |
| Catálogos e preços B2B | Sim (apenas Plus) | Não |
| Operações de produtos em massa | Sim | Não |
A autenticação usa um fluxo OAuth padrão ou tokens de app privado. A maioria das implementações de servidor MCP para acesso ao catálogo da Shopify usa tokens de app privado com apenas as permissões necessárias. O token da Admin API fica na configuração de ambiente do servidor MCP, nunca no próprio cliente de IA.
O que o MCP do catálogo da Shopify realmente permite fazer
Em implementações de produção, o MCP do catálogo da Shopify permite sete categorias distintas de operações em meados de 2026. Elas não são teóricas. Equipes de lojas Plus já as utilizam.
- Buscar e filtrar produtos. Faça consultas por título, fornecedor, tipo de produto, tag, faixa de preço ou status de publicação. É a ferramenta mais implementada e funciona de forma confiável em todas as versões atuais da API.
- Consultar variantes e opções. Recupere todas as variantes de um produto, com SKUs, preços, quantidades em estoque e combinações de opções (tamanho, cor, material). É aqui que os agentes de IA mostram seu valor em escala: uma pessoa levaria 10 minutos para reunir essas informações de 200 produtos; um agente faz isso em segundos.
- Consultar produtos de coleções. Confira a quais coleções um produto pertence ou recupere todos os produtos de determinada coleção. Isso ajuda em auditorias de catálogo, promoções sazonais e gestão de canais.
- Consultar o estoque em tempo real por local. Consulte o estoque de vários depósitos por meio dos objetos
inventoryLevelda Shopify. Para equipes com vários depósitos que processam 500 ou mais pedidos por mês, consultas de estoque por local estão entre os usos mais valiosos do MCP do catálogo. - Ler e escrever em metacampos. Dados personalizados de produtos armazenados em metacampos (guias de tamanho, certificações, códigos de fornecedor e metadados de venda cruzada) podem ser lidos integralmente e, com permissões de escrita, atualizados via MCP. Isso viabiliza fluxos de enriquecimento do catálogo que antes exigiam trabalho manual no painel administrativo ou scripts personalizados.
- Atualizar produtos em massa. O suporte a operações em massa da Admin API também pode ser usado em implementações MCP. Agentes de IA podem atualizar preços, descrições ou status de publicação em catálogos grandes em um único fluxo, com as alterações registradas para revisão antes da confirmação.
- Acessar catálogos B2B (Plus). Listas de preços específicas por empresa e atribuições de catálogos B2B (subconjuntos de produtos e preços para contas de atacado) podem ser acessadas pela Admin API no Shopify Plus. Um servidor MCP pode consultar quais produtos estão no catálogo atribuído a uma empresa e conferir os preços B2B. Esse é o uso com maior potencial para equipes de lojas Plus com uma operação de atacado relevante.
O que o MCP do catálogo significa para as operações pós-compra
O alcance do MCP vai além do catálogo. Quando um agente de IA consegue ler dados de produtos e pedidos pela mesma interface, os fluxos pós-compra mudam bastante. É nesse ponto que o acesso ao catálogo passa a ajudar diretamente as equipes de operações.
Considere uma solicitação de devolução. Em um único fluxo, um agente conectado via MCP pode ler o pedido original, conferir a disponibilidade atual de um produto para troca, verificar se o preço mudou e apresentar uma solução recomendada. Sem MCP, isso exige três telas diferentes no painel administrativo e alguém cruzando as informações manualmente.
Marcas como Square Enix e Nude Project, que lidam com um alto volume de operações pós-compra, enfrentam justamente essa dificuldade: a distância entre o que os clientes pedem após o checkout e o que a equipe de operações consegue resolver sem alternar entre ferramentas. Para entender como funciona a gestão de pedidos em escala, o acesso ao catálogo via MCP elimina a necessidade de buscar dados manualmente antes mesmo de envolver uma pessoa.
O ponto específico em que o MCP do catálogo encontra a edição de pedidos pós-compra é a troca de variante. Quando um cliente quer trocar uma variante após o checkout, um agente com MCP pode confirmar que a variante escolhida está em estoque antes de oferecer a troca. Essa consulta de estoque em tempo real é o que separa uma edição sem problemas de uma que gera uma exceção no processamento do pedido (fulfillment).
Para alterar o pedido de fato (trocar itens, ajustar preços ou atualizar instruções de processamento), ferramentas como a Revize fazem as alterações na Shopify. A arquitetura é clara: leitura do catálogo via MCP e edição de pedidos por um app desenvolvido para o pós-compra. Se você está planejando como permitir que clientes façam alterações por conta própria após o checkout, o guia de cancelamento de pedidos na Shopify explica em detalhes o que é possível.
Comércio com agentes de IA e MCP do catálogo: o que já funciona e o que vem pela frente
Em meados de 2026, os recursos disponíveis do MCP do catálogo da Shopify são mais limitados do que parte da divulgação sugere, mas também mais capazes do que muitos lojistas imaginam. Veja o cenário.
O que já funciona em produção:
- Fluxos de catálogo centrados em leitura: buscar, filtrar, auditar e exportar dados para outras ferramentas
- Monitoramento de estoque e consultas de disponibilidade por local
- Leitura e escrita em metacampos para enriquecer o catálogo
- Operações de escrita pela Admin API (preços, descrições e status) com as permissões adequadas
- Integração com clientes de IA compatíveis com MCP, incluindo Claude Desktop e GitHub Copilot
O que ainda está amadurecendo:
- Hospedagem de MCP gerenciada pela própria Shopify (a maioria das implementações usa hospedagem própria ou plataformas como Railway ou Fly.io)
- Esquemas padronizados de ferramentas MCP para catálogos (hoje cada equipe define suas próprias assinaturas de ferramentas, o que dificulta a troca de cliente de IA)
- Agentes de compras com IA voltados ao consumidor que usam o MCP do catálogo para oferecer recomendações personalizadas em tempo real e em escala
- A camada de produtos com agentes de IA gerenciada pela própria Shopify, que aparece em seu planejamento, mas ainda não foi lançada como produto para lojistas
A direção é clara. A Shopify investiu bastante em ferramentas de IA ao longo de 2025 e 2026, e o MCP se tornou uma forma padrão de conectar IA e APIs. Os lojistas que entenderem essa arquitetura agora, antes da chegada de um produto pronto para usar, terão uma vantagem relevante quando ele for lançado.
Isso se conecta diretamente ao que explica o guia para vender no ChatGPT com vitrines da Shopify operadas por agentes de IA: a IA está se tornando um caminho para a compra que interage com seu catálogo em tempo real, e o MCP viabiliza essa conexão.
Perguntas frequentes
Catalog MCP é um produto específico da Shopify?
Não. “Catalog MCP” não é o nome de um produto ou recurso separado da Shopify. É uma forma abreviada de falar do uso do Model Context Protocol para conectar agentes de IA aos dados do catálogo da Shopify: produtos, variantes, coleções e estoque. Você cria essa capacidade conectando um servidor MCP à Admin API ou à Storefront API da Shopify. O servidor MCP oficial da Shopify (@shopify/dev-mcp) é voltado a ferramentas de desenvolvimento, não a operações de catálogo para lojistas. Tudo o que poderia ser chamado de “MCP do catálogo” foi criado pela comunidade ou desenvolvido sob medida.
O que é, exatamente, o Model Context Protocol?
MCP é um protocolo aberto, lançado pela Anthropic em novembro de 2024, que padroniza a comunicação de modelos de IA com ferramentas e fontes externas de dados. Pense nele como um adaptador universal: em vez de cada integração de IA exigir código próprio para se comunicar com cada API, o MCP oferece uma interface compartilhada. As APIs da Shopify podem ser conectadas a um servidor MCP para que qualquer cliente de IA compatível as chame sem precisar desenvolver uma integração específica para cada ferramenta de IA que você queira usar.
Preciso de um desenvolvedor para configurar o MCP do catálogo da Shopify?
Sim. Em meados de 2026, configurar o acesso ao catálogo da Shopify via MCP exige a participação de um desenvolvedor. Você precisa criar um app personalizado da Shopify com as permissões de API corretas, implantar ou conectar um servidor MCP e configurar as ferramentas de catálogo que deseja disponibilizar. Pacotes de código aberto no npm (pesquise shopify-mcp-server) agilizam a configuração, mas ainda exigem hospedagem e configuração de ambiente. Soluções MCP para Shopify prontas para usar, sem código, estão surgindo, mas ainda não são comuns.
Quais planos da Shopify permitem usar o MCP do catálogo?
O MCP do catálogo via Admin API está disponível em todos os planos que permitem criar apps privados, incluindo Plus, Advanced e Grow. A Admin API em si não tem restrições por plano além dos requisitos para criar apps personalizados. Ainda assim, os usos de maior valor do MCP do catálogo (preços B2B, estoque em vários locais e operações em massa em escala) fazem mais sentido para lojas Plus e Advanced que processam 500 ou mais pedidos por mês.
O MCP pode alterar meu catálogo da Shopify ou apenas ler os dados?
O MCP pode alterar seu catálogo da Shopify, mas somente se o token da API tiver permissões de escrita e o servidor MCP disponibilizar ferramentas de escrita. Essa é uma escolha feita na camada do servidor MCP, não na camada do protocolo. Muitas equipes começam apenas com leitura por segurança e adicionam a capacidade de escrita depois de validar bem os fluxos de leitura. As operações de escrita mais comuns incluem atualizar títulos e descrições de produtos, alterar preços, ajustar o estoque e escrever em metacampos. Em geral, as exclusões são deixadas de fora dos servidores MCP usados em produção de forma intencional.
Qual é a diferença entre o MCP do catálogo e o Shopify Flow?
O Shopify Flow automatiza ações a partir de eventos: “quando X acontecer, faça Y”. O MCP do catálogo dá acesso sob demanda a um agente: “aqui está uma pergunta; encontre a resposta usando os dados atuais da loja”. Eles resolvem problemas diferentes. O Flow é excelente para automações baseadas em regras (quando o estoque cair abaixo de 5, envie um e-mail ao setor de compras). O MCP é mais adequado a operações dinâmicas que exigem contexto (analise 80 produtos sinalizados e identifique quais precisam de atualização de preço com base nas regras de margem atuais). Eles se complementam. O tutorial de migração para Shopify Functions ajuda a entender como as camadas de automação se encaixam na plataforma.
Quais permissões da Admin API o MCP do catálogo exige?
As permissões mínimas para usar o MCP do catálogo apenas para leitura são read_products, read_inventory e read_product_listings. Para operações de escrita: write_products e write_inventory. Se a sua implementação também acessa pedidos, você precisa de read_orders e write_orders para editar pedidos. Conceda sempre apenas as permissões necessárias, especialmente em automações conduzidas por IA. Tokens com permissões excessivas usados por agentes de IA criam uma exposição de segurança desnecessária e difícil de auditar depois.
O MCP do catálogo atende a cenários B2B da Shopify?
Sim, mas o MCP de catálogos B2B exige Shopify Plus. Listas de preços específicas por empresa, atribuições de catálogos B2B e subconjuntos de produtos exclusivos para atacado podem ser acessados pela Admin API do plano Plus. Um servidor MCP configurado com credenciais Plus pode consultar quais produtos estão no catálogo atribuído a uma empresa, conferir preços B2B e dar suporte a agentes de IA que atendem diretamente compradores de atacado. Esse é o uso com maior potencial para equipes de lojas Plus que mantêm um canal de atacado relevante junto à loja de venda direta ao consumidor.
Quais clientes de IA funcionam com o MCP do catálogo da Shopify?
Qualquer assistente de IA que aceite o padrão MCP pode se conectar a um servidor MCP do catálogo da Shopify. Em meados de 2026, isso inclui Claude Desktop (Anthropic), GitHub Copilot no VS Code e implantações empresariais de GPT-4o configuradas para funcionar como clientes MCP. A configuração é simples: aponte o cliente de IA para o endpoint do seu servidor MCP. As ferramentas de catálogo disponibilizadas pelo servidor passam a ser funções que a IA pode chamar. Depois da implantação do servidor, não é necessário escrever código de integração personalizado no cliente de IA.
Consultar dados do catálogo via MCP afeta o desempenho?
Sim. Há uma latência adicional em comparação com chamadas diretas à API, normalmente inferior a dois segundos em consultas comuns ao catálogo. O protocolo MCP acrescenta uma comunicação de ida e volta entre o cliente de IA, o servidor MCP e a API da Shopify. Para aplicações em vitrines em tempo real, nas quais responder em menos de um segundo é essencial, chamadas diretas à Storefront API continuam sendo a melhor opção. Em fluxos operacionais nos quais a IA realiza várias etapas de análise dos dados do catálogo (auditoria, revisão de preços e enriquecimento), essa latência é pequena diante do valor gerado. Planeje o MCP do catálogo para fluxos de operações, não para o carregamento de páginas da vitrine.
Como proteger meu servidor MCP do catálogo da Shopify?
Trate seu servidor MCP como qualquer serviço que armazena credenciais da Admin API. Use tokens de app privado com apenas as permissões necessárias, altere as credenciais regularmente, registre todas as chamadas às ferramentas MCP para permitir auditorias e nunca exponha o endpoint do servidor MCP sem autenticação. O protocolo MCP não acrescenta criptografia além do HTTPS. Os controles de acesso do servidor definem a segurança. Para equipes de lojas Plus que trafegam preços B2B confidenciais ou dados de produtos em rascunho pelo MCP, esses cuidados são requisitos, não medidas opcionais.
Posso usar o MCP do catálogo para recomendações de produtos em tempo real na vitrine?
Sim, mas a Storefront API é mais adequada a esse caso específico. Ela permite apenas leitura, oferece menor latência para dados públicos e não exige credenciais da Admin API. Um servidor MCP conectado à Storefront API funciona bem para agentes de IA que respondem a perguntas como “vocês têm este produto no meu tamanho?” ou ajudam em compras por conversa. O MCP do catálogo baseado na Admin API é mais adequado a fluxos operacionais que exigem escrita, visibilidade de produtos em rascunho ou dados de preços B2B. Escolha a API conforme o uso.
Se o MCP do catálogo da Shopify está nos seus planos, veja o que fazer nesta semana:
- Audite seu acesso atual à API. Se você já tem um app privado da Shopify com credenciais da Admin API, a base está pronta. Confira quais permissões ele possui e que tipo de acesso de escrita permite.
- Comece apenas com leitura. Pesquise no npm pacotes
shopify-mcp-serverque recebem manutenção ativa. Faça as consultas de produtos e estoque funcionarem de forma confiável antes de adicionar operações de escrita. Mesmo sem alterações, o MCP do catálogo já oferece muito valor operacional. - Defina com precisão o esquema das suas ferramentas. As ferramentas disponibilizadas pelo servidor MCP devem corresponder às operações de que sua equipe realmente precisa, não a todas as chamadas possíveis à API. Essa precisão evita o aumento desnecessário do escopo e reduz a exposição de segurança.
- Teste com dados reais do catálogo antes de conectar qualquer agente de IA com permissões de escrita. Confirme que as consultas retornam o esperado, que os locais de estoque são identificados corretamente e que a leitura dos metacampos contempla sua estrutura de dados personalizada.
- Se as operações pós-compra fazem parte do seu fluxo de IA, confirme se sua implementação MCP acessa dados de pedidos além dos dados do catálogo. Muitas vezes, a leitura do catálogo e a edição de pedidos precisam funcionar juntas.
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 do pedido (fulfillment), eles podem alterar o endereço de entrega, trocar uma variante ou produto, cancelar o pedido e receber um reembolso ou crédito na loja, sem abrir um chamado de suporte. Saiba mais sobre como permitir que clientes editem os próprios pedidos na Shopify ou encontre a Revize na Shopify App Store.