Serveur MCP Autograph

Le MCP (Model Context Protocol) est une norme ouverte qui permet à un LLM (Large Language Model), également appelé application ou assistant IA, de se connecter à une application externe et d’utiliser les outils de cette dernière. Le serveur MCP d’Autograph utilise cette norme pour connecter votre application d’IA à Autograph, ce qui vous permet de décrire une tâche en langage naturel et de voir le résultat s’afficher dans Autograph.

L’application d’IA (par exemple, Claude Desktop ou ChatGPT Desktop) est appelée « client ». Le client communique avec le serveur MCP via un ensemble défini d’outils, tels que « créer une forme d’étoile » ou « ajouter un générateur de bruit », et Autograph exécute chaque appel d’outil sur votre projet ouvert.

Le serveur Autograph MCP est particulièrement performant pour les tâches bien définies et fastidieuses, telles que :

• Le renommage et la réorganisation d’une hiérarchie
• Traduire les noms des ressources fournies dans une autre langue

Ces tâches procédurales, souvent répétitives, sont exactement le genre de choses que vous confieriez volontiers à un assistant. Il vaut mieux confier des tâches comme celles-ci à un assistant IA qui les effectuera en quelques minutes plutôt que de passer un après-midi à faire le même travail manuellement. De même, la maintenance de routine ne devrait prendre qu’une minute ou deux. 

Non. Continuez à travailler comme vous le faites actuellement, et c'est vous qui décidez quand confier une tâche à quelqu'un d'autre. Le serveur Autograph MCP est désactivé par défaut et, lorsqu'il est activé, il ne prend en charge que les tâches spécifiques que vous définissez. Le brief, le style et toutes les décisions créatives vous appartiennent. 

Non. Le serveur MCP d'Autograph est intégré à Autograph et ne nécessite aucune installation distincte. Maxon prend en charge ce serveur pour la connexion entre Autograph et votre application d'IA.

Si vous avez configuré un serveur tiers dans la même application d'IA, désactivez-le lorsque vous utilisez le serveur intégré. Le modèle ne verra alors qu'un seul ensemble d'outils Autograph.

Non. Maxon ne facture pas le serveur MCP Autograph, qui est fourni avec Autograph, lequel est lui-même gratuit.

C'est vous qui fournissez l'application d'IA et le modèle avec lequel celle-ci communique. Si le modèle s'exécute dans le cloud, vous devez disposer d'un compte auprès du service concerné. Les éventuels frais associés relèvent de votre relation avec le service d’IA (par exemple, Anthropic ou OpenAI). Un modèle qui s’exécute sur votre propre ordinateur via une application telle que LM Studio ne nécessite pas de compte auprès d’un service d’IA.

À l'heure actuelle, Maxon prend officiellement en charge Claude Desktop et ChatGPT Desktop ; vous pouvez configurer l'une ou l'autre de ces applications directement depuis les préférences d'Autograph. D'autres applications d'IA compatibles avec MCP devraient également fonctionner, bien que Maxon ne les ait pas testées et ne les prenne pas officiellement en charge.

Chaque application d’IA dispose d’un fichier de paramètres répertoriant les serveurs auxquels elle peut se connecter. Pour les applications figurant dans la liste, Autograph ajoute automatiquement son entrée dans ce fichier à votre place. Pour toute autre application, sélectionnez « Autre » dans la liste des clients MCP, puis cliquez sur « Copier la configuration ». Autograph copie alors son entrée dans le presse-papiers afin que vous puissiez la coller dans votre application.

Oui. Les applications qui exécutent des modèles sur votre propre ordinateur, telles que LM Studio, fonctionnent également. Presque tous les modèles récents peuvent prendre en charge les tâches de base d'Autograph, et les modèles plus puissants donnent généralement de meilleurs résultats.

Remarque : un modèle local partage votre carte graphique avec Autograph. Un modèle qui occupe presque toute la mémoire graphique ne laisse plus de place pour le rendu, et un modèle lent peut mettre une minute à créer un cube.

Vous devez disposer de la version complète de l'application Autograph (version 2027.0 ou ultérieure) et du client de bureau de l'application d'IA de votre choix, tous deux installés sur le même ordinateur. Aucun autre élément n'est requis.

