Shopify com o Claude ou o ChatGPT
Três formas de conectar uma loja a um assistente de IA, o que cada uma pode ler e alterar, e a que leva quatro minutos.
Você quer que o seu assistente responda a perguntas sobre a sua loja com os dados da própria loja: quais produtos têm descrições fracas, como os pedidos da semana passada se comparam com os da semana anterior, o que o tema publicado realmente carrega. Existem três formas de montar isso, e elas diferem em três pontos: quem segura a caneta, quem guarda as chaves e quanto código acaba ficando nas suas mãos.
Este guia compara as três. O passo a passo de cada cliente está no guia dele, um por cliente, e esta página aponta para eles em vez de repeti-los.
As opções
Três portas de entrada
| Conector personalizado (MCP Shopify) | Conector da própria Shopify | O seu próprio código | |
|---|---|---|---|
| O que você faz | cola uma URL, faz login, aprova os escopos | adiciona pelo diretório de conectores do Claude | chama a Admin API e entrega os resultados ao modelo |
| Clientes | Claude, ChatGPT, Claude Code, Cursor | Claude | o que você construir |
| Lê a loja | sim, dentro da concessão do seu Custom App | sim | o que você programar |
| Grava na loja | não, recusado antes da Shopify | sim | o que você programar |
| Código para manter | nenhum | nenhum | todo |
1. Um servidor MCP remoto como conector personalizado. A loja ganha uma URL. Você cola essa URL no seu assistente, faz login e aprova o que ele pode ler. O MCP Shopify da BoostEcom funciona assim, como qualquer servidor MCP remoto.
2. O conector da própria Shopify. A Shopify publica um conector no diretório do Claude, e ele grava no admin: produtos, estoque, descontos. Se você quer que o assistente mude a loja a partir de uma conversa, essa é a ferramenta feita para isso. Os dois são comparados linha a linha em O conector oficial da Shopify para o Claude ou um relay somente leitura.
3. O seu próprio código. Um Custom App da Shopify dá a você um token da Admin API; o seu código consulta a loja e passa os resultados ao modelo por tool use (Anthropic) ou function calling (OpenAI). Controle total, e cada nova tentativa, cada limite de requisições e cada troca de modelo ficam por sua conta.
O protocolo
O que o MCP muda
O Model Context Protocol é um padrão aberto feito exatamente para isso. Quando um cliente se conecta, o servidor anuncia as ferramentas dele, com argumentos tipados; o cliente as chama pelo nome. Você não escreve nenhum loop de ferramentas nem instala SDK, e a mesma URL atende todos os clientes que falam MCP por HTTP.
É por isso que os caminhos 1 e 2 não exigem código: o assistente já é o
cliente MCP. E é por isso que o caminho 3 encolheu. As APIs dos dois
fornecedores agora conseguem chamar um servidor MCP remoto por conta
própria: a Messages API da Anthropic, pelo conector MCP dela, que recebe
a URL do servidor e um authorization_token, e a Responses API da
OpenAI, que aceita um servidor MCP remoto como ferramenta. Você mantém a
orquestração e se livra do código de cola.
Claude
Conectar o Claude
O Claude aceita um servidor MCP remoto como conector personalizado: nas configurações do Claude, abra Conectores e adicione um conector personalizado. Cole a URL da loja e deixe o client id e o secret em branco. O Claude se identifica, faz um handshake OAuth 2.1 com PKCE e abre uma tela de consentimento que mostra o cliente, a loja e cada permissão pedida. Aprove, e a lista de ferramentas do Claude se enche com as ferramentas que essas permissões abrem.
→ Conectar o Claude, passo a passo
O Claude Code faz login do mesmo jeito, a partir de um terminal:
claude mcp add declara o servidor, e depois /mcp abre o seu
navegador na mesma tela de consentimento.
→ Conectar o Claude Code
ChatGPT
Conectar o ChatGPT
O ChatGPT aceita um servidor MCP remoto quando o Modo desenvolvedor está ativado: nas configurações do ChatGPT, ative o Modo desenvolvedor e adicione um conector com a URL da loja e OAuth. O Modo desenvolvedor está disponível nos planos Plus, Pro, Business, Enterprise e Edu. O ChatGPT pede a sua confirmação antes de rodar uma ferramenta, e você pode manter essa resposta pelo resto da conversa.
→ Conectar o ChatGPT, passo a passo
O Cursor lê a mesma URL no mcp.json dele e faz login pelas
configurações de MCP. → Conectar o Cursor
A escolha
Claude ou ChatGPT?
Para esse trabalho, tanto faz para o relay: os dois recebem as mesmas ferramentas, com a mesma concessão, e nenhum dos dois roda um modelo do nosso lado. Escolha o assistente que a sua equipe já usa, com o modelo que o seu plano oferece. O que muda de verdade é o jeito de conectar:
| Claude | ChatGPT | Claude Code | Cursor | |
|---|---|---|---|---|
| Onde você adiciona | Configurações, Conectores | Modo desenvolvedor, Conectores | claude mcp add, depois /mcp | mcp.json, depois configurações de MCP |
| Login | OAuth | OAuth | OAuth | OAuth |
| Chave estática para CI | desnecessária | desnecessária | sim | sim |
| Guia | Claude | ChatGPT | Claude Code | Cursor |
Alcance
O que o MCP Shopify lê
Cada loja conectada ganha o próprio endpoint:
https://www.boostecom.app/api/mcp/v1/<STORE_ID>
Esse endpoint registra 24 ferramentas. 22 delas podem ser oferecidas a um cliente, e as outras 2 estão reservadas aos admins da BoostEcom: elas nunca aparecem na tela de consentimento de um cliente. São 15 ferramentas relay da Shopify, mais as ferramentas de leitura da própria BoostEcom (o Studio, o registro de inteligência da loja e a documentação). A referência de ferramentas e escopos lista todas, com o escopo que abre cada uma.
Duas barreiras decidem o que um cliente vê: os escopos que você aprova
na tela de consentimento e os escopos que a Shopify concedeu ao seu
Custom App. Uma loja conectada só com read_products nunca mostra as
ferramentas de pedidos ou de tema, não importa o que você aprove. Uma
chave estática, usada em CI e em execuções headless, nunca passou por
uma tela de consentimento, então ela abre as ferramentas relay e nada
mais.
O relay devolve, junto com os dados, o custo da query e o status de limitação da própria Shopify, para que o modelo consiga dosar o ritmo em vez de adivinhar.
Gravação
Somente leitura, de propósito
Pelo MCP Shopify, nem o Claude nem o ChatGPT mudam a sua loja. As queries rodam; toda mutation, e qualquer documento GraphQL que o relay não consiga provar que só lê, é recusada antes de chegar à Shopify, e a tentativa fica registrada no seu log de auditoria.
Uma gravação numa loja no ar é uma decisão que alguém precisa aprovar, e um relay não tem nenhuma pessoa no meio. Por isso as mudanças passam por outro lugar: pelo conector da própria Shopify, se você quer que o assistente segure a caneta, ou pelo chat do painel da BoostEcom, onde @Atlas propõe e você aprova cada mudança.
Faça você mesmo
Se você escrever a sua própria integração
O caminho 3 é a escolha certa quando você precisa de um fluxo que ninguém oferece, ou de dados que nunca podem sair da sua própria infraestrutura. Três hábitos mantêm tudo seguro:
- Dê escopos ao Custom App como daria acessos a um recém-contratado.
Comece pelos escopos de leitura (
read_products,read_orders,read_content,read_themes), observe durante uma semana o que o modelo pede e depois acrescente um escopo de gravação para uma superfície de cada vez. - Nunca dê a um modelo os escopos que um erro não consegue desfazer: configurações de pagamento, contas de funcionários, arquivos.
- Confira cada chamada de ferramenta antes que ela chegue à Shopify: a ferramenta, o escopo que ela exige e a loja que ela atinge. Um modelo pode emitir uma chamada bem formada com o ID de loja errado.
Custo
Quanto custa
O MCP Shopify é grátis em todos os planos da BoostEcom, inclusive no Free. Ele encaminha uma chamada à Admin API da Shopify e não roda nenhum modelo, então não gasta créditos; os limites de requisições por organização existem para impedir abusos, e a página do MCP Shopify mostra esses limites por plano.
A sua assinatura do Claude ou do ChatGPT é separada e não muda: o assistente roda na sua própria conta. O que gasta créditos é o chat da própria BoostEcom, onde @Atlas e os especialistas trabalham na loja.
Dúvidas
Perguntas frequentes
Existe instalação com um clique?
Não. Você conecta a loja à BoostEcom uma vez, por um Custom App da Shopify (o client id e o secret dele vão nas configurações da loja, em Conectores), e depois cola uma URL no seu assistente. Cerca de cinco minutos na primeira vez.
Preciso do Shopify Plus?
Não. Os Custom Apps e a Admin API estão disponíveis em todos os planos da Shopify.
O assistente chega a ver o meu token da Shopify?
Não. O cliente faz login na BoostEcom, nunca na Shopify, e só recebe um token da BoostEcom. Revogue esse token e o cliente perde o acesso, sem nada para mudar na Shopify.
Preciso hospedar alguma coisa?
Não. A BoostEcom hospeda o servidor, e ele não guarda nenhuma sessão entre as chamadas. É por isso que uma única URL atende todos os clientes.
Qual modelo ele usa?
O que você escolher no Claude ou no ChatGPT. O relay responde às chamadas de ferramenta; ele não roda nenhum modelo próprio.
Posso usar a minha própria chave de API da Anthropic ou da OpenAI?
Você não precisa de uma para o relay: o seu assistente usa a sua própria conta do Claude ou do ChatGPT. O chat da própria BoostEcom roda pelas nossas contas do AI Gateway e é medido nos créditos da sua organização; ele não recebe nenhuma chave sua.
Escolha o seu cliente e conecte em quatro minutos
Cada guia traz a URL, o login e o que costuma dar problema, para um cliente.