Cette série de tutoriels présente l’utilisation du Model Context Protocol (MCP) pour connecter des agents d’intelligence artificielle aux APIs d’Autodesk® Platform Services (APS). L’objectif est de permettre aux développeurs d’interagir avec les données de Autodesk® Construction Cloud (ACC) en utilisant le langage naturel via des clients comme Claude Desktop, Cursor ou VS Code. La formation détaille la configuration de comptes de service sécurisés (SSA), l’authentification sans intervention humaine et la création de serveurs Node.js. Les vidéos démontrent également comment générer automatiquement des tableaux de bord et gérer les problèmes de chantier grâce à l’IA. Enfin, les sources encouragent la participation aux accélérateurs APS et au réseau de développeurs Autodesk® pour un soutien technique approfondi.
Cliquez en haut à droite de la vidéo pour afficher les suivantes 
Guide Technique : Intégration de l’IA avec Autodesk® Construction Cloud via le Model Context Protocol (MCP)
L’évolution des écosystèmes numériques dans le secteur de la construction exige une interopérabilité sans précédent entre les données de projet et l’intelligence artificielle. Ce guide détaille comment coupler la puissance d’Autodesk® Platform Services (APS) au standard Model Context Protocol (MCP) pour transformer la gestion des données Autodesk® Construction Cloud (ACC) en un système conversationnel et analytique intelligent, tout en garantissant une sécurité de niveau entreprise.
1. Fondations : Configuration d’APS et Sécurisation via Service Accounts (SSA)
L’automatisation des flux de travail IA nécessite une transition stratégique des méthodes d’authentification classiques dites « à trois jambes » (3-legged) vers les Secure Service Accounts (SSA). Contrairement à l’authentification traditionnelle qui impose une interaction manuelle pour chaque session, les SSA permettent une communication directe de serveur à serveur via une clé privée. Cette approche élimine la friction opérationnelle tout en renforçant la posture de sécurité, permettant à vos agents IA d’accéder aux données de manière autonome et sécurisée.
Analyse des Différenciateurs Clés
Les Secure Service Accounts redéfinissent la gestion des accès grâce à des avantages critiques :
- Absence d’interaction utilisateur (No User Interaction) : L’authentification repose sur un jeton JWT signé par une clé privée, idéal pour les processus automatisés.
- Gestion granulaire des permissions : Possibilité d’assigner des permissions spécifiques (Visualisation, Administration) au niveau d’un projet, d’un hub ou même d’un dossier spécifique.
- Traçabilité complète (Audit Trail) : Chaque action effectuée par l’IA est enregistrée sous l’identité propre du compte de service dans les logs d’audit d’ACC.
Protocole de Mise en Œuvre
La configuration repose sur des étapes techniques rigoureuses :
- Création de l’application APS : Dans le portail développeur, l’application doit impérativement être de type « Server-to-Server ». Notez qu’une migration vers les Developer Hubs est requise pour les applications créées après début décembre.
- Provisionnement dans ACC : L’ID client doit être enregistré par un administrateur de compte dans l’interface Account Admin via l’onglet Custom Integrations.
- Utilisation du SSA Manager : Pour simplifier la gestion, l’outil SSA Manager (par Adonagi) est recommandé pour générer la paire de clés, télécharger la clé privée et obtenir l’courriel du compte de service à inviter dans vos projets ACC.
- Configuration des Identifiants : Stockez le
Client ID,Client Secret,SSA ID,Key IDet le chemin vers la clé privée dans un fichier.env.
Cette infrastructure robuste est le prérequis indispensable pour l’hébergement d’un serveur MCP fonctionnel.
2. Architecture Technique du Serveur MCP (Node.js)
Le Model Context Protocol (MCP) agit comme un standard d’interface universel entre les assistants IA et les données ACC. En utilisant Node.js et les SDK officiels d’Autodesk®, nous garantissons une couche d’abstraction maintenable et performante.
Structure du Projet et Dépendances
Le serveur nécessite Node.js v16 ou supérieur. La pile technologique repose sur les modules officiels APS, assurant une compatibilité ascendante :
@modelcontextprotocol/sdk: Gère le protocole de transport client-serveur.@aps_sdk/autodesk-sdkmanager: Gère l’authentification et le cycle de vie des requêtes.@aps_sdk/data-management&@aps_sdk/issues: Fournissent un accès typé aux APIs ACC.zod: Utilisé pour la validation stricte des schémas d’entrée des outils IA.jsonwebtoken: Pour la génération des assertions JWT nécessaires aux SSA.
Logique de Transport et Configuration
Le serveur supporte deux modes de transport :
- Standard Input/Output (Stdio) : Recommandé pour un usage local (IDE, Desktop). C’est le mode par défaut pour connecter un agent IA localement.
- Server-Sent Events (SSE) : À privilégier pour un déploiement distant (ex: AWS Lambda) via HTTP.
Validation du Serveur
Avant toute intégration, validez la connectivité via le MCP Inspector avec la commande suivante : npx @modelcontextprotocol/inspector node server.js Cet outil permet de simuler l’IA et de vérifier que les outils sont correctement exposés et fonctionnels.
3. Développement et Enregistrement des Outils (MCP Tools)
Un « Outil » (Tool) MCP est une fonction API encapsulée avec une description en langage naturel. Cette sémantique permet à l’IA de sélectionner dynamiquement la fonction appropriée pour répondre à une question utilisateur (ex: « Quelles sont les réserves ouvertes sur le projet X ? »).
Catalogage des Capacités d’Extraction
Voici les outils fondamentaux pour une intégration ACC complète :
| Nom de l’Outil | Paramètres Requis | Fonctionnalité & Impact |
|---|---|---|
get-projects |
Aucun | Liste les hubs et projets accessibles par le compte SSA. |
get-folder-contents |
hubId, projectId |
Navigue dans l’arborescence. folderId est optionnel pour accéder aux Top Folders. |
get-issues |
projectId |
Récupère la liste exhaustive des problèmes (Issues) du projet. |
get-issue-types |
projectId |
Cartographie les IDs techniques des types d’issues vers des noms lisibles par l’IA. |
Gestion de la Normalisation des Données
Un défi technique majeur réside dans la manipulation des identifiants. L’API Data Management utilise des IDs préfixés par b. (ex: b.12345). Cependant, l’API Issues est spécifique à ACC et ne reconnaît pas ce préfixe. Le serveur MCP doit donc implémenter une logique de nettoyage : le préfixe b. doit être retiré lors des appels vers l’API Issues, mais conservé pour les opérations de fichiers.
Enregistrement Centralisé
Chaque outil est exporté via index.js dans le dossier /tools et initialisé dans server.js. Ce mécanisme permet au serveur de déclarer ses capacités dès la connexion, rendant les outils instantanément « découvrables » par le client IA.
4. Déploiement Multi-Client et Exploitation des Données
La flexibilité du MCP permet d’utiliser le même serveur sur plusieurs interfaces professionnelles, transformant radicalement la productivité des équipes.
Évaluation des Interfaces de Consommation
- VS Code (via GitHub Copilot) : Configurez le fichier
.vscode/mcp.jsonpour connecter l’IA directement à vos outils APS durant la phase de développement. - Cursor : Utilisez le fichier
.cursor/mcp.jsonpour permettre aux agents IA natifs de l’IDE d’analyser vos données ACC en temps réel. - Claude Desktop : L’interface la plus puissante pour l’analyse de données. Elle peut générer des dashboards dynamiques en React à partir des données extraites.
- Note technique Windows : Dans le fichier
config.jsonde Claude Desktop, utilisez des doubles barres obliques (\\) pour spécifier le chemin versserver.js(ex:"C:\\Users\\Nom\\project\\server.js").
- Note technique Windows : Dans le fichier
Perspectives et Ressources Avancées
Pour les architectes souhaitant pousser l’intégration plus loin, Autodesk® propose un écosystème de support complet :
- APS Accelerators : Sessions intensives de codage de 5 jours (Paris, Barcelone) avec support direct des ingénieurs Autodesk®.
- APS Tuesdays & Ask the Expert : Webinaires réguliers pour rester à jour sur les nouveautés API et poser vos questions techniques.
- Autodesk® Developer Network (ADN) : Programme premium offrant un support 1-sur-1, un accès anticipé aux bêtas et des licences de développement.
Conclusion : L’alliance entre Autodesk® Platform Services, la sécurité des SSA et la standardisation du Model Context Protocol marque le début d’une nouvelle ère. En exposant les données ACC à l’IA de manière structurée et sécurisée, vous transformez vos flux de travail statiques en moteurs de connaissances dynamiques et scalables.