Blog

Shopify com o Claude ou o ChatGPT: três formas de conectar, comparadas

Um conector personalizado, o conector da própria Shopify ou o seu próprio código: três formas de ligar uma loja Shopify ao Claude ou ao ChatGPT, e o que cada uma lê, grava e custa.

· Christopher Lasgi · ~10 min de leitura

Guia completo

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 ShopifyO seu próprio código
O que você fazcola uma URL, faz login, aprova os escoposadiciona pelo diretório de conectores do Claudechama a Admin API e entrega os resultados ao modelo
ClientesClaude, ChatGPT, Claude Code, CursorClaudeo que você construir
Lê a lojasim, dentro da concessão do seu Custom Appsimo que você programar
Grava na lojanão, recusado antes da Shopifysimo que você programar
Código para manternenhumnenhumtodo

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:

ClaudeChatGPTClaude CodeCursor
Onde você adicionaConfigurações, ConectoresModo desenvolvedor, Conectoresclaude mcp add, depois /mcpmcp.json, depois configurações de MCP
LoginOAuthOAuthOAuthOAuth
Chave estática para CIdesnecessáriadesnecessáriasimsim
GuiaClaudeChatGPTClaude CodeCursor

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.

Receba cada artigo por e-mail

Um artigo por semana na sua caixa de entrada. O mesmo conteúdo desta página, entregue a você, sem precisar procurar.

Confirmação dupla: mandamos um link de confirmação e mais nada até ele ser clicado. Cancelamento com um clique em todo e-mail.

Shopify com o Claude ou o ChatGPT: três formas de conectar, comparadas · BoostEcom