La clarté de votre requête détermine généralement la qualité du résultat.

• Le modèle. Les tâches de base, telles que le renommage, fonctionnent avec presque tous les modèles actuels. Ce n’est pas le cas des tâches qui nécessitent un raisonnement sur votre projet, et l’écart entre un petit modèle et un modèle puissant se creuse rapidement.
• Le niveau d’effort ou de raisonnement, si votre application propose un paramètre d’effort. Un niveau d’effort faible convient pour un changement de nom rapide. Attribuez davantage d’effort à la configuration d’un projet plus important. Cela dit, un réglage moyen est parfois préférable à un réglage élevé, car certains modèles ont tendance à trop réfléchir. Testez en conséquence.
• La requête. Décrivez les éléments du projet, la plage d’images, le moteur de rendu et la manière dont vous comptez modifier le résultat par la suite.

Remarque : Une démo que vous voyez en ligne montre rarement les invites utilisées ou le nombre de tentatives nécessaires pour obtenir le résultat. Une tâche réussie dès le premier essai est l’exception. Préparez-vous à un échange : votre deuxième ou troisième instruction devrait donner des résultats nettement meilleurs. 

La majeure partie de ce temps d'attente est due au traitement par l'IA, et non au fonctionnement d'Autograph. Autograph n'est occupé que pendant une fraction de seconde à chaque fois.

Pour mieux comprendre, une tâche est une boucle. Le modèle lit votre requête et sélectionne une commande. Autograph exécute cette commande, généralement en une fraction de seconde, puis renvoie le résultat. Le modèle lit le résultat, réfléchit, puis sélectionne la commande suivante. Cette boucle se répète souvent des dizaines de fois, et ce sont ces moments de réflexion qui prennent du temps. La barre d’état d’Autograph indique quelle commande est en cours d’exécution. Si une tâche traîne en longueur, consultez d’abord l’application d’IA.

Pendant que le serveur MCP traite une tâche, il est préférable de surveiller l’activité et la progression de l’IA, mais sans utiliser simultanément l’ordinateur et Autograph. Dans de nombreux cas, vos actions peuvent entrer en conflit avec les tâches du serveur MCP ou empêcher le client LLM de mener à bien ses processus. Il est préférable d’attendre que la tâche soit terminée ou de la mettre en pause si vous souhaitez prendre le contrôle.

Un modèle tire ses réponses de données d’entraînement pouvant être antérieures à la fonctionnalité, et certains modèles vont même jusqu’à affirmer qu’il n’existe aucun serveur MCP Autograph officiel. Considérez cette situation comme le MCP de Schrödinger. La prise en charge n’existe que lorsque l’IA l’observe.

Lorsqu’une application se connecte, le serveur indique au modèle où se trouvent le manuel Autograph et la documentation du SDK. Un modèle qui a pleinement confiance en ses données d’entraînement peut ignorer cette indication ; vous devrez donc peut-être demander directement à l’IA de se référer à la documentation à jour. Le modèle a besoin d’un accès à Internet via l’application d’IA pour consulter le site.

L'IA peut présenter son propre travail avec plus d'assurance que celui-ci ne le mérite. Vérifiez bien tout avant de considérer qu'un problème est résolu ou qu'un travail est terminé.

Seules les applications d'IA que vous configurez peuvent se connecter à Autograph. À moins d'activer les connexions à distance, les deux extrémités de cette connexion MCP doivent également s'exécuter sur le même ordinateur.

Imaginez une serrure et une clé numérique. Lors de son premier lancement, Autograph crée une serrure pour lui-même et une clé correspondante. Chaque application d’IA que vous configurez reçoit une copie de cette clé, et tout ce qui n’en possède pas est bloqué. Autograph vous fournit la clé, sans avoir à la copier ou à la coller. Gardez cette clé confidentielle. Ne la notez pas et ne placez pas les paramètres de votre application d’IA ni votre dossier de préférences Autograph à un endroit accessible à d’autres personnes.

