O que é Shopify Dev MCP?
O servidor Shopify Dev MCP roda localmente com npx -y @shopify/dev-mcp@latest via stdio e não exige autenticação. A versão 1.17.0 foi publicada em 16 de outubro de 2026 sob a licença ISC. Ele faz parte do Shopify AI Toolkit, que a Shopify agora recomenda instalar como plugin no Claude Code, Codex, Cursor, VS Code e outros; o plugin se atualiza sozinho e acrescenta uma única skill de agente shopify.
O servidor permite que um agente pesquise a documentação para desenvolvedores e os schemas de API da Shopify, valide operações GraphQL, Liquid e arquivos de tema e código de extensões de UI contra esses schemas, e resolva as versões de API suportadas. Ele não lê nada da sua loja.
O trabalho com lojas fica em outro lugar. O toolkit mais amplo pode executar tarefas suportadas de gestão de loja pelo contexto de loja logado da Shopify CLI, e agentes de compras usam os servidores do Universal Commerce Protocol em cada loja (Catalog, Cart, Checkout e Order MCP em /api/ucp/mcp), que substituíram as antigas ferramentas de catálogo e carrinho do Storefront MCP.
Como instalar Shopify Dev MCP
npx -y @shopify/dev-mcp@latestShopify Dev MCP vale a pena?
As APIs da Shopify são versionadas por data, e modelos treinados com documentação antiga escrevem consultas e código de extensões que já não validam. O valor do servidor Dev MCP é que o agente pode pesquisar a documentação atual e verificar seu GraphQL, Liquid e código de extensões contra os schemas reais da Shopify antes que você rode qualquer coisa. Para trabalho com apps e temas, isso elimina uma grande parte do ciclo de depuração, sem custo.
As ferramentas de validação são configuráveis de um jeito que a documentação subestima. Por padrão, LIQUID_VALIDATION_MODE é full, o que registra validate_theme para verificar diretórios de tema inteiros; o modo partial a remove e valida blocos de código individuais pela ferramenta unificada validate. As consultas à documentação passam por search_docs_chunks. A Shopify não publica uma contagem de ferramentas, e a documentação do toolkit acrescenta que a validação não dispensa revisar e testar o resultado.
O porém é a telemetria. As builds publicadas enviam eventos de uso para shopify.dev que podem incluir entradas e resultados das ferramentas, ou seja, o código que você valida. O plugin vai além: no Claude Code, o hook dele pode anexar seu prompt mais recente na íntegra, com até 2.000 caracteres, sempre que uma skill da Shopify é ativada. Para sair, é preciso um arquivo vazio em ~/.config/shopify-ai-toolkit/opt-out, OPT_OUT_INSTRUMENTATION=true ou DO_NOT_TRACK=1, e a Shopify avisa que variáveis de ambiente não chegam a servidores MCP iniciados por interface gráfica nem ao modo exec do Codex, então o arquivo é o caminho confiável. Builds rodadas a partir do código-fonte não enviam nada.
Lojistas devem procurar em outro lugar. O servidor puro não tem nenhum acesso à loja; as tarefas de loja do toolkit passam pela Shopify CLI, e a documentação da Shopify não lista quais tarefas são suportadas. Isso deixa o servidor via npx como a opção mínima na linha da própria Shopify: menos peças móveis que o plugin e nenhum hook que captura prompts, mas também nenhuma atualização automática.
Onde ele se destaca
Um desenvolvedor freelancer criando um app público da Shopify no Cursor
Escrever consultas Admin GraphQL que validem na primeira execução
O agente pesquisa a documentação atual, rascunha a consulta e a valida contra o schema antes da execução, então nomes de campos de uma versão antiga da API são detectados localmente. Gratuito; o custo são os trechos de documentação acrescentados ao contexto do seu modelo.
Um desenvolvedor de temas em uma agência Shopify Plus de seis pessoas
Verificar o Liquid de um tema inteiro antes de entregá-lo a um cliente
No modo full padrão, validate_theme verifica o diretório do tema em uma chamada, o que pega tags e filtros quebrados que um revisor só encontraria clicando nas prévias. O código do tema é enviado na telemetria, a menos que o arquivo de exclusão exista.
Uma equipe de frontend que mantém extensões de checkout
Migrar extensões de checkout e de conta de cliente em versões de API anteriores a 2025-10 para Polaris web components
O próprio exemplo da Shopify: o agente atualiza a versão em shopify.extension.toml, move código React para Preact e troca componentes e imports, com a validação pegando imports errados. O teste local continua necessário.
O head de engenharia de uma agência Shopify com 20 desenvolvedores
Adotar ferramentas de IA nos projetos de clientes sem enviar código de clientes a um fornecedor
Instale o servidor ou o plugin, gratuitos, em todas as máquinas e distribua o arquivo de exclusão por dotfiles gerenciados, já que a telemetria vem ativada por padrão e variáveis de ambiente não chegam a todos os hosts.
Antes de decidir
- Configuração
- claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest, depois reinicie o cliente; Node.js 18 ou posterior. A Shopify documenta Claude Code, Codex, Antigravity, Cursor e VS Code, e recomenda o plugin onde o cliente o suporta.
- Integrações
- As ferramentas incluem search_docs_chunks, validate (GraphQL, extensões de UI e Liquid no modo partial) e validate_theme, além de resolução de versões de API; todas são somente leitura e nenhuma toca uma loja. A Shopify não publica uma lista completa de ferramentas.
- Dados e privacidade
- Sem credenciais e sem dados de loja. As builds publicadas enviam entradas e resultados das ferramentas, versões de API e de pacotes, um ID de conversa aleatório e nomes de cliente ou modelo para shopify.dev/mcp/usage, a menos que você saia.
- Custo em escala
- Gratuito, sem limites de taxa publicados; o único custo contínuo são os tokens que seu próprio modelo gasta lendo os trechos de documentação devolvidos.
- Limites
- Só para desenvolvedores: sem produtos, pedidos ou clientes. Tarefas de loja exigem o toolkit mais a Shopify CLI e o login dela na loja, e a Shopify não lista quais tarefas são suportadas.
O que é bom
- Valida GraphQL, Liquid, temas e extensões contra os schemas atuais
- Não exige conta, chave nem acesso à loja
- Versões frequentes; gratuito
- Builds a partir do código-fonte não enviam telemetria
O que não é
- Telemetria ativada por padrão e pode incluir o código validado
- Sem dados de loja ou pedidos; tarefas de loja exigem o plugin e a Shopify CLI
- Lista de ferramentas e tarefas de loja suportadas não documentadas por completo
- O servidor puro não se atualiza sozinho como o plugin
Ideal para
Desenvolvedores que criam apps, temas ou extensões da Shopify com um agente de programação.
Alternativas ao Shopify Dev MCP
Shopify Dev MCP: perguntas frequentes
- Shopify Dev MCP vale a pena?
- Todo agente de programação que lida com as versões de API datadas da Shopify deveria tê-lo instalado, de preferência depois de criar o arquivo de exclusão da telemetria. Damos nota 4.2 de 5.
- Quanto custa Shopify Dev MCP?
- Gratuito; não exige conta da Shopify nem autenticação.
- Quais são as desvantagens de Shopify Dev MCP?
- Telemetria ativada por padrão e pode incluir o código validado; sem dados de loja ou pedidos; tarefas de loja exigem o plugin e a Shopify CLI; lista de ferramentas e tarefas de loja suportadas não documentadas por completo; o servidor puro não se atualiza sozinho como o plugin.
- Para quem Shopify Dev MCP é indicado?
- Desenvolvedores que criam apps, temas ou extensões da Shopify com um agente de programação.
- Quanto custa Shopify Dev MCP para uma equipe ou em produção?
- Gratuito, sem limites de taxa publicados; o único custo contínuo são os tokens que seu próprio modelo gasta lendo os trechos de documentação devolvidos.
- Shopify Dev MCP é seguro para dados da empresa?
- Sem credenciais e sem dados de loja. As builds publicadas enviam entradas e resultados das ferramentas, versões de API e de pacotes, um ID de conversa aleatório e nomes de cliente ou modelo para shopify.dev/mcp/usage, a menos que você saia.
- Quais são as melhores alternativas ao Shopify Dev MCP?
- As alternativas mais próximas que analisamos são Stripe MCP, Square MCP Server e Context7.
Respostas verificadas em 22 de out. de 2026.