story-theme-mcp 1.7.3 → 1.7.4

package/README.md

@@ -2,7 +2,7 @@
 
 Votre assistant IA connaît le [Story Thème](https://story-theme.com) par cœur — chaque section, chaque bloc, chaque réglage — et construit des boutiques Shopify propres et professionnelles, sans jamais produire un fichier que Shopify refuserait.
 
-Réservé aux titulaires d'une licence Story Thème. Le jeton se génère dans l'espace membre : **Story Thème > MCP & Appli**.
+Réservé aux titulaires d'une licence Story Thème. Le jeton se génère dans l'espace membre : **Story Thème > MCP**.
 
 ```
 Vous : « Crée la boutique Maison Lumen : bougies parfumées coulées à la main à Lyon. »
@@ -15,7 +15,7 @@ IA   : une seule salve de questions (photos, collection, conditions… ou « vas
 
 ## Installation
 
-**Le plus simple — l'extension Claude.** Téléchargez `story-theme-mcp.mcpb` depuis votre espace membre (page MCP & Appli) et ouvrez le fichier : Claude installe le serveur et vous demande votre jeton dans un formulaire. Rien d'autre à installer, Node compris.
+**Le plus simple — l'extension Claude.** Téléchargez `story-theme-mcp.mcpb` depuis votre espace membre (page MCP) et ouvrez le fichier : Claude installe le serveur et vous demande votre jeton dans un formulaire. Rien d'autre à installer, Node compris.
 
 Les deux méthodes ci-dessous restent valables si vous préférez configurer à la main. Elles demandent Node 20 ou plus ([nodejs.org](https://nodejs.org)).
 
@@ -82,7 +82,7 @@ Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-t
 
 | Variable | Défaut | Rôle |
 |---|---|---|
-| `STORY_MCP_TOKEN` | — | Jeton personnel (espace membre > MCP & Appli). Vérifie la licence et donne accès au thème publié. |
+| `STORY_MCP_TOKEN` | — | Jeton personnel (espace membre > MCP). Vérifie la licence et donne accès au thème publié. |
 | `STORY_MCP_HOME` | `~/Documents/Story Theme MCP` | Projets, historique, exports, cache du thème. |
 | `STORY_MCP_LANGUAGE` | `fr` | Langue par défaut des projets et des textes. |
 | `STORY_MCP_CANAL` | `stable` | `test` pour la version en test du thème (comptes testeurs). |
@@ -117,7 +117,7 @@ npm run fonts     # recharge la bibliothèque de polices Shopify (shopify.dev)
 npm run bundle    # fabrique build/story-theme-mcp-<version>.mcpb (extension Claude, un clic)
 ```
 
-Après `npm run bundle`, déposer le `.mcpb` dans le dossier `mcp/` de l'espace membre : la page MCP & Appli sert automatiquement la version la plus récente qu'elle y trouve.
+Après `npm run bundle`, déposer le `.mcpb` dans le dossier `mcp/` de l'espace membre : la page MCP sert automatiquement la version la plus récente qu'elle y trouve.
 
 Avec `STORY_THEME_DIR` sur le dépôt du thème, le MCP lit le thème en cours d'écriture et n'appelle pas l'espace membre. Les connaissances rédigées à la main vivent dans `src/knowledge/` (descriptions de chaque section et bloc, compositions par métier, directions artistiques, guides) ; tout le reste vient du thème. `npm run check` signale une section ou un bloc public sans description.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "story-theme-mcp",
-  "version": "1.7.3",
+  "version": "1.7.4",
   "description": "Serveur MCP du Story Thème : votre assistant IA connaît le thème Shopify Story par cœur et construit des boutiques propres et professionnelles.",
   "type": "module",
   "main": "src/index.js",

package/src/config.js

@@ -11,7 +11,7 @@ export function loadConfig(env = process.env) {
   const themeDir = env.STORY_THEME_DIR || '';
   return {
     version: VERSION,
-    // Jeton personnel du client (espace membre > MCP & Appli). Sans lui, pas de thème à distance :
+    // Jeton personnel du client (espace membre > MCP). Sans lui, pas de thème à distance :
     // le MCP retombe sur son cache, puis sur un dossier local.
     token: (env.STORY_MCP_TOKEN || '').trim(),
     apiBase: (env.STORY_MCP_API || DEFAULT_API).trim(),

package/src/index.js

@@ -25,7 +25,7 @@ if (process.argv.includes('--help') || process.argv.includes('-h')) {
       'construit des boutiques Shopify prêtes à importer. Il ne s’utilise pas à la main.',
       '',
       'Variables d’environnement :',
-      '  STORY_MCP_TOKEN     jeton personnel (espace membre Story Thème > MCP & Appli) — indispensable',
+      '  STORY_MCP_TOKEN     jeton personnel (espace membre Story Thème > MCP) — indispensable',
       '  STORY_MCP_HOME      dossier des projets et exports (défaut : ~/Documents/Story Theme MCP)',
       '  STORY_MCP_LANGUAGE  langue des textes (défaut : fr)',
       '  STORY_MCP_CANAL     « test » pour la version en test du thème (comptes testeurs)',

package/src/knowledge/brancher.js

@@ -18,7 +18,7 @@ const ETAPES = [
   'Dans l’administration Shopify, installez l’application gratuite Theme Access (éditée par Shopify) : https://apps.shopify.com/theme-access',
   'Dans Theme Access : « Créer un mot de passe », avec votre propre adresse e-mail.',
   'Ouvrez l’e-mail reçu et affichez le mot de passe : il commence par shptka_ et ne s’affiche qu’une fois.',
-  `Collez-le dans votre espace membre Story Thème, page MCP & Appli > « Brancher une boutique » (${PAGE_BRANCHEMENT}). Jamais dans la conversation.`,
+  `Collez-le dans votre espace membre Story Thème, page MCP > « Brancher une boutique » (${PAGE_BRANCHEMENT}). Jamais dans la conversation.`,
 ];
 
 /** La marche à suivre complète, prête à recopier au marchand. */
@@ -33,3 +33,31 @@ export const TUTO_BRANCHEMENT = [
 
 /** Une ligne pour les réponses où la boutique n'est pas (ou peut-être pas) branchée. */
 export const INVITATION_BRANCHEMENT = `Boutique pas encore branchée ? Proposez Theme Access au marchand (deux minutes, une seule fois) : list_shops donne la marche à suivre${VIDEO_BRANCHEMENT ? ` et la vidéo (${VIDEO_BRANCHEMENT})` : ''}. Sans lui, le zip reste la solution de repli, à importer à chaque version.`;
+
+/* --------------------------------------------- le connecteur Shopify officiel */
+
+// Theme Access n'ouvre que les thèmes. Le connecteur Shopify officiel, édité par Shopify pour
+// ChatGPT et Claude (mai 2026), ouvre le reste : produits, prix, stocks, collections, réductions,
+// commandes. Avec lui, l'assistant remplit les pages des vrais produits et crée les réductions des
+// offres au lieu de laisser une liste au marchand : le MCP le propose donc, surtout au début.
+
+/** La fiche du connecteur dans l'annuaire de Claude (vérifiée le 20/10/2026). */
+export const LIEN_CONNECTEUR_SHOPIFY_CLAUDE = 'https://claude.com/connectors/shopify';
+
+/** Le conseil, tel que l'assistant le lit dans un résultat d'outil. */
+// Le MCP ne voit pas les autres connecteurs de l'assistant ; l'assistant, lui, voit ses outils :
+// c'est à lui de vérifier, et de se taire si le connecteur est déjà là.
+export const CONSEIL_CONNECTEUR_SHOPIFY = `Connecteur Shopify officiel — seulement s'il n'est pas déjà en place. Vérifiez d'abord vos outils : si vous avez déjà ceux du connecteur Shopify (produits, commandes, réductions…), n'en parlez pas. S'il est installé mais pas actif dans cette conversation, dites simplement de l'activer (ChatGPT : @Shopify). Sinon, proposez-le au marchand en une phrase : édité par Shopify, il vous ouvre, en plus du thème, ses produits, prix, stocks, collections, réductions et commandes (pages remplies de ses vrais produits, réductions des offres créées pour lui, photos déposées dans Fichiers). Où l'ajouter : Claude, ${LIEN_CONNECTEUR_SHOPIFY_CLAUDE} ; ChatGPT, Applis › « Shopify » ; ailleurs, l'annuaire de connecteurs de son IA. S'il l'a refusé ou dit l'avoir déjà, n'y revenez plus.`;
+
+/**
+ * Surtout au début, pas tout le temps : un compteur par conversation (une session MCP) qui
+ * rend le conseil aux deux premiers résultats, puis à un sur cinq. Chaque appel compte.
+ * @returns {() => string} le conseil, ou une chaîne vide
+ */
+export function rappelConnecteurShopify() {
+  let appels = 0;
+  return () => {
+    appels += 1;
+    return appels <= 2 || appels % 5 === 0 ? CONSEIL_CONNECTEUR_SHOPIFY : '';
+  };
+}

package/src/knowledge/demos.js

@@ -22,7 +22,7 @@ export function creerDemos(config) {
   const appel = async (chemin) => {
     if (!config.token) {
       throw new Error(
-        'Les boutiques démo demandent un jeton : ajoutez STORY_MCP_TOKEN (espace membre Story Thème > MCP & Appli).',
+        'Les boutiques démo demandent un jeton : ajoutez STORY_MCP_TOKEN (espace membre Story Thème > MCP).',
       );
     }
     const reponse = await fetch(`${config.apiBase.replace(/\/+$/, '')}${chemin}`, {

package/src/server.js

@@ -95,7 +95,9 @@ Appelez list_shops AVANT de construire : c'est ce qui décide du chemin.
 - **Aucune boutique branchée** : recopiez-lui la marche à suivre que list_shops renvoie (Theme Access, deux minutes, une seule fois, rien à installer sur l'ordinateur, avec la vidéo quand elle existe) ET construisez quand même la V1 tout de suite. Insistez gentiment : c'est ce qui lui évite d'importer un zip à chaque retouche. Dès qu'il a branché sa boutique, push_to_shop y envoie le projet. S'il ne veut pas, export_theme donne le zip, solution de repli.
 - **Le mot de passe Theme Access ne passe jamais par la conversation** : il se colle dans l'espace membre. S'il le colle dans le chat, dites-lui de le supprimer dans Theme Access et d'en créer un autre.
 
-Theme Access n'ouvre que les thèmes. Le Story Thème affiche ; il ne crée ni produits, ni collections, ni pages, ni menus, ni réductions. Pour cela, proposez au marchand d'ajouter le connecteur Shopify officiel à son assistant (Réglages > Connecteurs > Shopify) : vous lirez ses vrais produits et collections, créerez les pages et leur attribuerez les modèles, monterez les menus, créerez les réductions des offres et déposerez ses photos dans Contenu > Fichiers. Sans connecteur, listez ce qu'il doit faire à la main. Une boutique réelle bat toujours un contenu inventé : noms de produits, prix, collections, photos déjà en ligne.
+Theme Access n'ouvre que les thèmes. Le Story Thème affiche ; il ne crée ni produits, ni collections, ni pages, ni menus, ni réductions. Pour cela, le connecteur Shopify officiel (édité par Shopify, pour ChatGPT, Claude et d'autres) : vous lirez ses vrais produits et collections, créerez les pages et leur attribuerez les modèles, monterez les menus, créerez les réductions des offres et déposerez ses photos dans Contenu > Fichiers. Une boutique réelle bat toujours un contenu inventé : noms de produits, prix, collections, photos déjà en ligne.
+
+Proposez-le SEULEMENT s'il n'est pas déjà en place : regardez d'abord vos outils. Si vous avez déjà ceux du connecteur Shopify, servez-vous-en sans en parler. Sinon, proposez-le tôt (dès le premier échange sur sa boutique), puis seulement quand une demande touche aux produits, prix, stocks, collections, pages, menus ou réductions — une phrase, jamais à chaque message, et plus du tout s'il l'a refusé. Où l'ajouter : Claude, https://claude.com/connectors/shopify ; ChatGPT, Applis › « Shopify » (installé mais pas actif dans la conversation : @Shopify) ; ailleurs, l'annuaire de connecteurs de son IA. Ne répondez jamais « il faudrait des autorisations supplémentaires » : nommez le connecteur. Sans lui, listez ce qu'il doit faire à la main.
 
 Si un connecteur Shopify est disponible : lisez les collections et les produits réels, copiez 3 à 6 belles photos dans Contenu > Fichiers (read_guide images donne la requête fileCreate), puis passez leurs noms dans images (celles de 1600 px et plus dans images.large) et les handles dans collections.
 
@@ -124,12 +126,12 @@ Répondez au marchand dans sa langue, en vouvoyant en français, brièvement.`;
 // ni ses outils ni ses consignes ne sont montrés : l'assistant ne propose pas ce qu'il ne peut pas faire.
 const INSTRUCTIONS_APPLI = `## L'appli Story Theme Apps
 
-**L'appli Story Theme Apps** est gratuite : le marchand l'installe lui-même depuis son espace membre (page MCP & Appli). Elle ajoute les avis clients, les tests A/B, les offres cumulables et récompenses panier, et les codes promo. Sur une boutique branchée où elle est installée, commencez par app_status, puis :
+**L'appli Story Theme Apps** est gratuite : le marchand l'installe lui-même depuis son espace membre (page Story Theme Apps). Elle ajoute les avis clients, les tests A/B, les offres cumulables et récompenses panier, et les codes promo. Sur une boutique branchée où elle est installée, commencez par app_status, puis :
 - app_reviews : importer un export CSV (Judge.me, Loox…), ajouter, modérer, répondre aux avis ;
 - app_ab_tests : opposer deux modèles de page. Le modèle B doit exister dans le thème PUBLIÉ : composez-le (compose_page, edit_template), puis, avec l'accord du marchand, envoyez CE SEUL fichier : push_to_shop({ shops, theme: <thème publié>, files: ["templates/product.offre-b.json"], confirm: true }) — un modèle en plus ne change aucune page en ligne. Suivez les résultats (14 jours au moins), puis appliquez le gagnant ;
 - app_offers : les paliers et lots se règlent dans le thème (offres de la fiche produit), l'appli applique la remise au panier : activate la met en place, diagnostic dit pourquoi une offre ne s'applique pas ;
 - app_discount_codes : créer un code promo cumulable avec les offres.
-Les actions irréversibles et celles sur plusieurs boutiques demandent confirm: true : décrivez ce qui va se passer et attendez le oui du marchand. Appli pas installée ? Il l'installe depuis son espace membre (page MCP & Appli > « Installer l'appli », ou « Demander l'appli » tant que l'installation en un clic n'est pas ouverte) ; en attendant, dites-lui ce qu'il faudra régler.
+Les actions irréversibles et celles sur plusieurs boutiques demandent confirm: true : décrivez ce qui va se passer et attendez le oui du marchand. Appli pas installée ? Il l'installe depuis son espace membre (page Story Theme Apps > « Installer l'appli ») ; en attendant, dites-lui ce qu'il faudra régler.
 
 `;
 
@@ -506,7 +508,7 @@ export function createServer(config) {
           update && !changed && !erreur && info.origin !== 'cache' ? 'Déjà à jour : aucune version plus récente publiée.' : null,
           erreur ? `⚠️ Mise à jour impossible : ${erreur}` : null,
           !config.remote && !config.token && !config.themeDirExplicit
-            ? '\nAucun jeton configuré : ajoutez STORY_MCP_TOKEN (espace membre Story Thème > MCP & Appli) pour suivre automatiquement les versions publiées.'
+            ? '\nAucun jeton configuré : ajoutez STORY_MCP_TOKEN (espace membre Story Thème > MCP) pour suivre automatiquement les versions publiées.'
             : null,
         ]
           .filter(Boolean)
@@ -1035,7 +1037,7 @@ export function createServer(config) {
         'À dire au marchand, dans cet ordre : ce qui a été construit ; « Ce que j’ai inventé, à valider » (avis d’exemple et leurs prénoms, dates et histoire, conditions de livraison et de retour, prix et remises des offres, horaires, chiffres) ; ce qu’il doit créer dans Shopify (réductions des offres, pages et modèles, menus, application d’avis).',
         'Sa boutique est branchée (list_shops) ? push_to_shop({ shops, create: true }) y envoie la V1 dans un thème non publié, sans zip.',
         INVITATION_BRANCHEMENT,
-        'Proposez-lui aussi le connecteur Shopify officiel : vous pourrez créer les pages et leurs modèles, les menus, les réductions et déposer ses photos, au lieu de lui laisser une liste à faire à la main.',
+        'Pas encore de connecteur Shopify officiel parmi vos outils ? Proposez-le-lui : vous pourrez créer les pages et leurs modèles, les menus, les réductions et déposer ses photos, au lieu de lui laisser une liste à faire à la main. Déjà là : servez-vous-en, sans en parler.',
         '',
         'Questions à poser maintenant pour affiner (pas plus de 5) :',
         ...questions.slice(0, 5).map((question) => `- ${question}`),

package/src/shops/app-tools.js

@@ -9,7 +9,7 @@ import { formatApp } from './format.js';
 // Ce qu'il faut dire au marchand quand l'appli manque : il l'installe lui-même, depuis son espace
 // membre (bouton « Installer l'appli » ; « Demander l'appli » tant que Shopify ne l'a pas validée).
 export const DEMANDER_APPLI =
-  "depuis son espace membre, page MCP & Appli (https://story-theme.com/mcp) : « Installer l'appli », gratuite, en un clic — ou « Demander l'appli » si l'installation en un clic n'y est pas encore ouverte ; à défaut, contact@story-theme.com";
+  "depuis son espace membre, page Story Theme Apps (https://story-theme.com/apps) : « Installer l'appli », gratuite, en un clic ; à défaut, contact@story-theme.com";
 
 export const APPLI_ABSENTE = `L'appli Story Theme Apps n'est pas installée sur cette boutique, ou la boutique n'est pas branchée par Theme Access dans l'espace membre. Elle est gratuite : dites au marchand de l'installer ${DEMANDER_APPLI}, et de brancher sa boutique avec Theme Access (même page). En attendant, ses thèmes restent accessibles : pull_from_shop, push_to_shop, update_theme.`;
 

package/src/shops/direct.js

@@ -15,7 +15,7 @@ import { parseThemeJson } from '../theme/loader.js';
 import { fileKind, validateFile } from '../validate/template.js';
 import { majeure } from '../migrate/source.js';
 import { devinerLangue, textesDesModeles } from '../validate/design.js';
-import { TUTO_BRANCHEMENT } from '../knowledge/brancher.js';
+import { TUTO_BRANCHEMENT, rappelConnecteurShopify } from '../knowledge/brancher.js';
 
 const chemin = (config, suite) => `${String(config.apiBase || 'https://story-theme.com').replace(/\/+$/, '')}/api/v1/mcp${suite}`;
 
@@ -113,6 +113,10 @@ function memoriser(store, slug, domaine, theme, fichiers, { cree = false } = {})
 }
 
 export function registerDirectTools(server, config, { ctx, ok, garde }) {
+  // Le conseil du connecteur Shopify officiel suit la conversation : présent aux premiers
+  // résultats, puis de loin en loin (voir rappelConnecteurShopify).
+  const conseilShopify = rappelConnecteurShopify();
+
   server.registerTool(
     'list_shops',
     {
@@ -124,9 +128,10 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
     garde(async () => {
       const { boutiques = [] } = await appel(config, '/boutiques');
       if (!boutiques.length) {
-        return ok(`Aucune boutique déclarée dans ce compte Story Thème (espace membre > Boutiques).\n\n${AIDE_BRANCHEMENT}`, { boutiques });
+        return ok([`Aucune boutique déclarée dans ce compte Story Thème (espace membre > Boutiques).\n\n${AIDE_BRANCHEMENT}`, conseilShopify()].filter(Boolean).join('\n\n'), { boutiques });
       }
       const lignes = boutiques.map((b) => `${b.branchee ? '●' : '○'} ${b.nom} — ${b.domaine}${b.branchee ? '' : ' (non branchée)'}`);
+      const conseil = conseilShopify();
       const branchees = boutiques.filter((b) => b.branchee).length;
       return ok(
         [
@@ -140,6 +145,7 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
           // Une seule boutique branchée sur trois, c'est deux marchands qui ignorent encore
           // que c'est possible : la marche à suivre reste affichée tant qu'il en manque une.
           branchees < boutiques.length ? `${branchees ? '\n' : ''}${AIDE_BRANCHEMENT}` : '',
+          conseil ? `\n${conseil}` : '',
         ]
           .filter((ligne) => ligne !== '')
           .join('\n'),
@@ -363,6 +369,7 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
           resultat.theme.role === 'main' ? '' : 'Le marchand vérifie sur ordinateur et sur mobile, puis publie lui-même.',
           exclus.length && !voulus ? `Modèles exclus du projet mais toujours présents dans ce thème : ${exclus.slice(0, 8).join(', ')}${exclus.length > 8 ? '…' : ''}.` : '',
           voulus ? `Envoi limité à : ${voulus.join(', ')} ; le reste du thème n'a pas été touché.` : 'Images, produits, collections, menus et réductions restent à créer côté Shopify : review_project en donne la liste.',
+          conseilShopify(),
         ]
           .filter(Boolean)
           .join('\n'),
@@ -485,6 +492,7 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
           repris.length ? repris.slice(0, 20).map((chemin) => `- ${chemin}`).join('\n') + (repris.length > 20 ? `\n- … ${repris.length - 20} autre(s)` : '') : 'Le projet était déjà identique à la boutique.',
           '',
           'Le projet reflète maintenant la boutique, modifications faites à la main comprises. Modifiez (read_file, edit_template, compose_page…), puis renvoyez avec push_to_shop dans ce même thème. undo revient à la version d’avant la relecture.',
+          conseilShopify(),
         ]
           .filter(Boolean)
           .join('\n'),

package/src/shops/format.js

@@ -17,7 +17,7 @@ export function formatShopList(data) {
   const lignes = [BANDEAU, `Compte : ${data.account?.email || '?'} · ${shops.length} boutique${shops.length > 1 ? 's' : ''} connectée${shops.length > 1 ? 's' : ''}`, ''];
   if (!shops.length) {
     lignes.push(
-      "Aucune boutique connectée. Pour en connecter une : installez l'appli Story Theme Apps sur la boutique (depuis l'espace membre Story Thème, page MCP & Appli), et branchez la boutique avec Theme Access (même page).",
+      "Aucune boutique connectée. Pour en connecter une : installez l'appli Story Theme Apps sur la boutique (depuis l'espace membre Story Thème, page Story Theme Apps), et branchez la boutique avec Theme Access (même page).",
     );
     return lignes.join('\n');
   }

package/src/theme/source.js

@@ -19,7 +19,7 @@ import path from 'node:path';
 import { unzipSync } from 'fflate';
 
 const AIDE_JETON = `Aucun thème disponible. Deux façons de brancher le MCP :
-  • un jeton : générez-le dans votre espace membre Story Thème (menu « MCP & Appli »), puis ajoutez STORY_MCP_TOKEN à la configuration du MCP ;
+  • un jeton : générez-le dans votre espace membre Story Thème (menu « MCP »), puis ajoutez STORY_MCP_TOKEN à la configuration du MCP ;
   • un dossier : pointez STORY_THEME_DIR sur un thème Story déjà décompressé.`;
 
 /** Erreur de licence : le jeton est refusé ou l'abonnement n'est plus actif. Jamais un repli. */

package/src/version.js

@@ -1,3 +1,3 @@
 // Version du serveur MCP. Ici et dans package.json — les deux doivent être identiques
 // (npm test le vérifie), et rien d'autre ne la redéclare.
-export const VERSION = '1.7.3';
+export const VERSION = '1.7.4';