Model Context Protocol

Votre catalogue 3D entre dans la conversation.

Le connecteur Vizbl permet à Claude de convertir des fichiers 3D et CAO, d’importer des modèles dans votre compte Vizbl, de suivre la chaîne de conversion et de produire les liens AR, QR codes et boutons de fiche produit qui les mettent devant vos clients, sans quitter la conversation. Joignez un fichier, décrivez ce que vous voulez, Claude s’occupe du reste.

Connecter le serveur Voir les outils

Votre client IA
Vous joignez un modèle et demandez un import

OAuth 2.0 · votre accord, vos autorisations

mcp.vizbl.com
Connecteur sans état – rien n’est stocké ici

Clé API facultative · votre compte

Vizbl Developer API
Chaîne de conversion et votre catalogue 3D

Démarrage rapide

Trois gestes, environ une minute.

Ajoutez l’URL ci-dessous à votre client comme connecteur personnalisé.
Validez l’écran de consentement. Le champ de la clé API est facultatif : laissez-le vide pour démarrer.
Joignez un fichier 3D ou CAO et dites « convertis-le en USDZ ». Ajoutez une clé plus tard pour importer dans votre bibliothèque.

https://mcp.vizbl.com/mcp

C’est tout. Le reste de la page sert de référence : revenez-y quand vous en aurez besoin.

Connexion en quatre étapes

Vizbl est un serveur MCP distant : rien à installer, rien à exécuter en local. Tout client MCP compatible avec les serveurs distants et OAuth peut s’y connecter.

Ajoutez le serveur à votre client

Dans Claude, ajoutez un connecteur personnalisé avec cette URL :
```
https://mcp.vizbl.com/mcp
```
Dans Claude Code, ajoutez-le depuis le terminal :
```
claude mcp add --transport http vizbl https://mcp.vizbl.com/mcp
```
Transport : Streamable HTTP. L’enregistrement du client est dynamique – aucune application à déclarer au préalable chez Vizbl.
Autorisez la connexion

Votre client ouvre l’écran de consentement Vizbl. Vérifiez les accès demandés et validez. Le champ de la clé API est facultatif : laissez-le vide pour vous connecter sans compte Vizbl.
Ajoutez une clé API secrète pour votre bibliothèque

Neuf des douze outils ne nécessitent aucun compte Vizbl. Pour aussi importer, téléverser et supprimer des modèles, créez dans votre compte Vizbl une clé Developer API de type secrète – elle commence par sk_live_ et ne s’affiche qu’une fois, à la création – puis collez-la sur l’écran de consentement. La clé est scellée dans les jetons chiffrés délivrés à ce client et n’est jamais stockée sur nos serveurs. Reconnectez-vous à tout moment pour l’ajouter ou la changer.
Commencez à travailler

Joignez un fichier 3D ou CAO et demandez à Claude de le convertir ou – avec une clé – de l’importer dans votre bibliothèque. Les jetons d’accès durent 60 minutes et se renouvellent silencieusement pendant 90 jours ; ensuite, une nouvelle validation suffit.

Outils

Lecture et écriture sont des outils distincts. Les outils en lecture seule s’exécutent sans confirmation à chaque appel ; l’outil destructif demande toujours la vôtre.

Outil	Accès	Rôle
`get_guide` Obtenir le guide Vizbl	Lecture seule	Renvoie le guide officiel Vizbl sur un sujet : démarrage, installation, domaines, jetons, types d’essayage, dimensions d’impression, génération 3D, convertisseur, scènes et dépannage. Claude le consulte avant d’expliquer le fonctionnement de Vizbl.
`estimate_costs` Estimer le coût en jetons	Lecture seule	Traduit le trafic et la taille du catalogue en budget mensuel de jetons, toujours sous forme de fourchette avec les hypothèses énoncées. Uniquement des jetons : les prix Vizbl s’affichent sur la page de paiement.
`convert_3d_model` Convertir un modèle 3D	Écriture	Convertit et optimise un fichier 3D ou CAO joint à la conversation en GLB, USDZ ou FBX. Accepte 14 formats source et renvoie l’identifiant de la tâche de conversion.
`get_job_status` Obtenir l’état de la tâche	Lecture seule	Renvoie l’état d’une opération longue – conversion ou import – avec son étape, ses avertissements, son erreur et, une fois terminée, son résultat. Peut attendre pendant une durée bornée au lieu d’interroger en boucle.
`create_public_upload_url` Héberger un fichier	Écriture	Héberge un modèle ou une image locale sur l’espace de dépôt Vizbl et renvoie une URL https publique. Nécessaire partout où un outil demande une URL — la conversion, ou l’image d’un bouton Wall Art — et fonctionne sans compte Vizbl.
`create_upload_url` Créer une URL de téléversement	Écriture	Crée une session de téléversement signée pour envoyer un fichier de modèle depuis votre appareil. Renvoie la cible du téléversement et l’identifiant utilisé par l’outil d’import.
`upload_model` Téléverser un modèle 3D	Écriture	Publie un modèle 3D dans Vizbl à partir d’un fichier joint à la conversation ou d’un identifiant de téléversement. Prend en charge les modèles multi-variantes et, en option, nom, description, étiquettes, catégorie et mécanique de placement. Renvoie l’identifiant de la tâche d’import.
`get_ar_link` Obtenir le lien AR	Lecture seule	Construit, à partir de l’Object ID, le lien public qui ouvre un objet publié en AR sur un téléphone.
`get_qr` Obtenir le QR code	Lecture seule	Produit le QR code du lien AR en SVG et PNG, pour l’impression, l’emballage et les fiches produit. Généré sur nos serveurs ; le lien n’est jamais transmis à un service QR tiers.
`get_widget_snippet` Obtenir le code du widget	Lecture seule	Construit le HTML du bouton AR de la fiche produit : le script d’amorçage avec son appel d’initialisation et le bouton portant les identifiants de l’objet. Couvre les variantes App Clip, AR native et visionneuse 3D.
`generate_wallart_buttons` Générer les boutons Wall Art	Lecture seule	Génère un lot de boutons d’essayage Wall Art à partir d’une liste de produits et vérifie les dimensions physiques d’impression, en signalant les valeurs qui ressemblent à une résolution d’image.
`delete_model` Supprimer un modèle Vizbl	Destructif	Supprime un objet Vizbl existant à partir de son Object ID public. Claude demande toujours confirmation avant de l’exécuter.

