Skip to content

Connecteur MCP

Vivlab expose un connecteur MCP (Model Context Protocol) qui permet à un assistant IA compatible, comme Claude, d'agir directement sur votre boutique : retrouver un produit, rédiger une fiche, créer un bon de réduction, ajuster un tarif de livraison ou faire le point sur vos commandes, le tout depuis une simple conversation. L'assistant ne reçoit jamais votre mot de passe : il passe par une autorisation que vous accordez vous-même et que vous pouvez retirer à tout moment.

Venez ici lorsque vous voulez confier des tâches répétitives à une IA (mettre à jour une série de prix, traduire des descriptions, préparer un lot d'articles de blog), interroger votre catalogue en langage naturel, ou brancher votre propre outil sur les données de votre boutique. Tout ce que l'assistant fait reste limité à votre compte et reproduit ce que vous pourriez faire vous-même dans le tableau de bord.

Ce dont vous avez besoin

Une seule chose : un assistant ou un outil qui sait se connecter à un serveur MCP distant. C'est le cas de l'application Claude (ordinateur et web), de Claude Code, de Cursor et de la plupart des clients MCP récents. Vous aurez aussi besoin de vos identifiants Vivlab habituels pour valider l'autorisation.

Vous n'avez aucune clé ni aucun jeton à copier : la connexion se met en place toute seule à partir d'une seule adresse.

L'adresse de connexion

L'unique information à fournir à votre assistant est l'adresse du connecteur :

https://dashboard.vivlab.com/mcp

À partir de cette adresse, votre assistant découvre automatiquement comment s'authentifier et ouvre la page d'autorisation Vivlab dans votre navigateur. Vous n'avez rien d'autre à saisir.

Autoriser l'accès

La première fois que votre assistant se connecte, Vivlab vous demande votre accord :

  1. Renseignez l'adresse https://dashboard.vivlab.com/mcp dans votre assistant et lancez la connexion.
  2. Votre navigateur s'ouvre sur Vivlab. Connectez-vous à votre tableau de bord si ce n'est pas déjà fait.
  3. Une page d'autorisation indique le nom du connecteur et les accès qu'il demande. Vérifiez-les, puis cliquez sur Autoriser pour confirmer ou sur Annuler pour refuser.
  4. Vous revenez dans votre assistant : il est maintenant relié à votre boutique.

L'autorisation reste valable tant que vous ne la retirez pas. Votre assistant la renouvelle de lui-même, vous n'avez donc pas à repasser par cette étape à chaque conversation.

WARNING

Une fois connecté, l'assistant agit en votre nom et peut modifier votre boutique selon les accès accordés. N'autorisez que des outils en lesquels vous avez confiance, et relisez bien les actions qu'il vous propose avant de les valider.

Lecture seule ou modification

L'autorisation couvre deux niveaux d'accès distincts :

  • Consultation : l'assistant peut rechercher et lire votre catalogue (produits, pages, articles de blog, collections, codes promo, commandes), mais ne change rien.
  • Modification : l'assistant peut en plus créer, modifier et supprimer des éléments, et importer des images ou des fichiers.

La page d'autorisation affiche précisément les accès demandés avant que vous ne confirmiez. Si vous souhaitez une connexion sans risque pour relire ou analyser vos données, choisissez un assistant configuré en consultation seule ; pour lui laisser effectuer les changements, accordez la modification.

Configurer votre assistant

La marche à suivre dépend de l'outil que vous utilisez, mais l'adresse à fournir est toujours la même.

Claude (application et web)

Ouvrez les réglages de Claude, rubrique des connecteurs, puis ajoutez un connecteur personnalisé en collant l'adresse https://dashboard.vivlab.com/mcp. Claude ouvre alors la page d'autorisation Vivlab décrite plus haut. Une fois l'accès accordé, les actions Vivlab deviennent disponibles dans vos conversations.

ChatGPT

Vous pouvez activer les serveurs MCP sur ChatGPT si vous disposez d'un compte Pro, Plus, Business, Enterprise ou Education. Suivez les instructions fournies dans la documentation d'OpenAI. Utilisez les paramètres suivants lors de la configuration de votre connecteur personnalisé :

  • L'adresse du serveur est https://dashboard.vivlab.com/mcp.
  • Utilisez « OAuth » comme mécanisme de connexion.

ChatGPT ouvre alors la page d'autorisation Vivlab décrite plus haut.

Mistral (Vibe / Le Chat)

Dans Mistral Vibe (anciennement Le Chat), ouvrez les réglages, rubrique des connecteurs, puis ajoutez un connecteur personnalisé en renseignant un nom et l'adresse https://dashboard.vivlab.com/mcp. Le Chat ouvre alors la page d'autorisation Vivlab décrite plus haut. Une fois l'accès accordé, activez le connecteur Vivlab dans une conversation pour qu'il puisse agir sur votre boutique. L'ajout de connecteurs personnalisés peut nécessiter un forfait payant.

Claude Code

Dans un terminal, ajoutez le connecteur en une commande :

bash
claude mcp add --transport http vivlab https://dashboard.vivlab.com/mcp

Lancez ensuite Claude Code et tapez /mcp pour démarrer l'autorisation : votre navigateur s'ouvre sur Vivlab pour valider l'accès.

Cursor et autres clients

La plupart des clients MCP attendent un petit fichier de configuration. Déclarez le serveur Vivlab comme un connecteur distant :

json
{
  "mcpServers": {
    "vivlab": {
      "url": "https://dashboard.vivlab.com/mcp"
    }
  }
}

Au premier appel, le client ouvre la page d'autorisation Vivlab dans votre navigateur. Reportez-vous à la documentation de votre outil pour l'emplacement exact de ce fichier.

Ce que l'assistant peut gérer

Une fois connecté, l'assistant manipule les mêmes données que vous depuis le tableau de bord. Voici ce qu'il sait faire, domaine par domaine.

DomaineActions possibles
ProduitsRechercher, consulter, créer, modifier et supprimer un produit avec ses prix
CatégoriesLister, consulter, créer, modifier et supprimer une catégorie
Filtres à facettesLister, consulter, créer, modifier et supprimer un filtre
Bons de réductionRechercher, consulter, créer, modifier et supprimer un code promo
Tarifs de livraisonRechercher, consulter, créer, modifier et supprimer un tarif
PagesRechercher, consulter et modifier une page
BlogArticles, auteurs, rubriques et étiquettes : lister, consulter, créer, modifier et supprimer
CommandesRechercher, consulter et mettre à jour une commande
AbonnementsRechercher et consulter (lecture seule)
Images et fichiersImporter un visuel ou un fichier et récupérer son adresse pour l'utiliser sur une fiche

Les abonnements restent toujours en consultation. Toutes les actions de création, de modification et de suppression ne sont accessibles que si vous avez accordé l'accès en modification ; sinon, l'assistant se limite à la consultation.

Liste complète des outils

Chaque action que l'assistant peut déclencher correspond à un « outil » qu'il choisit selon votre demande. Le tableau ci-dessous les recense tous. La colonne Accès précise si l'outil relève de la Consultation (disponible dès la connexion) ou de la Modification (disponible seulement si vous avez accordé cet accès).

OutilDescriptionAccès
products_searchRechercher des produitsConsultation
products_getConsulter un produit et ses prixConsultation
products_createCréer un produit et ses prixModification
products_updateModifier un produit et ses prixModification
products_deleteSupprimer un produit et ses prixModification
collections_listLister les catégoriesConsultation
collections_getConsulter une catégorieConsultation
collections_createCréer une catégorieModification
collections_updateModifier une catégorieModification
collections_deleteSupprimer une catégorieModification
facets_listLister les filtres à facettesConsultation
facets_getConsulter un filtre à facettesConsultation
facets_createCréer un filtre à facettesModification
facets_updateModifier un filtre à facettesModification
facets_deleteSupprimer un filtre à facettesModification
coupons_searchRechercher des bons de réductionConsultation
coupons_getConsulter un bon de réductionConsultation
coupons_createCréer un bon de réductionModification
coupons_updateModifier un bon de réductionModification
coupons_deleteSupprimer un bon de réductionModification
shippings_searchRechercher des tarifs de livraisonConsultation
shippings_getConsulter un tarif de livraisonConsultation
shippings_createCréer un tarif de livraisonModification
shippings_updateModifier un tarif de livraisonModification
shippings_deleteSupprimer un tarif de livraisonModification
pages_searchRechercher des pagesConsultation
pages_getConsulter une pageConsultation
pages_updateModifier une pageModification
blog_articles_searchRechercher des articles de blogConsultation
blog_articles_getConsulter un article de blogConsultation
blog_articles_createCréer un article de blogModification
blog_articles_updateModifier un article de blogModification
blog_articles_deleteSupprimer un article de blogModification
blog_authors_listLister les auteurs du blogConsultation
blog_authors_getConsulter un auteur du blogConsultation
blog_authors_createCréer un auteur du blogModification
blog_authors_updateModifier un auteur du blogModification
blog_authors_deleteSupprimer un auteur du blogModification
blog_categories_listLister les rubriques du blogConsultation
blog_categories_getConsulter une rubrique du blogConsultation
blog_categories_createCréer une rubrique du blogModification
blog_categories_updateModifier une rubrique du blogModification
blog_categories_deleteSupprimer une rubrique du blogModification
blog_tags_listLister les étiquettes du blogConsultation
blog_tags_getConsulter une étiquette du blogConsultation
blog_tags_createCréer une étiquette du blogModification
blog_tags_updateModifier une étiquette du blogModification
blog_tags_deleteSupprimer une étiquette du blogModification
invoices_orders_searchRechercher des commandesConsultation
invoices_orders_getConsulter une commandeConsultation
invoices_orders_updateMettre à jour une commandeModification
invoices_subscriptions_searchRechercher des abonnementsConsultation
invoices_subscriptions_getConsulter un abonnementConsultation
images_uploadImporter une image et récupérer son adresseModification
files_uploadImporter un fichier et récupérer son adresseModification

Couper la connexion

Pour retirer l'accès, supprimez le connecteur Vivlab depuis les réglages de votre assistant : il ne pourra plus joindre votre boutique. L'autorisation finit également par expirer d'elle-même si elle n'est plus utilisée. Tant que la connexion existe, elle ne donne accès qu'à votre compte et à rien d'autre.

La documentation a été faite avec ❤️ par notre équipe interne.