Aller au contenu
Retour au blog
mcpaiintegrationstutorial

MCP de configurateur de produits : connectez Claude, Cursor et VS Code à Simplio3D

Simplio3D·
MCP de configurateur de produits : connectez Claude, Cursor et VS Code à Simplio3D

Posez dès aujourd’hui une question à un assistant IA sur votre configurateur de produits, et il répondra à partir de tout ce que vous collez dans le chat : une capture d’écran, une liste d’options, un prix saisi manuellement. Les connecteurs MCP éliminent cette étape. Un connecteur offre à l’assistant un accès direct et autorisé à votre compte Simplio3D, afin qu’il lise le projet réel (les blocs d’options, les règles conditionnelles, la formule de tarification, les noms des pièces dans le modèle 3D) et s’appuie sur ces données pour répondre.

Ce guide explique ce qu’est un connecteur MCP, ce qu’un agent connecté peut et ne peut pas faire dans Simplio3D, comment les modifications risquées restent sous votre contrôle, et comment connecter Claude, Cursor ou VS Code.

Que sont les connecteurs MCP ?

Le Model Context Protocol (MCP) est une norme ouverte permettant de connecter des assistants IA à des outils et données externes. Il comporte deux volets. Un client MCP est l’outil d’IA que vous utilisez déjà, comme Claude, Cursor ou VS Code. Un serveur MCP est le système auquel l’assistant se connecte : il publie une liste d’outils, chacun accompagné d’une description et d’un schéma, que l’assistant peut appeler lorsqu’une question le nécessite.

Un connecteur crée le lien entre les deux : l’adresse du serveur, ainsi qu’un identifiant qui indique qui se connecte et à quoi cette personne peut accéder. Claude l’appelle un connecteur personnalisé ; d’autres clients parlent d’une entrée de serveur MCP. Pour Simplio3D, il s’agit toujours des deux éléments suivants :

  • Le point de terminaison : https://app.simplio3d.ai/mcp
  • Un identifiant : une connexion OAuth que vous approuvez sur un écran de consentement Simplio3D, ou un jeton de connexion que vous créez dans Tableau de bord → Intégrations → Connexions IA.

Une fois connecté, l’assistant voit les outils de Simplio3D parmi les siens et décide quand les appeler en fonction de votre demande.

Schéma : Claude, Cursor et VS Code se connectent au serveur MCP Simplio3D à l’adresse app.simplio3d.ai/mcp. Chaque appel passe par quatre vérifications (compte vérifié, forfait ou essai actif, rôle dans l’espace de travail, périmètres de connexion) avant d’accéder à 123 outils (52 en lecture, 68 en écriture, 3 de workflow) et aux projets d’un espace de travail. Les modifications à haut risque deviennent une proposition qui attend dans « Modifications IA en attente » jusqu’à ce que vous cliquiez sur Appliquer, puis elles sont instantanées.
Chaque client IA passe par le même point de terminaison et les mêmes quatre vérifications. Une modification à haut risque reste à l’état de proposition jusqu’à ce que vous l’appliquiez dans le tableau de bord.

Ce qu’un agent connecté peut faire dans Simplio3D

Le serveur MCP Simplio3D met à disposition 123 outils : 52 en lecture, 68 en écriture dans le cadre d’un modèle d’écriture contrôlée, et 3 pour exécuter des workflows d’agent. Ensemble, ils couvrent les projets, l’inspection des modèles 3D, les matériaux, les blocs d’options, la logique conditionnelle, la tarification, les formulaires, les demandes de devis et les connexions aux boutiques. En pratique, un agent connecté peut :

  • Lire un projet réel : ses modèles, blocs d’options et variantes, matériaux, règles conditionnelles, blocs et formules de tarification, ainsi que les champs de formulaire.
  • Examiner le modèle 3D : les noms et la hiérarchie des pièces, afin de vérifier que chaque option cible toujours un maillage existant.
  • Auditer un configurateur : cibles de pièces manquantes, matériaux supprimés, règles qui ne peuvent jamais se déclencher et variantes sans prix.
  • Expliquer la logique et calculer le prix d’une configuration : quelle règle masque une option et quel est le coût d’un ensemble donné de sélections, calculé sur le serveur.
  • Créer et modifier : créer des projets, blocs d’options, variantes, matériaux, règles conditionnelles et champs de formulaire, et organiser les éléments déjà en place.
  • Exécuter des workflows d’agent : lancer une tâche en plusieurs étapes, comme un audit de projet ou une réparation sécurisée, répondre à ses questions et suivre son avancement. Les workflows s’interrompent pour obtenir votre approbation et ne publient jamais.
  • Résumer les prospects : lire les demandes de devis reçues et voir ce que chaque client a configuré.
  • Répondre aux questions sur le produit à partir de la documentation : rechercher dans la documentation officielle de Simplio3D et citer la page concernée, plutôt que de répondre de mémoire.