Les outils affichés dépendent des autorisations accordées lors de la connexion. Une connexion approuvée en lecture seule ne listera ni l’outil d’import ni celui de suppression.

Exemples d’instructions

Des demandes en langage naturel : Claude choisit les outils. Elles fonctionnent telles quelles.

Importe ce chair.glb dans Vizbl, nomme-le « Chaise en chêne », étiquette-le comme mobilier et donne-moi le lien quand c’est prêt.

Claude appelle upload_model avec le fichier joint, puis get_job_status jusqu’à la fin de la conversion, et répond avec l’URL publique de l’objet.

Où en est l’import Vizbl que j’ai lancé tout à l’heure ?

Claude appelle get_job_status avec l’identifiant de la tâche et indique l’étape en cours, ou l’erreur si l’import a échoué.

Voici trois fichiers de modèles pour la collection d’été – importe-les tous dans Vizbl comme objets muraux et résume les résultats.

Claude appelle upload_model pour chaque fichier avec une nomenclature commune et renvoie un tableau des identifiants et de leurs statuts.

Voici un fichier STEP de notre bureau d’études – transforme-le en GLB léger pour la fiche produit.

Claude appelle convert_3d_model, enchaîne avec get_job_status et propose d’importer le résultat dans Vizbl.

Nous avons 400 tapis et environ 60 000 visiteurs par mois – quel budget en jetons Vizbl prévoir ?

Claude appelle estimate_costs et répond par une fourchette, les hypothèses retenues et un forfait conseillé – en jetons, jamais en devise.

Donne-moi le bouton AR et un QR code pour l’objet a1b2c3d4, pour la fiche produit et l’emballage.

Claude appelle get_widget_snippet et get_qr, et vous rappelle d’autoriser le domaine de votre boutique dans Vizbl.

Supprime l’objet Vizbl dont le tinuuid est a1b2c3d4 – nous l’avons importé deux fois.

Claude vous demande confirmation, puis appelle delete_model pour ce tinuuid.

À quoi s’attendre

Limites pratiques du connecteur hébergé.

Fichiers et formats

Formats d’import: glb, gltf, obj, usdz, fbx
Le convertisseur accepte: dae, fbx, glb, gltf, iges, igs, obj, ply, step, stp, stl, usd, usdc, usdz
Taille maximale par fichier: 200 Mo par variante
Source: Fichiers joints à la conversation
Multivariante: Prise en charge ; la première variante fait référence

Délais et sessions

Attente par appel: jusqu’à 90 secondes
Jeton d’accès: 60 minutes
Jeton de rafraîchissement: 90 jours
État du serveur: Sans état – aucune session conservée

Prérequis

Rien n’est requis pour commencer : les outils de référence – guides, estimations de coût, conversion, liens et extraits – ne nécessitent aucun espace de travail Vizbl. Un compte Vizbl avec accès à la Developer API et une clé secrète ajoute les outils d’import, de téléversement et de suppression ; les imports consomment le quota de conversion habituel de votre compte. Le connecteur ne crée pas de compte, ne modifie pas la facturation et ne génère ni images, ni vidéo, ni audio avec des modèles d’IA.

Traitement de vos données

La version courte – le texte complet figure dans la politique de confidentialité.

Votre clé API

Chiffrée dans les jetons OAuth conservés par votre client. Le serveur n’en garde aucune copie et ne tient aucune base de connexions.

Vos fichiers de modèles

Téléchargés en mémoire, transmis à la Vizbl Developer API sous votre compte, puis supprimés. Ils résident dans votre compte Vizbl, comme s’ils avaient été envoyés depuis l’application.

Votre conversation

Seuls les arguments d’un appel d’outil parviennent au serveur. Nous ne demandons jamais l’historique de conversation, la mémoire ni des fichiers sans rapport avec un import.

Assistance

Questions, signalements de bugs et divulgations de sécurité.

Nous contacter

Écrivez à [email protected]. Pour signaler un import en échec, indiquez l’identifiant de la tâche : c’est le moyen le plus rapide pour nous de retracer ce qui s’est passé.

État de service de ce point d’accès : https://mcp.vizbl.com/health

Également chez Vizbl

La même Developer API est accessible directement et via le SDK @vizbl/node, qui embarque un serveur MCP local pour les clients de bureau. Voir vizbl.com.