Aller au contenu principal

Se connecter via MCP

AR Clip expose un serveur MCP : un outil qui parle le Model Context Protocol peut donc travailler directement sur votre projet — lire la scène, ajouter des objets, câbler des événements, écrire des patches.

Le point d'accès

https://<your-server>/api/mcp/v1

L'authentification se fait par jeton bearer :

Authorization: Bearer <your-api-token>

Créez le jeton dans les réglages de votre compte, sous API & MCP.

Traitez le jeton comme un mot de passe

Il peut modifier vos projets. Gardez-le hors de tout ce que vous partagez, et révoquez-le s'il fuite.

Portées

Un jeton ne porte que ce que vous lui donnez :

PortéePermet
editor:readlire projets, scènes et ressources
editor:writeles créer et les modifier
editor:ailes outils de génération
editor:publishpublier

Donnez un jeton en lecture seule quand vous ne voulez que de l'analyse. Un modèle qui ne peut pas écrire ne peut rien casser, et une grande partie du travail utile — auditer une scène, expliquer pourquoi quelque chose ne se déclenche pas, planifier des changements — n'a besoin de rien de plus.

Ce qui se connecte

Tout ce qui implémente MCP sur HTTP en flux. En pratique : Claude Desktop, Claude Code, Cursor, et un nombre croissant d'éditeurs. Chacun a son endroit pour déclarer un serveur — vous lui donnez l'URL ci-dessus et votre jeton.

Travailler à côté de l'éditeur

Les changements d'un assistant apparaissent en direct dans votre éditeur, comme le feraient ceux d'un collègue, et ils atterrissent dans l'historique de collaboration comme n'importe quelle autre modification.

La bonne façon de faire est donc : gardez l'éditeur ouvert sur un écran, demandez des changements et regardez-les se produire. Vous voyez immédiatement quand ce n'est pas ce que vous vouliez dire, au lieu de le découvrir après coup.

Une session retient sur quel projet et quel space vous travaillez : vous n'avez pas à le répéter à chaque demande.

Ce que couvrent les outils

Regroupés par ce que vous demanderiez :

DomaineL'assistant peut
Scènelister, créer, déplacer, reparenter, dupliquer et supprimer des objets
Composantslire et régler n'importe quel composant de n'importe quel objet
Événementslister déclencheurs et étapes, ajouter et modifier des événements
Patcheslire, écrire et valider des graphes, et prévisualiser le code compilé
Animationcomposer des presets de timeline
Physiquerégler corps, colliders et vitesses initiales
Ressourcesparcourir l'arbre du projet, créer des dossiers, importer et générer des assets
Interfacelire et écrire des cartes UI
Publicationpublier, avec la bonne portée

Quatre autres, faciles à manquer parce qu'ils sortent du serveur :

ÉgalementCe qu'il fait
Capturescapturer le viewport, pour qu'un assistant puisse regarder ce qu'il a bâti
Mesurela taille réelle d'un objet en mètres — comment il vérifie l'échelle
Export de scènesortir une scène sous forme de données
Pont Blenderparler à un Blender en cours : lister les objets, lui pousser une scène, en récupérer une
Une capture n'est pas une preuve

Un assistant peut voir son propre travail, ce qui aide — mais une image fixe ne dit rien de savoir si les scripts tournent, si la physique se stabilise, ou si un marqueur est suivi. Cela demande un aperçu sur un vrai appareil.

Plusieurs outils décrivent la plateforme au modèle lui-même

list_component_schemas, list_event_types, list_patch_nodes et les outils describe_*_api répondent depuis le moteur en fonctionnement : un assistant peut donc consulter exactement ce qui existe au lieu de deviner d'après ses données d'entraînement. Si un modèle invente des noms de composants, dites-lui d'appeler ceux-là d'abord.

Tâches prêtes à l'emploi

Le serveur propose aussi quelques prompts qu'un client MCP affiche comme des commandes :

PromptFait
build-sceneconstruire une scène à partir d'une description
add-interactivitycâbler touchers, déclencheurs et étapes
animatemonter une timeline
audit-scenechercher des problèmes
prepare-publishvérifier ce qui mérite de l'être avant de publier

Lire sans modifier

Le serveur publie sa propre référence sous forme de ressources qu'un client peut lire :

was://project/info        was://scene/current       was://scene/selection
was://scripting/api was://patch/api was://events/api
was://physics/api was://timeline/api was://resources/api
was://ui/api

Elles sont générées depuis le moteur : elles ne décrivent donc jamais une version de la plateforme qui n'existe plus.


Suite : Les compétences de l'assistant