Chaque outil, avec les autorisations dont il a besoin et l’indication de son accès en lecture ou en écriture, est répertorié dans la référence des outils MCP.

Ce qu’il ne peut pas faire

Certaines actions restent impossibles, quelles que soient les autorisations que vous accordez. Un agent connecté ne peut pas publier un projet, créer un lien de partage ni modifier les paramètres d’intégration. Il ne peut ni téléverser de fichiers ni supprimer un projet. Il ne peut pas connecter ou déconnecter une boutique Shopify ou WooCommerce, ni lire les identifiants de cette boutique. Il n’obtient jamais non plus d’accès à la base de données, aux clés API, aux secrets de webhook ou aux mots de passe des vues partagées : les outils renvoient des synthèses sélectionnées, et non des enregistrements bruts.

Portées : n’accordez à chaque connexion que ce dont elle a besoin

Une connexion ne peut voir et appeler que les outils couverts par ses portées. Commencez en lecture seule, puis ajoutez une portée d’écriture à la fois, selon les besoins de la tâche.

Portées de connexion MCP de Simplio3D
PortéeCe qu’elle autoriseAccordez-la lorsque l’agent doit
Espace de travail (lecture seule)Résumé de votre espace de travail, de votre forfait et de votre utilisationIndique votre forfait et la part que vous en utilisez
Projets (lecture / écriture)Lister et consulter les projets ; créer, renommer, dupliquer et modifier les paramètres sûrsGénérer des rapports sur vos projets ou en configurer de nouveaux
Ressources (lecture)Lister les ressources et consulter les noms des pièces et la hiérarchie d’un modèleParler des maillages présents dans vos modèles
Matériaux (lecture / écriture)Consultez la bibliothèque ; créez et modifiez des matériaux, puis attribuez-les à des variantesCréez ou organisez votre bibliothèque de matériaux
Configurateur (lecture / écriture)Consultez et créez des blocs d’options, des variantes et des règles conditionnellesCréez ou réorganisez les options proposées aux acheteurs
Tarification (lecture / écriture)Consultez les prix et les formules ; proposez des modifications de tarification, de SKU et de formulesGérez la tarification. Chaque modification de tarif est une proposition que vous devez approuver.
Formulaires (lecture / écriture)Consultez et créez des champs de formulaire de devis et de paiementCréez ou ajustez votre formulaire de prospects
Devis (lecture)Demandes de devis soumises, y compris les informations clientRésumez les prospects entrants. Il s’agit de données clients : accordez cet accès de manière réfléchie.
Commerce (lecture / écriture)Indique si une boutique est connectée, quels sont ses produits et propose des options pour lier un produit ou définir le mode de paiementAssociez un projet à un produit de la boutique. Cela n’accorde jamais les identifiants de la boutique.
Flux de travail (lecture / écriture)Suivez les flux de travail de l’agent ; lancez-les, répondez à leurs questions, mettez-les en pause ou annulez-lesExécutez ou surveillez une tâche plus longue, telle qu’un audit de projet
Documentation (lecture)La documentation officielle de Simplio3D, sans données d’espace de travailRépondez aux questions sur le produit en citant une source

Plusieurs petites connexions sont plus sûres qu’une seule capable de tout faire. Attribuez à l’assistant qui vérifie la tarification sa propre connexion avec des portées de lecture et d’écriture pour la tarification, et une autre à celui qui crée les projets. Révoquer l’une n’interrompt alors jamais l’autre.

Comment les modifications restent sous votre contrôle

Permettre à une IA de modifier un configurateur actif ne fonctionne que si une mauvaise modification ne peut pas atteindre vos clients. Simplio3D traite chaque écriture en trois étapes : proposer, confirmer, capturer un instantané.

  • Les modifications à faible risque sont appliquées sans attendre votre intervention, comme renommer un bloc ou ajouter une variante.
  • Les modifications à haut risque ne produisent qu’une proposition : tarification, SKU, suppressions, modifications en masse, matériaux partagés et liens vers des produits de boutique. La proposition reste en attente dans Modifications IA en attente, sur la page Connexions IA, et répertorie toutes les modifications qu’elle effectuerait. Vous cliquez sur Appliquer ou vous la refusez. Aucun agent ne peut approuver sa propre proposition, et cette règle ne peut pas être désactivée.
  • Chaque modification appliquée fait l’objet d’un instantané, afin de pouvoir être annulée, puis revalidée et enregistrée dans un journal d’audit.

Les propositions ont une durée de validité limitée. Si le projet a changé depuis qu’un agent a proposé une modification, l’ancienne proposition est refusée plutôt que d’écraser vos modifications plus récentes ; demandez à nouveau à l’agent.

