A forma mais comum de isso dar errado é silenciosa. Você segue um guia, cola um bloco JSON na configuração do cliente, reinicia e funciona — a lista de ferramentas aparece, a conexão fica verde. Aí você pergunta como foram os pedidos de ontem e não recebe nada útil, sem que o motivo seja óbvio.
A razão é que a Shopify distribui dois servidores MCP diferentes, e o fácil não enxerga sua loja.
Os dois servidores
A Shopify abriu o código do seu AI Toolkit em abril de 2026, empacotando a pilha oficial de servidores MCP, skills de agente e um plugin do Claude Code em um só namespace. Dentro dele há duas coisas que as pessoas confundem com frequência.
Dev MCP roda localmente, não exige login e entrega ao assistente a documentação de desenvolvedor e os esquemas de API da Shopify. Foi feito para quem escreve apps Shopify e é realmente bom nisso. Ele não lê os pedidos de ontem nem edita um produto, porque por projeto nunca toca uma loja ativa.
Admin MCP é o que trabalha com dados reais da loja, e precisa de um token da Admin API. Esse token é toda a diferença — e todo o custo de configuração.
Se você está construindo sobre a Shopify, instale o Dev MCP e pare de ler: é gratuito, oficial, e este artigo não pretende substituí-lo. Se você opera uma loja e quer fazer perguntas sobre ela, precisa do outro.
O que a rota Admin realmente exige
Você cria um app personalizado dentro do admin da sua loja, concede os escopos de acesso da Admin API necessários e guarda o token resultante. São três decisões que costumam ser mal tomadas.
A primeira é a amplitude dos escopos. Conceda de menos e a falha chega depois, na hora da chamada, como um erro de autorização dentro de uma resposta de chat onde é difícil de ler. Conceda tudo e você criou um token capaz de reescrever seu catálogo, guardado num arquivo de configuração num notebook.
A segunda é onde o token mora. Um token em texto puro num JSON é o padrão que a maioria dos guias mostra, porque é a instrução mais curta de escrever. Não é a que você escolheria para uma credencial que pode publicar produtos.
A terceira é a rotação. Tokens sobrevivem ao motivo pelo qual foram criados. Nada na configuração lembra você disso.
Leituras e escritas não têm o mesmo risco
Perguntar quais SKUs esgotaram na semana passada é uma leitura. É barata, reversível, e se a resposta estiver errada você percebe e segue em frente.
Mudar um preço, editar uma descrição, publicar em um canal de vendas — isso roda contra uma vitrine ativa onde há clientes comprando agora. O protocolo não tem opinião sobre essa distinção. O MCP descreve uma ferramenta e seus argumentos; não carrega a noção de "esta é irreversível".
O que significa que o portão precisa morar no cliente. Se o seu cliente executa chamadas assim que o modelo as emite, a única coisa entre uma instrução mal lida e um catálogo reprecificado é o modelo estar num bom dia. Ninguém escolhe esse perfil de risco de propósito; ele é herdado de um guia de configuração.
A mesma forma, em todas as outras plataformas
eBay, Etsy e WooCommerce já têm servidores MCP da comunidade, e a história se repete quase igual: um token ou par de chaves que você mesmo gera, uma decisão de escopo, um processo local para manter rodando e um cliente em que é preciso confiar para escritas. Um vendedor em quatro plataformas que siga esse caminho termina operando quatro pequenos serviços e guardando quatro credenciais — um trabalho real que ninguém colocou no roadmap.
Onde o Orkas entra
O Orkas é um cliente MCP, então todo servidor descrito acima funciona com ele como com outros clientes. Ele também traz um conector Shopify Admin próprio, construído sobre um app de Dev Dashboard do lojista, e dois detalhes são o ponto.
Os escopos são validados na conexão, não quando uma chamada falha. O Orkas verifica cada escopo exigido — produtos, pedidos, clientes, estoque, locais, pedidos de rascunho, devoluções, descontos, publicações e os escopos de fulfillment aplicáveis — e diz qual está faltando antes de você gastar uma conversa descobrindo. As credenciais ficam cifradas no seu próprio dispositivo, não num arquivo de configuração.
E o portão de escrita fica no cliente, não no prompt. Qualquer coisa que escreve, apaga, gasta ou toca uma loja ativa passa por um pedido de permissão, com ações irreversíveis em um portão separado das rotineiras. O mesmo catálogo cobre eBay, Etsy, Walmart Marketplace, WooCommerce e Amazon Seller Central, além das plataformas chinesas, então o problema dos quatro serviços não reaparece uma vez por loja.
O que isto não cobre
Nada disso faz do Orkas um sistema de gestão de loja. Ele não guarda estoque, não roteia pedidos e não faz repricing; se é isso que você precisa, mantenha o ERP. O que ele substitui é a pilha de pequenas integrações que você montaria para fazer perguntas à sua própria loja e agir sobre as respostas — e, na parte de agir, a suposição de que um modelo num bom dia é salvaguarda suficiente.