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.
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ée | Permet |
|---|---|
editor:read | lire projets, scènes et ressources |
editor:write | les créer et les modifier |
editor:ai | les outils de génération |
editor:publish | publier |
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 :
| Domaine | L'assistant peut |
|---|---|
| Scène | lister, créer, déplacer, reparenter, dupliquer et supprimer des objets |
| Composants | lire et régler n'importe quel composant de n'importe quel objet |
| Événements | lister déclencheurs et étapes, ajouter et modifier des événements |
| Patches | lire, écrire et valider des graphes, et prévisualiser le code compilé |
| Animation | composer des presets de timeline |
| Physique | régler corps, colliders et vitesses initiales |
| Ressources | parcourir l'arbre du projet, créer des dossiers, importer et générer des assets |
| Interface | lire et écrire des cartes UI |
| Publication | publier, avec la bonne portée |
Quatre autres, faciles à manquer parce qu'ils sortent du serveur :
| Également | Ce qu'il fait |
|---|---|
| Captures | capturer le viewport, pour qu'un assistant puisse regarder ce qu'il a bâti |
| Mesure | la taille réelle d'un objet en mètres — comment il vérifie l'échelle |
| Export de scène | sortir une scène sous forme de données |
| Pont Blender | parler à un Blender en cours : lister les objets, lui pousser une scène, en récupérer une |
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.
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 :
| Prompt | Fait |
|---|---|
build-scene | construire une scène à partir d'une description |
add-interactivity | câbler touchers, déclencheurs et étapes |
animate | monter une timeline |
audit-scene | chercher des problèmes |
prepare-publish | vé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