En outre, un appel d’outil ne réussit que si quatre vérifications sont toutes validées : l’adresse e-mail du compte est vérifiée, le forfait du propriétaire de l’espace de travail est actif, le rôle du siège autorise l’action et la connexion détient la portée requise. La restriction la plus stricte prévaut. Par exemple, un siège Viewer ne peut jamais effectuer ni confirmer une modification, quelles que soient les portées de sa connexion.

Comment configurer les connecteurs MCP pour Simplio3D

La méthode par jeton fonctionne dans tous les clients. Vous utilisez Claude ? La méthode OAuth ci-dessous évite l’utilisation d’un jeton.

  1. Ouvrir les connexions IA

    Dans Simplio3D, accédez à Tableau de bord → Intégrations → Connexions IA et copiez le point de terminaison MCP affiché en haut de la page.

  2. Créez une connexion par outil

    Cliquez sur Créer une connexion et donnez-lui le nom de l’outil qui l’utilisera, par exemple « Claude Desktop » ou « Cursor ». Une connexion par outil permet d’identifier facilement celle à révoquer ultérieurement.

  3. Choisissez l’espace de travail

    Une connexion est définitivement associée à l’espace de travail que vous sélectionnez ici. Pour travailler avec deux espaces de travail, créez une connexion depuis chacun d’eux.

  4. Cochez uniquement les autorisations dont il a besoin

    Commencez en lecture seule et ajoutez les autorisations d’écriture une par une. Accordez Quotes uniquement lorsque l’agent doit voir les informations client.

  5. Copiez le jeton et ajoutez-le à votre outil

    Le jeton commence par smcp_ et n’est affiché qu’une seule fois, jamais plus. Collez-le dans votre outil d’IA avec le point de terminaison, comme indiqué dans le tableau ci-dessous. Traitez-le comme un mot de passe : il est valable 90 jours et vous pouvez le renouveler ou le révoquer à tout moment.

  6. Vérifiez la connexion

    Posez une question à laquelle seul votre compte peut répondre : « Répertorie mes projets Simplio3D et indique-moi lesquels sont publiés. » Si la réponse mentionne vos vrais projets, le connecteur fonctionne.

Connecter Claude sans jeton. Simplio3D est répertorié dans le répertoire des connecteurs de Claude. Dans Claude, ouvrez Personnaliser → Connecteurs, recherchez Simplio3D et cliquez sur Connecter, ou choisissez Ajouter un connecteur personnalisé et collez https://app.simplio3d.ai/mcp. Dans les deux cas, Claude ouvre la page de connexion de Simplio3D ainsi qu’un écran de consentement où vous choisissez l’espace de travail et les autorisations, l’accès en lecture seule étant déjà coché. La connexion apparaît ensuite dans la même liste des connexions IA, marquée Application OAuth ; vous pouvez y renouveler ou révoquer l’accès comme pour toute autre connexion.

Emplacement où chaque client d’IA configure le connecteur Simplio3D
Client IAOù l’ajouterÉléments à ajouter
Claude (OAuth)Personnaliser → Connecteurs : recherchez Simplio3D ou Ajouter un connecteur personnaliséAucune entrée de l’annuaire : l’URL de point de terminaison d’un connecteur personnalisé. Aucun jeton : vous approuvez plutôt l’écran de consentement Simplio3D.
Claude DesktopParamètres → Développeur → Modifier la configuration (claude_desktop_config.json)Un serveur « simplio3d » de type http, avec l’URL du point de terminaison et un en-tête Authorization: Bearer smcp_…
Claude CodeVotre terminalclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json, ou .cursor/mcp.json pour un projetUn serveur « simplio3d » avec l’URL du point de terminaison et l’en-tête Authorization
VS Code (GitHub Copilot).vscode/mcp.jsonUn serveur HTTP avec l’URL du point de terminaison, récupérant le jeton via une invite de mot de passe plutôt que de le stocker dans le fichier
ChatGPT et CodexChatGPT → Plugins : recherchez Simplio3D, puis installez le plugin et connectez Simplio3DRien : le plugin intègre le connecteur. Aucun jeton requis : connectez-vous à Simplio3D et autorisez l’accès

Premiers prompts à essayer

Indiquez le nom du projet et demandez des preuves : « quelle règle le masque ? » donnera une réponse plus précise que « pourquoi est-il masqué ? ».

