Aller au contenu
ByCommute · DocumentationOuvrir le configurateur ↗
ChatGPT · MCP · API

Concevoir un abri vélo en conversation

Décrivez votre besoin. Une IA connectée au configurateur peut poser les questions utiles, essayer des implantations, appliquer vos choix et produire les fichiers de votre projet.

Plugin dans l'annuaire ChatGPT

La candidature « ByCommute Configurateur » est en préparation ; le plugin n'est pas encore publié dans l'annuaire. La connexion dédiée aux sessions invitées utilise https://configurateur.bycommute.com/api/public/v1/chatgpt/mcp. Une autorisation « Continuer en invité » connecte votre IA sans inscription. Elle conserve les droits des projets côté serveur, sans demander de compte ByCommute ni transmettre de jeton privé au modèle.

Cette connexion permet de créer, simuler et modifier les projets de sa propre session, estimer leur prix et préparer les fichiers. L'outil show_project affiche le résumé du projet dans une carte compatible MCP Apps, avec estimation HT, vue 3D interactive et fichiers à préparer sur demande. Les droits de session expirent après huit heures d'inactivité ou vingt-quatre heures au total et ne survivent pas à un redémarrage. Le lien affiché dans la carte permet alors de reprendre dans le configurateur.

Assistance · Données et confidentialité · Conditions d'utilisation

Connecter ChatGPT

Ajoutez un serveur MCP distant dans les réglages de ChatGPT, avec l'URL ci-dessous, puis autorisez la connexion OAuth en choisissant « Continuer en invité ». Autorisez ensuite son utilisation dans la conversation. Cette fonction dépend de votre compte et des règles de votre organisation ; les intitulés des réglages peuvent évoluer.

https://configurateur.bycommute.com/api/public/v1/chatgpt/mcp

Aucun plugin local ni accès au VPS n'est nécessaire. La découverte de cette page sur le Web ne suffit pas à connecter un outil : vous devez autoriser la connexion dans votre IA. Consultez les instructions de connexion de ChatGPT.

Pour une autre IA compatible, ajoutez la même URL comme serveur MCP Streamable HTTP. Le serveur fournit les outils et un guide de cadrage.

Un exemple de conversation

Je prépare un abri pour 20 vélos, dont deux cargos. J'ai au maximum 7 mètres sur 4 mètres. Pose-moi les questions utiles sur les accès, les parois et le sol. Propose des aménagements réalisables, puis laisse-moi choisir avant d'enregistrer. À la fin, donne-moi le lien du projet, son modèle 3D et une image JPEG.

L'IA doit d'abord clarifier les contraintes et lire l'offre actuelle. Si 20 places ne tiennent pas, elle doit vous montrer la capacité calculée et proposer un compromis. Elle doit demander votre choix avant de remplacer un bardage ou supprimer un aménagement.

Consultez aussi la notice d'utilisation et les dimensions du catalogue.

Outils et déroulement

  1. get_manifest : choix publics, références et questions de cadrage.
  2. create_project : configuration initiale et révision ; les droits restent côté serveur pour la connexion ChatGPT.
  3. show_project : afficher les dimensions, la capacité et les avertissements. La carte permet de demander le prix HT, manipuler l'aperçu 3D, préparer les fichiers GLB/PNG/JPEG et ouvrir le configurateur. L'affichage seul ne lance aucun rendu.
  4. read_project : état, segments des parois, capacité et avertissements.
  5. simulate_project : essais sans enregistrement. fill_interior accepte une capacité cible avec mode: "family" et une familyKey du manifeste ; plan_interior propose un plan et des alternatives.
  6. update_project : appliquer le choix avec expectedRevision. Un lot de commandes rejeté n'enregistre rien.
  7. get_price : estimation commerciale en euros HT et périmètre inclus, exclu ou en attente.
  8. start_export, puis get_export : attendre le statut ready et télécharger le fichier réellement produit.

Les dimensions et les positions sont en millimètres. Les règles géométriques et de circulation restent obligatoires. Après un conflit 409, relisez le projet avant de réessayer.

Modèle 3D et images

Le MCP public produit un modèle GLB et des images PNG ou JPEG en perspective, de face, de dos, à gauche ou à droite. Les images sont rendues depuis la même scène que le configurateur. Le GLB permet de visualiser le modèle ; il ne constitue pas un fichier STEP industriel.

Les liens de téléchargement sont privés, valables 15 minutes et liés à une révision précise. Si le projet change, relancez l'export. Les autres formats disponibles dans l'interface sont détaillés dans Fichiers pour architectes.

API publique pour les développeurs et les autres IA

Une interface pour les intégrations qui gèrent elles-mêmes les droits est disponible en HTTP JSON à https://configurateur.bycommute.com/api/public/v1. Lisez le contrat OpenAPI pour connaître les champs exacts, les commandes et les erreurs ; le catalogue documentaire public décrit l'offre.

GET /api/public/v1/manifest
POST /api/public/v1/actions/create_project
{ "name": "Mon abri", "state": { ...choix du manifeste... } }

POST /api/public/v1/actions/simulate_project
{
  "projectId": "identifiant retourné à la création",
  "accessToken": "jeton privé retourné à la création",
  "expectedRevision": 1,
  "commands": [{ "type": "fill_interior", "mode": "family", "familyKey": "famille choisie dans supportFamilies", "requestedCapacity": 20 }]
}

L'exemple de création est un canevas : fournissez l'état complet décrit par OpenAPI, avec les références actuelles du manifeste. Les erreurs 400 indiquent une entrée invalide, 403 un accès refusé ou un choix non public, 409 une version modifiée, 422 une configuration invalide et 429 un quota dépassé. Respectez les délais de reprise.

Projets privés et accès de l'équipe

L'accès au catalogue public ne nécessite aucun mot de passe. Pour l'API HTTP, lire ou modifier un projet nécessite son jeton privé, créé pour ce projet, valable 30 jours par défaut. Une intégration API conserve ce jeton dans son stockage sécurisé, sans le transmettre au modèle. Le plugin ChatGPT le gère côté serveur. Transmettez le lien de reprise uniquement aux personnes concernées. Les liens en lecture seule restent en lecture seule.

Le serveur public n'expose ni coûts d'achat, ni administration, ni mode bureau d'étude. L'équipe ByCommute utilise un MCP interne distinct, distribué aux comptes actifs du VPS. Ajouter un paramètre debug ou engineeringMode au serveur public ne donne aucun privilège supplémentaire.

Cette API prend en charge les dimensions, les parois et portes, les supports, les équipements et les kits solaires proposés par son manifeste. Les habillages graphiques personnalisés et les autres fonctions absentes du contrat restent accessibles dans l'interface. Les études publiques sont limitées à 200 m² et 200 placements ; le service limite aussi les créations et les rendus simultanés. Les exports terminés restent disponibles après un redémarrage, jusqu'à leur expiration. Si un rendu en cours est interrompu, relancez-le. Les fichiers périmés sont supprimés et le stockage temporaire est limité ; un service occupé renvoie un délai avant de réessayer.