Conecte sua loja Shopify ao Claude e ao ChatGPT.

Um servidor MCP remoto, um por loja. Cada loja que você conecta à BoostEcom recebe o próprio endpoint, que fala Model Context Protocol sobre HTTP em streaming. Qualquer cliente que fale MCP (Claude, ChatGPT, Claude Code, Cursor ou um que você mesmo escreveu) pode descobri-lo, autorizar-se e chamar suas ferramentas.

Suas credenciais da Shopify nunca saem dos nossos servidores. O cliente guarda um token da BoostEcom; o token da Shopify de curta duração que o app BoostEcom delega fica com a gente, criptografado em repouso. Revogue o token da BoostEcom e o cliente fica de fora, sem nunca ter visto um segredo da Shopify.

• MCP, do seu cliente de IAClaude, ChatGPT, Claude Code e Cursor leem a loja ao vivo, via OAuth ou com uma chave estática. Somente leitura.
• O painel, com @AtlasO único lugar onde se escreve, sempre depois da sua aprovação. A mesma loja, o mesmo app BoostEcom.
• Intelligence, do seu cliente ou do seu códigoO grafo de lojas Shopify tem o próprio servidor MCP e uma API REST somente leitura com uma chave bei_. Dados de mercado, nunca os da sua loja.
• Um perfil UCP públicoQuando a BoostEcom lê o catálogo público de outra loja, apresenta este perfil: só busca e consulta de catálogo, sem carrinho, sem checkout, sem segredo.

https://www.boostecom.app/api/mcp/v1/<STORE_ID>

https://www.boostecom.app/api/mcp/intelligence

https://www.boostecom.app/.well-known/ucp-agent

Você instala o app BoostEcom pelo seu admin da Shopify e escolhe no app o que ele pode acessar. A sua autorização é o teto: não acrescentamos nenhum acesso nosso.

• OAuth 2.1 com PKCE, sem client secret para guardar
• Cada token abre uma única loja e fica armazenado como hash
• Uma chave estática para CI e execuções sem navegador

https://www.boostecom.app/api/mcp/v1/<STORE_ID>

GET https://www.boostecom.app/.well-known/oauth-authorization-server
GET https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>
GET https://www.boostecom.app/api/mcp/<STORE_ID>/.well-known/oauth-protected-resource

1. 1

   Seu cliente chama o endpoint sem token e recebe um 401 cujo cabeçalho WWW-Authenticate aponta para os nossos documentos de descoberta (RFC 9728).

2. 2

   Ele lê o documento do recurso protegido, que indica esta origem como servidor de autorização.

3. 3

   Ele lê os metadados do servidor de autorização (RFC 8414) para achar os endpoints de registro, autorização, token e revogação.

4. 4

   Ele se identifica com um Client ID Metadata Document, uma URL https que buscamos e verificamos, ou por registro dinâmico (RFC 7591). Nenhum segredo é emitido e PKCE S256 é obrigatório.

5. 5

   Você aprova uma tela de consentimento que nomeia as permissões em linguagem simples e mostra só as que os acessos do app BoostEcom conseguem atender.

6. 6

   O cliente troca o código de uso único por um token de acesso que expira em 60 minutos e um token de atualização que muda a cada uso.

7. 7

   Uma ferramenta fora da autorização responde 403 com o escopo exato a pedir: o cliente se reautoriza só para esse escopo e tenta de novo.

8. 8

   Desconecte o cliente e ele chama o endpoint de revogação (RFC 7009): o token morre do nosso lado também, não só na memória do cliente.

Cada token abre uma única loja: um token emitido para a loja A é recusado na loja B, e a participação na organização é verificada de novo a cada chamada. Os tokens ficam guardados como hashes SHA-256, nunca em uma forma que possamos ler de volta.

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="BoostEcom MCP",
  resource_metadata="https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>",
  scope="boostecom:store.read boostecom:catalog.read …"

{
  "access_token": "<ACCESS_TOKEN>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "<REFRESH_TOKEN>",
  "scope": "boostecom:store.read boostecom:catalog.read"
}

HTTP/1.1 403 Forbidden
WWW-Authenticate: Bearer error="insufficient_scope",
  scope="boostecom:orders.read",
  resource_metadata="https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>"

• Alterações recusadas antes de chegar à Shopify
• Toda tentativa de alteração vai para o seu log de auditoria
• As mudanças passam pela aprovação no painel

tools/call shopifyAdminGraphQL

mutation {
  productUpdate(product: { id: "gid://shopify/Product/1", title: "New title" }) {
    product { id }
  }
}

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Refused: this mutation is classified destructive (product/price updates, discounts, inventory, …). This connector is read-only: every write requires human approval. Run it from the BoostEcom dashboard chat, where the approval flow lives."
    }
  ]
}

• O estado da lojaUma única chamada runAudit devolve a loja, os temas e uma amostra de produtos, para o modelo raciocinar sobre o conjunto em vez de costurar quatro requisições.
• Perguntas de catálogoQuais produtos ainda são rascunho, o que está esgotado, quais handles colidem: respondido com dados ao vivo, não com uma exportação velha colada num chat.
• Tudo o que a Admin API lêMetacampos, mercados, traduções, estoque: uma única ferramenta de passagem, com os números de custo da Shopify devolvidos para o modelo ajustar o ritmo.
• Relatórios onde você trabalhaResuma os pedidos da semana no cliente que você já tem aberto, sem exportar antes os dados de clientes para uma planilha.