Exemples d’invites pour un connecteur MCP Simplio3D
DemanderCe que l’agent vérifieCe que vous obtenez en retour
« Auditez mon configurateur Oak Dining Table et répertoriez tout ce qui ne fonctionne pas. »Trouve le projet, puis le valide, y compris les noms des pièces dans le modèle 3DConstats par niveau de gravité : cibles de pièces manquantes, matériaux supprimés, règles qui ne peuvent jamais se déclencher, variantes sans prix
« Pourquoi la finition Noyer est-elle masquée lorsque je choisis le petit plateau ? »Les blocs d’options et les règles conditionnelles, puis les évalueLa règle qui la masque et la condition correspondante
« Chaque variante de ce configurateur a-t-elle un prix ? »Les blocs de tarification, puis un contrôle de validationLes variantes sans prix par nom, avec le bloc de tarification auquel chacune appartient
« Quelles options ciblent des pièces qui n’existent plus dans le modèle ? »Les cibles que vous avez créées à partir de la géométrie réelleLes cibles obsolètes, répertoriées
« Quel serait le prix du chêne en grande taille ? »Les blocs d’options, puis un calcul du prix côté serveurLe prix de base, chaque ajustement, la taxe et le total dans la devise du projet
« Résumez les demandes de devis que nous avons reçues cette semaine. »Les demandes de devis et chaque configurationLes coordonnées, la configuration de chaque client et le prix au moment concerné

Limites à connaître avant de vous y fier

  • Les agents lisent les données enregistrées. L’éditeur enregistre automatiquement quelques secondes après chaque modification ; une modification effectuée il y a quelques instants peut donc ne pas être encore visible. Enregistrez, puis posez de nouveau la question.
  • Les prix et la logique côté serveur comportent des limites. Le calcul des prix et l’évaluation des règles couvrent les cas courants, mais pas tous les comportements du configurateur publié, comme la tarification par unité des champs Number Input. Chaque résultat indique ce qui n’a pas été évalué, et l’aperçu ainsi que la vue partagée publiée restent la référence finale.
  • Limites de débit. Chaque connexion peut effectuer 300 requêtes toutes les cinq minutes. Un espace de travail accepte 30 modifications appliquées par l’IA toutes les dix minutes, réparties entre tous les agents connectés et l’assistant intégré.
  • Les réponses volumineuses sont tronquées et l’indiquent. Un résultat dépassant environ 60 Ko est résumé et marqué comme tronqué, afin que l’agent ne puisse pas confondre une partie d’une liste avec son intégralité.
  • Ce que l’agent lit est transmis à votre fournisseur d’IA. Les demandes de devis incluent les noms et coordonnées des clients ; accordez donc la portée Quotes en connaissance de cause.
  • Les jetons expirent après 90 jours. Faites-en immédiatement pivoter un s’il a été collé dans une conversation, un ticket d’assistance ou un partage d’écran. La rotation désactive aussitôt l’ancien jeton.

Une couche d’outils unique derrière chaque interface d’IA

Le serveur MCP n’est pas un produit distinct ajouté après coup. L’assistant d’IA intégré de Simplio3D, le point de terminaison d’outils REST authentifié pour vos propres automatisations et les clients MCP externes appellent tous le même registre d’outils, avec la même authentification, les mêmes autorisations et le même journal d’audit. Une capacité se comporte de la même manière, quel que soit l’endroit depuis lequel vous l’appelez, et une portée ou un rôle qui la bloque à un endroit la bloque partout.

C’est aussi ce qui distingue MCP de REST API et SDK. SDK est un client typé pour votre propre code, authentifié avec une clé API, et cette clé n’est jamais acceptée sur le point de terminaison MCP. MCP est destiné aux agents d’IA, authentifiés via une connexion dont vous définissez la portée pour chaque outil.

Questions sur les connecteurs MCP

Tous : Starter, Pro et Enterprise, ainsi que l’essai Pro de 30 jours dont bénéficie chaque compte au départ. Les connecteurs MCP sont inclus dans Starter depuis septembre 2026. Avec Starter, un agent connecté respecte les mêmes règles de forfait que le tableau de bord : il ne peut donc pas créer de projets modulaires ni dupliquer un projet.

Vous commencez par créer le configurateur ?

Comment un projet passe d’un modèle 3D aux options, à la logique conditionnelle et à la tarification, avant même qu’un agent ne le consulte.

Vous souhaitez que l’agent vérifie vos prix ?

Les blocs de prix et l’éditeur de formules qu’un agent connecté lit et utilise pour effectuer ses calculs.

Vous voulez que l’IA crée également le configurateur ?

Générez avec l’IA les options, les règles, le prix et le formulaire à partir d’une description de produit, dans Simplio3D.

Vous utilisez ChatGPT ?

Le plugin Simplio3D du répertoire Plugins de ChatGPT établit cette connexion pour vous, avec une connexion guidée plutôt qu’un jeton.

Sur le blog

Guides, tutoriels et actualités de l'équipe Simplio3D.

Construisez, déployez et développez le commerce 3D.

Possédez un configurateur de produit 3D pour stimuler les ventes et générer des propositions directement depuis votre site web.

Articles connexes