Collega il tuo negozio Shopify a Claude e ChatGPT.

Un server MCP remoto, uno per negozio. Ogni negozio che colleghi a BoostEcom riceve il proprio endpoint, che parla Model Context Protocol su HTTP in streaming. Qualsiasi client che parla MCP (Claude, ChatGPT, Claude Code, Cursor o uno scritto da te) può trovarlo, autorizzarsi e chiamarne gli strumenti.

Le tue credenziali Shopify non lasciano mai i nostri server. Il client detiene un token BoostEcom; il token Shopify di breve durata delegato dall'app BoostEcom resta da noi, cifrato a riposo. Revochi il token BoostEcom e il client è fuori, senza aver mai visto un segreto Shopify.

• MCP, dal tuo client IAClaude, ChatGPT, Claude Code e Cursor leggono il negozio in diretta, con OAuth o con una chiave statica. Solo lettura.
• La dashboard, con @AtlasL'unico posto dove si scrive, ogni volta dopo la tua approvazione. Stesso negozio, stessa app BoostEcom.
• Intelligence, dal tuo client o dal tuo codiceIl grafo dei negozi Shopify ha un proprio server MCP e un'API REST in sola lettura con una chiave bei_. Dati di mercato, mai quelli del tuo negozio.
• Un profilo UCP pubblicoQuando BoostEcom legge il catalogo pubblico di un altro negozio, presenta questo profilo: solo ricerca e consultazione del catalogo, niente carrello, niente checkout, nessun segreto.

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

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

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

Installi l'app BoostEcom dal tuo admin Shopify e scegli nell'app a cosa può accedere. La tua autorizzazione è il tetto: non aggiungiamo nessun accesso nostro.

• OAuth 2.1 con PKCE, nessun client secret da custodire
• Ogni token apre un solo negozio ed è salvato come hash
• Una chiave statica per la CI e le esecuzioni senza browser

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

   Il tuo client chiama l'endpoint senza token e riceve un 401 la cui intestazione WWW-Authenticate punta ai nostri documenti di discovery (RFC 9728).

2. 2

   Legge il documento della risorsa protetta, che indica questa origine come server di autorizzazione.

3. 3

   Legge i metadati del server di autorizzazione (RFC 8414) per trovare gli endpoint di registrazione, autorizzazione, token e revoca.

4. 4

   Si identifica con un Client ID Metadata Document, un URL https che scarichiamo e verifichiamo, oppure con la registrazione dinamica (RFC 7591). Nessun segreto viene emesso e PKCE S256 è obbligatorio.

5. 5

   Approvi una schermata di consenso che nomina i permessi in chiaro e mostra solo quelli che gli accessi dell'app BoostEcom possono soddisfare.

6. 6

   Il client scambia il suo codice monouso con un token di accesso che scade dopo 60 minuti e un token di aggiornamento che ruota a ogni uso.

7. 7

   Uno strumento fuori dall'autorizzazione risponde 403 con lo scope esatto da chiedere: il client si riautorizza per quel solo scope e riprova.

8. 8

   Scollega il client e chiama l'endpoint di revoca (RFC 7009): il token muore anche da noi, non solo nella memoria del client.

Ogni token apre un solo negozio: un token emesso per il negozio A viene rifiutato sul negozio B, e l'appartenenza all'organizzazione viene ricontrollata a ogni chiamata. I token sono salvati come hash SHA-256, mai in una forma che potremmo rileggere.

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>"

• Modifiche rifiutate prima che arrivino a Shopify
• Ogni tentativo di scrittura finisce nel tuo registro di audit
• Le modifiche passano dall'approvazione in dashboard

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."
    }
  ]
}

• Lo stato del negozioUna sola chiamata runAudit restituisce il negozio, i suoi temi e un campione di prodotti, così il modello ragiona sull'insieme invece di ricucire quattro richieste.
• Domande sul catalogoQuali prodotti sono ancora bozze, cosa è esaurito, quali handle si scontrano: risposte sui dati in diretta, non su un export vecchio incollato in una chat.
• Tutto ciò che legge l'Admin APIMetafield, mercati, traduzioni, scorte: un solo strumento passthrough, con i costi di Shopify restituiti perché il modello regoli il proprio ritmo.
• Report dove lavoriRiassumi gli ordini della settimana nel client che hai già aperto, senza esportare prima i dati dei clienti in un foglio di calcolo.

• Gli scope che hai concesso all'app BoostEcom decidono cosa passa, e Shopify li applica a ogni query
• I valori di costo e di throttling di Shopify tornano con i dati, così il modello regola il proprio ritmo
• Una mutation inviata da qui viene rifiutata come qualsiasi altra scrittura

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

   Collega il negozio

   Crea il tuo account e installa l'app BoostEcom dal tuo admin Shopify, con un clic. Gli accessi che scegli nell'app fanno da tetto a tutto il resto.

   I permessi Shopify che aprono strumenti

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

   Incolla l'URL nel tuo client

   Claude e ChatGPT lo accettano come connettore personalizzato. Claude Code e Cursor lo leggono dalla loro configurazione, poi aprono la stessa schermata di consenso.

   L'URL da incollareurl

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

   Copia
3. 3

   Approva gli scope

   La schermata di consenso descrive ogni permesso in parole semplici e propone solo quello che hai concesso all'app BoostEcom.

   Cosa chiede il tuo clienthttp

   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

   Copia
4. 4

   Fai domande sul tuo negozio

   Il tuo client elenca gli strumenti aperti dalla tua autorizzazione e li chiama ogni volta che una domanda richiede dati in tempo reale.

   Cosa può elencare il tuo client

   • 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

I token emessi prima di questo catalogo portano la vecchia autorizzazione mcp. Mantiene gli strumenti di lettura Shopify che aveva già e non apre mai un sistema BoostEcom: Studio, la scheda Intelligence e gli strumenti di documentazione richiedono uno scope approvato nella schermata di consenso.

• Senza account né chiave: 60 chiamate al minuto per IP
• Una chiave bei_ lo porta a 6000 al minuto, per organizzazione
• Solo schede pubbliche

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

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

Vedi cosa legge Intelligence

Misurato su un negozio collegato con la Custom App di un merchant: un negozio che concede meno scope ne ottiene meno. Con l'app BoostEcom, il tetto è quello che concedi all'app.

I piani Custom non hanno limiti. Una chiamata rifiutata indica il piano, il limite raggiunto e cosa fare.

• Non scrive. Ogni modifica viene rifiutata e registrata. Un cambiamento al tuo negozio passa dalla dashboard, dove lo approvi tu.
• Resta dentro quello che hai concesso all'app. Uno strumento che il tuo permesso Shopify non può coprire non viene mai registrato, quindi il tuo client non lo vede mai.
• Una chiave statica si ferma a 15 strumenti. Una chiave indica un negozio, mai una persona. Studio, la scheda Intelligence del negozio, i dati dell'app BoostEcom e gli strumenti di documentazione richiedono un accesso OAuth.
• Una richiesta, 30 secondi. Una chiamata a uno strumento più lunga viene interrotta. Il lavoro lungo va in un workflow della dashboard, non in una chiamata a uno strumento.
• Nessuna API né SDK nostri. Le superfici supportate sono questo endpoint, il server MCP Intelligence e l'API REST Intelligence. Il GraphQL che raggiungi è quello di Shopify, tramite il passthrough.