• Os escopos que você concedeu ao app BoostEcom decidem o que passa, e a Shopify os aplica em cada consulta
• Os números de custo e de limite da própria Shopify voltam com os dados, para o modelo ajustar o ritmo
• Uma mutation enviada por ela é recusada como qualquer outra alteração

tools/call shopifyAdminGraphQL

query {
  markets(first: 5) { nodes { name handle } }
  shop { metafields(first: 5) { nodes { key value } } }
}

{
  "data": { "markets": { … }, "shop": { … } },
  "cost": { "requestedQueryCost": <n>, "actualQueryCost": <n> },
  "throttleStatus": {
    "maximumAvailable": <n>,
    "currentlyAvailable": <n>,
    "restoreRate": <n>
  }
}

1. 1

   Conectar a loja

   Crie sua conta e instale o app BoostEcom pelo seu admin da Shopify, com um clique. Os acessos que você escolher no app limitam tudo o que vem depois.

   Permissões da Shopify que liberam ferramentas

   • read_products
   • read_orders
   • read_content
   • read_themes
   • read_analytics
   • read_reports
2. 2

   Colar a URL no seu cliente

   O Claude e o ChatGPT recebem a URL como conector personalizado. O Claude Code e o Cursor recebem na configuração e depois abrem a mesma tela de consentimento.

   A URL para colarurl

   https://www.boostecom.app/api/mcp/v1/<STORE_ID>

   Copiar
3. 3

   Aprovar os escopos

   A tela de consentimento descreve cada permissão em linguagem simples e só oferece o que você concedeu ao app BoostEcom.

   O que seu cliente pedehttp

   GET https://www.boostecom.app/oauth/authorize
     ?response_type=code&client_id=<CLIENT_ID>
     &resource=https://www.boostecom.app/api/mcp/v1/<STORE_ID>
     &scope=boostecom:store.read boostecom:catalog.read
     &code_challenge=<S256>&code_challenge_method=S256

   Copiar
4. 4

   Perguntar sobre sua loja

   Seu cliente lista as ferramentas que a sua autorização liberou e chama cada uma sempre que uma pergunta precisa de dados em tempo real.

   O que seu cliente pode listar

   • getStoreContext
   • getShopInfo
   • runAudit
   • listProducts
   • getProduct
   • listOrders
   • listPages
   • getMetafields
   • listMetaobjectDefinitions
   • listMetaobjects
   • listThemes
   • getTheme
   • runShopifyQL
   • introspectSchema
   • shopifyAdminGraphQL
   • getStudioSection
   • getStudioProduction
   • listStudioGenerations
   • getStudioPricing
   • getStoreIntelligence
   • listThemeUpdates
   • getUpdateJob
   • listBackups
   • getUptime
   • getAppEmbedStatus
   • getDomainHealth
   • getActionRequest
   • searchDocs
   • getDoc
   • helmListModels
   • helmPlanSection

Tokens emitidos antes deste catálogo carregam a antiga autorização mcp. Ela mantém as ferramentas de leitura da Shopify que já tinha e nunca abre um sistema da BoostEcom: o Studio, a inteligência da loja e as ferramentas de documentação exigem um escopo aprovado na tela de consentimento.

• Sem conta e sem chave: 60 chamadas por minuto por IP
• Uma chave bei_ sobe para 6.000 por minuto, por organização
• Somente fichas públicas

{
  "mcpServers": {
    "boostecom-intelligence": {
      "url": "https://www.boostecom.app/api/mcp/intelligence"
    }
  }
}

curl -s https://www.boostecom.app/api/mcp/intelligence/manifest

Ver o que a Intelligence lê

Medido numa loja conectada pelo Custom App de um lojista: uma loja que libera menos escopos recebe menos. Com o app BoostEcom, o teto é o que você concede ao app.

Os planos Custom não têm limite. Quando uma chamada é recusada, a resposta informa o plano, o limite atingido e o próximo passo.

• Ele não altera nada. Toda alteração é recusada e registrada. Qualquer mudança na sua loja passa pelo painel, onde você aprova.
• Ele fica dentro do que você concedeu ao app. Uma ferramenta que a sua permissão Shopify não cobre nunca é registrada, então o seu cliente nunca a vê.
• Uma chave estática para em 15 ferramentas. Uma chave identifica uma loja, nunca uma pessoa. O Studio, a inteligência da loja, os registros do app BoostEcom e as ferramentas de documentação exigem login via OAuth.
• Uma requisição, 30 segundos. Uma chamada de ferramenta mais longa é interrompida. Trabalho longo cabe num workflow do painel, não numa chamada de ferramenta.
• Sem API nem SDK próprios. As superfícies suportadas são este endpoint, o servidor MCP Intelligence e a API REST Intelligence. O GraphQL que você alcança é o da Shopify, pela passagem.