Assistant IA (MCP)
Laisser Claude, Cursor, Codex ou un autre assistant construire et régler votre scène via le serveur MCP de Polly3D.
Polly3D Studio contient un serveur MCP (Model Context Protocol). Un assistant IA compatible MCP — Claude (Desktop ou Code), Cursor, VS Code, Codex, Antigravity… — peut voir et modifier votre scène avec une quarantaine d'outils : créer des objets, construire des matériaux, régler des lumières, cloner, animer, et regarder le résultat avec un rendu.
La conversation reste dans l'application de votre assistant (avec votre propre abonnement). L'onglet Assistant de Studio n'affiche qu'un journal des actions effectuées. Chaque appel d'outil est une étape d'annulation que vous pouvez annuler avec ⌘ Z.
Mise en place#
- Ouvrez File > MCP settings… dans Studio (ou le bouton de l'onglet Assistant).
- Dans MCP Server, vérifiez que le serveur est activé.
- Activez l'assistant que vous utilisez : Claude Desktop, Claude Code, Cursor, VS Code, Codex, Antigravity. Studio ajoute (ou retire) l'entrée dans le fichier de configuration de cet assistant.
- Pour tout autre assistant, copiez l'entrée JSON de Other assistants avec Copy.
- Relancez votre assistant. Demandez-lui ensuite par exemple « Crée une sphère de verre sur un backdrop bleu avec une lumière douce ».
Studio s'ouvre à la demande quand l'assistant se connecte. Rien ne passe par le réseau : l'assistant parle à Studio par un socket local réservé au propriétaire, dans ~/Library/Application Support/Polly3D.
Ce que l'assistant peut faire#
Scène et objets, matériaux et couches, Cloner et effecteurs, animation, liens vers les curseurs et drivers After Effects, ambiance et réglages de rendu, images de référence. Voir Outils de l'assistant pour la liste complète.
Il peut aussi gérer les onglets de scène (ouvrir une nouvelle scène, changer, enregistrer, fermer) et ne jette jamais de modifications non enregistrées sans qu'on le lui dise.
Il ne peut pas :
- modifier l'effet After Effects lui-même (caméra, lumières de la comp, nulls, Custom Textures, curseurs Aux). Il peut vous dire quoi y faire ;
- lier les calques texte After Effects.
Comment il travaille avec vous#
- L'assistant lit d'abord un guide intégré (
get_guide) qui explique le fonctionnement de Polly3D : matériaux, verre, éclairage, Cloner, animation, After Effects… - Il regarde la scène (
get_scene), construit par petites étapes, et utiliserender_previewpour voir une image du résultat, puis corrige. - Il travaille sur la même scène que celle que vous avez ouverte. Vous pouvez intervenir à tout moment et éditer ; l'annulation est partagée.
- Donnez-lui des images de référence (voir plus bas), une ambiance et un but (« un loader pour une marque tech », « un packshot de flacon de parfum »).
Reproduire une image de référence#
Donnez à l'assistant le chemin d'un fichier : une photo, un moodboard, une image de film. Il peut :
- Mesurer l'image (
extract_palette) : couleurs dominantes, luminosité, contraste, saturation, chaleur, et d'où tombe la lumière (une grille de luminosité 3 × 3) ; - construire une première version cadrée comme la référence ;
- comparer (
compare_to_reference) : il rend la scène et renvoie une image référence | rendu | différence avec des chiffres et des conseils ; - corriger une chose à la fois, et comparer de nouveau.
Une copie au pixel près n'est ni possible ni le but quand la composition diffère ; l'assistant vous dit ce qui reste différent (une texture, une forme).
De bons prompts#
- Décrivez le résultat et l'ambiance : « lumière de studio chaude et douce, couleurs pastel, un cube de verre qui flotte au-dessus d'un sol rose ».
- Demandez-lui de nommer les objets et les groupes pour les retrouver.
- Demandez une animation que vous finirez dans After Effects : « lie le Blur du verre à un Connector et dis-moi lequel ».
- Itérez : « rends le verre plus épais », « le reflet est trop dur », « baisse le soleil ».
Dépannage#
| Problème | Solution |
|---|---|
| L'assistant ne voit pas Polly3D | Vérifiez l'interrupteur de votre assistant dans MCP Settings, puis relancez-le |
| L'assistant n'arrive pas à se connecter | Ouvrez Polly3D Studio une fois et vérifiez que le MCP Server est activé |
| Rien ne change dans le viewport | Regardez l'onglet Assistant : le journal montre chaque action. Utilisez ⌘ Z pour annuler |
| La scène n'est pas mise à jour dans After Effects | Enregistrez la scène (⌘ S) ou demandez à l'assistant de l'enregistrer |