Branchez votre boutique Shopify sur Claude et ChatGPT.

Un serveur MCP distant, un par boutique. Chaque boutique que vous connectez à BoostEcom reçoit son propre endpoint, qui parle Model Context Protocol en HTTP streamable. Tout client qui parle MCP (Claude, ChatGPT, Claude Code, Cursor, ou un client que vous avez écrit) peut le découvrir, s'y autoriser et appeler ses outils.

Vos identifiants Shopify ne quittent jamais nos serveurs. Le client détient un jeton BoostEcom ; le jeton Shopify de courte durée que délègue l'app BoostEcom reste chez nous, chiffré au repos. Révoquez le jeton BoostEcom et le client est dehors, sans avoir jamais vu un secret Shopify.

• MCP, depuis votre client IAClaude, ChatGPT, Claude Code et Cursor lisent la boutique en direct, en OAuth ou avec une clé statique. En lecture seule.
• Le tableau de bord, avec @AtlasLe seul endroit où l'on écrit, chaque fois après votre validation. Même boutique, même app BoostEcom.
• Intelligence, depuis votre client ou votre codeLe graphe des boutiques Shopify a son propre serveur MCP et une API REST en lecture seule, avec une clé bei_. Des données de marché, jamais celles de votre boutique.
• Un profil UCP publicQuand BoostEcom lit le catalogue public d'une autre boutique, il présente ce profil : recherche et consultation du catalogue uniquement, sans panier, sans paiement, sans secret.

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

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

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

Vous installez l'app BoostEcom depuis votre admin Shopify et choisissez dans l'app ce à quoi elle accède. Votre autorisation est le plafond : nous n'y ajoutons aucun accès.

• OAuth 2.1 avec PKCE, aucun secret client à garder
• Chaque jeton n'ouvre qu'une boutique et est stocké haché
• Une clé statique pour la CI et les exécutions sans navigateur

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

   Votre client appelle l'endpoint sans jeton et reçoit un 401 dont l'en-tête WWW-Authenticate pointe vers nos documents de découverte (RFC 9728).

2. 2

   Il lit le document de la ressource protégée, qui désigne cette origine comme serveur d'autorisation.

3. 3

   Il lit les métadonnées du serveur d'autorisation (RFC 8414) pour trouver les endpoints d'enregistrement, d'autorisation, de jeton et de révocation.

4. 4

   Il s'identifie par un Client ID Metadata Document, une URL https que nous récupérons et vérifions, ou par enregistrement dynamique (RFC 7591). Aucun secret n'est émis et PKCE S256 est obligatoire.

5. 5

   Vous validez un écran de consentement qui nomme les permissions en clair et n'affiche que celles que les accès de l'app BoostEcom peuvent satisfaire.

6. 6

   Le client échange son code à usage unique contre un jeton d'accès qui expire au bout de 60 minutes, et un jeton de rafraîchissement renouvelé à chaque usage.

7. 7

   Un outil hors de l'autorisation répond 403 avec le scope exact à demander : le client se réautorise pour ce seul scope et réessaie.

8. 8

   Déconnectez le client et il appelle l'endpoint de révocation (RFC 7009) : le jeton meurt aussi chez nous, pas seulement dans la mémoire du client.

Chaque jeton ouvre une seule boutique : un jeton émis pour la boutique A est refusé sur la boutique B, et l'appartenance à l'organisation est revérifiée à chaque appel. Les jetons sont stockés sous forme d'empreintes SHA-256, jamais sous une forme que nous pourrions relire.

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

• Écritures refusées avant d'atteindre Shopify
• Chaque tentative d'écriture consignée dans votre journal d'audit
• Les modifications passent par la validation du tableau de bord

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

• L'état de la boutiqueUn seul appel runAudit renvoie la boutique, ses thèmes et un échantillon de produits, pour que le modèle raisonne sur l'ensemble au lieu de recoudre quatre requêtes.
• Les questions de catalogueQuels produits sont encore en brouillon, ce qui est en rupture, quels handles se télescopent : la réponse vient des données en direct, pas d'un export périmé collé dans un chat.
• Tout ce que lit l'API AdminMétachamps, marchés, traductions, stocks : un seul outil passerelle, avec les chiffres de coût de Shopify renvoyés pour que le modèle règle son rythme.
• Le reporting là où vous travaillezRésumez les commandes de la semaine dans le client que vous avez déjà ouvert, sans exporter d'abord les données clients dans un tableur.

• Les scopes accordés à l'app BoostEcom décident de ce qui passe, et Shopify les applique à chaque requête
• Les chiffres de coût et de débit de Shopify reviennent avec les données, pour que le modèle règle son rythme
• Une mutation envoyée par cette passerelle est refusée comme toute autre écriture

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

   Connecter la boutique

   Créez votre compte et installez l'app BoostEcom depuis votre admin Shopify, en un clic. Les accès que vous choisissez dans l'app fixent le plafond de tout ce qui suit.

   Les accès Shopify qui ouvrent des outils

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

   Coller l'URL dans votre client

   Claude et ChatGPT l'acceptent comme connecteur personnalisé. Claude Code et Cursor la lisent dans leur configuration, puis ouvrent le même écran de consentement.

   L'URL à collerurl

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

   Copier
3. 3

   Approuver les scopes

   L'écran de consentement nomme chaque permission en clair et ne propose que ce que vous avez accordé à l'app BoostEcom.

   Ce que votre client demandehttp

   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

   Copier
4. 4

   Interroger votre boutique

   Votre client liste les outils ouverts par votre accord et les appelle dès qu'une question demande des données en direct.

   Ce que votre client peut lister

   • 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

Les jetons émis avant ce catalogue portent l'ancienne autorisation mcp. Elle garde les outils de lecture Shopify qu'elle avait déjà et n'ouvre jamais un système BoostEcom : le Studio, la fiche Intelligence et les outils de documentation exigent un scope validé sur l'écran de consentement.

• Sans compte ni clé : 60 appels par minute et par IP
• Une clé bei_ monte à 6 000 par minute, par organisation
• Uniquement des fiches publiques

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

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

Voir ce que lit Intelligence

Mesuré sur une boutique connectée par la Custom App d'un marchand : une boutique qui accorde moins de scopes en obtient moins. Avec l'app BoostEcom, le plafond est ce que vous accordez à l'app.

Les plans Custom n'ont pas de plafond. Un appel refusé indique le plan, la limite atteinte et la marche à suivre.

• Il n'écrit pas. Toute écriture est refusée et journalisée. Une modification de votre boutique passe par le tableau de bord, où vous la validez.
• Il reste dans ce que vous avez accordé à l'app. Un outil que votre accès Shopify ne peut pas couvrir n'est jamais enregistré : votre client ne le voit jamais.
• Une clé statique s'arrête à 15 outils. Une clé désigne une boutique, jamais une personne. Le Studio, la fiche Intelligence, les données de l'app BoostEcom et les outils de documentation exigent une connexion OAuth.
• Une requête, 30 secondes. Un appel d'outil plus long est interrompu. Un travail long relève d'un workflow du tableau de bord, pas d'un appel d'outil.
• Ni API ni SDK maison. Les surfaces prises en charge sont cet endpoint, le serveur MCP Intelligence et l'API REST Intelligence. Le GraphQL que vous atteignez est celui de Shopify, par la passerelle.