Une fois qu’une application d’IA est connectée, cependant, ce qu’elle fait de votre environnement dépend de cette application et de son fournisseur : vérifiez leurs paramètres si vous souhaitez savoir comment ils traitent vos données.

C'est votre application d'IA qui pose la question, pas Autograph. Chaque application détermine la fréquence à laquelle elle pose la question et si vous pouvez désactiver ces invites. Claude Desktop, par exemple, dispose d'un mode « Auto » situé en bas à gauche du champ d'invite.

Autograph contrôle autre chose. Sous Édition > Préférences > MCP, vous choisissez les outils mis à la disposition de l’IA et si celle-ci est autorisée à exécuter du code Python.

Dans la section « Toolset », sous Edition > Preferences > MCP. Chaque case à cocher contrôle un groupe d’outils.

Détails : la liste complète des outils et la description de leurs fonctions se trouvent dans un fichier de référence situé dans le dossier MCP, à l’intérieur de votre dossier de préférences Autograph (Édition > Préférences > Ouvrir le dossier des préférences…). Chaque commande envoyée par l’IA est consignée dans un fichier journal situé dans ce même dossier à des fins d’audit et de sécurité, et la barre d’état affiche chaque appel au fur et à mesure de son exécution.

Ces deux préférences Python portent sur la sécurité et la journalisation. En sélectionnant « Allow exec_python », vous autorisez l’assistant IA à exécuter son propre code Python au cours de la session pour toutes les fonctions non prises en charge par les autres outils. La fonctionnalité « Verbose Logging » enregistre tout le code Python qui a été exécuté, ainsi que l’intégralité des arguments et des résultats de chaque appel. 

Oui. Chaque série de modifications peut être annulée grâce à la fonctionnalité « Annuler » d’Autograph.

Si une série échoue en cours d’exécution, les étapes déjà effectuées restent dans la scène et les autres sont ignorées.

Oui. Vous pouvez désactiver le serveur MCP d'Autograph à tout moment. Il suffit de décocher la case « Activer le serveur MCP » dans Édition > Préférences > MCP, ou de lancer la commande « Arrêter le serveur MCP » depuis le menu Extensions ou depuis le Commander. Les applications connectées perdent immédiatement leur connexion, et la commande « Démarrer le serveur MCP » rétablit la connexion.

Uniquement si vous autorisez les connexions à distance. Par défaut, le serveur n'accepte que les connexions provenant de votre propre ordinateur.

Pour ouvrir le serveur à d'autres ordinateurs, trois paramètres doivent être configurés dans la section « Accès à distance ». Activez « Autoriser les connexions à distance » et confirmez l’avertissement, définissez « Hôte » sur une adresse accessible par l’autre machine, puis ajoutez l’adresse IP de cette machine (ou une plage telle que 192.168.1.0/24) à la liste des « IP autorisées ». Ne vous arrêtez pas après le premier paramètre. Le simple fait d’activer les connexions à distance ne permet pas à n’importe qui d’accéder au serveur, car toute requête provenant d’une adresse ne figurant pas dans la liste est refusée. Les applications basées sur un navigateur doivent également voir leur adresse répertoriée sous « Origines des clients navigateur ». Les connexions à distance ne sont pas chiffrées ; n’utilisez donc l’accès à distance que sur un réseau auquel vous faites confiance.

Les Maxon Capsules sont des modèles, des matériaux et bien d'autres ressources de haute qualité qui peuvent considérablement enrichir votre projet. Autograph MCP intègre des fonctionnalités permettant de rechercher et d'intégrer des ressources issues de la bibliothèque Capsule de Maxon dans vos projets.

Gardez à l’esprit que, bien que les Maxon Capsules soient concédées sous licence aux utilisateurs finaux pour être intégrées dans des projets commerciaux, elles ne peuvent pas être utilisées pour entraîner une IA. Pour vous assurer que les données de votre scène ne sont pas utilisées pour entraîner le modèle d’IA, vous pouvez généralement désactiver un paramètre dans les préférences de l’outil d’IA. Avant de vous connecter à un fournisseur d’IA, vous devez examiner attentivement ses politiques d’utilisation des données et d’entraînement.

Pour plus de détails, veuillez vous reporter au Contrat de licence d’utilisateur final de Maxon.

En général, le travail effectué par un LLM au sein d'un MCP pour votre compte aboutit à des projets Autograph entièrement modifiables, mais il se peut que le LLM ne structure pas nécessairement les éléments de manière à faciliter leur modification.

Si vous prévoyez d’affiner vous-même un résultat, le préciser dans votre requête peut faciliter certaines tâches. Une animation générée, par exemple, peut comporter une image clé toutes les images avec une interpolation linéaire, ce qui est difficile à modifier manuellement par la suite.

La réponse dépend de la manière dont l'IA a généré le résultat. Un rig piloté par du code Python généré est difficile à modifier pour quiconque sans disposer de la conversation qui a permis de le créer. Lorsque le transfert de projet est important, demandez à l'IA une configuration utilisant les fonctionnalités standard d'Autograph plutôt que du code Python.

Demandez à votre application d'IA de créer une forme simple, comme une étoile, dans Autograph. Si la forme s'affiche, cela signifie que vous êtes connecté.

Détails : la plupart des applications mentionnent également Autograph parmi leurs serveurs connectés. Dans Claude Desktop, recherchez « autograph » sous Paramètres > Connecteurs, avec une coche dans la colonne Statut. Le serveur apparaît également sous le bouton + dans la fenêtre de discussion. L'état de la connexion et les journaux se trouvent sous Paramètres > Développeur.

Cela est généralement dû au fait qu'Autograph ne fonctionnait pas au moment du lancement de l'application d'IA. Quittez l’application IA et redémarrez-la.

Si le redémarrage ne résout pas le problème, vérifiez deux autres éléments. Le serveur MCP d’Autograph est désactivé par défaut ; assurez-vous donc que l’option « Activer le serveur MCP » est cochée (ou lancez « Démarrer le serveur MCP » depuis le menu Extensions ou depuis le Commander). De plus, si vous avez cliqué sur « Régénérer le jeton », la plupart des applications cessent de fonctionner jusqu’à ce que vous sélectionniez chacune d’entre elles dans la section « Clients » et que vous cliquiez à nouveau sur « Mettre à jour le client sélectionné », car ces applications conservent leur propre copie de l’ancienne clé.

La plupart des applications tentent de se connecter à leur démarrage et attendent Autograph pendant 20 secondes maximum. Une fois connectée, une application se reconnecte automatiquement si vous redémarrez Autograph ultérieurement, mais elle ne réessaiera pas une première connexion qui a échoué. Certaines applications se lancent à la connexion et continuent de fonctionner en arrière-plan après la fermeture de leur fenêtre. La réouverture de la fenêtre ne redémarre pas l’application.

Autograph ajoute une entrée pour lui-même et laisse tout le reste du fichier inchangé. Redémarrez complètement l'application afin qu'elle prenne en compte les nouveaux paramètres.

Autograph enregistre une sauvegarde du fichier avant de l'écraser. Si votre application ne figure pas dans la liste, ou si Autograph ne parvient pas à trouver le fichier de paramètres d'une application répertoriée, sélectionnez « Autre », cliquez sur « Copier la configuration », puis collez l'entrée manuellement.

Non. Autograph ne modifie que les entrées qu’il a lui-même créées.

Toutes les autres entrées sont conservées ; le fichier est sauvegardé avant chaque écriture, et toute entrée qui n’a pas été créée par Autograph est signalée mais reste inchangée. Cela s’applique aussi bien à la fonction « Mettre à jour le client sélectionné » qu’à la fonction « Supprimer du client ».

L'application d'IA ne peut pas voir les boîtes de dialogue d'Autograph et peut continuer comme si de rien n'était. Fermez la boîte de dialogue, indiquez à l'IA le contenu du message, puis demandez-lui de vérifier la scène avant de continuer.

Remarque : la barre d’état signale l’échec de l’appel. Un seul appel échoué est normal, car un modèle tente souvent une action, échoue, puis effectue un nouvel appel corrigé.

Non. Le serveur MCP d'Autograph nécessite l'interface Autograph et ne fonctionne que dans l'application complète, et non dans les clients et serveurs Commandline ou Team Render.