Se connecter via MCP

Connectez Claude, Cursor ou une autre application d'IA à votre projet, pour qu'elle construise la scène à votre place. Cette page explique comment la connecter, comment vous authentifier et comment choisir ce que l'application a le droit de faire.

MCP (Model Context Protocol) est un standard qui permet aux applications d'IA d'utiliser des outils externes. Une fois connectée, votre application peut lire la scène, ajouter des objets, configurer des événements, écrire des patchs et vérifier son propre travail.

Avant de commencer

Il vous faut l'adresse du serveur MCP d'AR Clip :

https://editor.arclip.design/api/mcp/v1

Il utilise MCP via HTTP streamable (streamable HTTP). Toute application qui le prend en charge peut s'y connecter : claude.ai, Claude Desktop, Claude Code, Cursor et d'autres.

Il y a deux façons de vous authentifier :

Dans le navigateur — pour la plupart des applications. Seule l'adresse est nécessaire. Voir Connexion dans le navigateur.
Avec un token — pour les applications sans connexion par navigateur, pour les scripts et pour la CI. Voir Connexion avec un token.

Vous travaillez dans un dossier avec un agent de code ? Utilisez la ligne de commande

arclip link configure un dossier pour Claude Code en une seule étape. La commande ajoute le serveur MCP pour ce dossier, le lie à un projet et n'écrit de token dans aucun fichier. Pour Codex, Cursor ou OpenCode, arclip skill install --mcp ajoute le serveur à leurs réglages. Voir Ligne de commande.

L'assistant doit seulement lire la documentation ?

Connectez plutôt le serveur MCP de la documentation. Il cherche et lit cette documentation, sans connexion.

Connecter votre application

claude.ai ou Claude Desktop

Ouvrez Settings → Connectors.
Cliquez sur Add custom connector.
Collez l'adresse.
Connectez-vous quand on vous le demande. Votre navigateur ouvre la page des permissions — voir Connexion dans le navigateur.

Claude Code

Ajoutez le serveur :

claude mcp add --transport http arclip https://editor.arclip.design/api/mcp/v1

Lancez Claude Code et exécutez /mcp.
Choisissez de vous authentifier. Votre navigateur ouvre la page des permissions — voir Connexion dans le navigateur.

Cursor

Ouvrez .cursor/mcp.json pour connecter un seul projet, ou ~/.cursor/mcp.json pour connecter tous vos projets. Créez le fichier s'il n'existe pas.

Ajoutez le serveur :

{
  "mcpServers": {
    "arclip": { "url": "https://editor.arclip.design/api/mcp/v1" }
  }
}

La première fois que Cursor se connecte, votre navigateur ouvre la page des permissions — voir Connexion dans le navigateur.

Une application qui ne lance que des serveurs locaux

Certaines applications ne peuvent lancer des serveurs MCP que sur votre ordinateur. Connectez-les via mcp-remote, avec un token.

Créez un token — voir Connexion avec un token.

Ajoutez ceci aux réglages MCP de l'application, en remplaçant <your-api-token> par votre token :

{
  "mcpServers": {
    "arclip": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://editor.arclip.design/api/mcp/v1",
        "--header", "Authorization:Bearer <your-api-token>"
      ]
    }
  }
}

Vérifier que ça fonctionne

Ouvrez votre projet dans l'éditeur.
Demandez à votre assistant de lister les objets de la scène de ce projet.
Il vous répond avec les mêmes objets que ceux que vous voyez dans l'éditeur.

Vous n'avez rien à préparer à l'avance.

Connectez votre application avec l'adresse. À la première connexion, votre navigateur ouvre une page dans votre compte AR Clip. Elle liste les permissions que l'application demande.
Décochez tout ce que vous ne voulez pas autoriser.
Cliquez sur Allow. L'application reçoit un token avec exactement ces permissions.

Pour consulter ou révoquer vos tokens plus tard, ouvrez votre compte et allez dans API & MCP.

Utilisez un token pour les applications sans connexion par navigateur, pour les scripts et pour la CI.

Ouvrez votre compte AR Clip et allez dans API & MCP.
Créez un token et choisissez ses permissions.
Copiez le token. Il n'est affiché qu'une seule fois.
Donnez-le à votre application. Elle l'envoie dans cet en-tête :
```
Authorization: Bearer <your-api-token>
```

Gardez votre token secret

Un token peut modifier vos projets. Traitez-le comme un mot de passe : ne le partagez jamais, et révoquez-le dans API & MCP s'il a fuité.

Permissions

Un token ne peut faire que ce que vous autorisez :

Permission	Ce qu'elle autorise
`editor:read`	lire les projets, les scènes, les ressources et le solde IA
`editor:write`	créer, modifier et supprimer des objets, des composants et des réglages
`editor:ai`	les outils de génération — ils consomment les crédits IA de votre organisation
`editor:publish`	publier, ce qui rend le projet public
`editor:plugins`	écrire des plugins d'éditeur et les ajouter à un projet

Les permissions s'appliquent partout où le token fonctionne. Un token sans editor:write ne peut modifier une scène d'aucune façon.

Vous n'avez besoin que d'analyse ? Donnez un token en lecture seule. Un assistant qui ne peut pas écrire ne peut rien casser. Beaucoup de tâches utiles n'ont besoin de rien de plus : vérifier une scène, expliquer pourquoi quelque chose ne se déclenche pas, planifier des modifications.

Les plugins s'exécutent chez tout le monde

Le code d'un plugin s'exécute dans l'éditeur de toutes les personnes qui ouvrent le projet auquel il est ajouté. Son code d'exécution tourne aussi pour toutes les personnes qui ouvrent le projet publié. N'autorisez editor:plugins que pour une application à laquelle vous confiez cela.

Votre plan compte aussi. Avec le plan Free, une application peut lire et vérifier des projets. Construire, générer et publier nécessitent un plan payant.

Travailler sur un seul projet

Une session retient son projet et sa scène : vous n'avez pas à les répéter à chaque demande. Un assistant change de projet avec set_active_project.

Pour lier définitivement une connexion à un projet, ajoutez le projet à l'adresse :

https://editor.arclip.design/api/mcp/v1?projectId=<project-id>&pin=1

Une session épinglée ne peut pas passer à un autre projet. Elle ne modifie pas non plus le « dernier projet » que reprennent vos autres applications. La ligne de commande se connecte toujours de cette façon.

L'identifiant du projet est la dernière partie de l'adresse de l'éditeur : editor.arclip.design/project/<project-id>.

Le regarder travailler

Les modifications de l'assistant apparaissent immédiatement dans votre éditeur, comme celles d'un collègue. Elles entrent dans l'historique comme n'importe quelle autre modification.

Gardez l'éditeur ouvert pendant que vous demandez des modifications, et regardez-les se faire. Vous voyez tout de suite quand quelque chose ne correspond pas à ce que vous vouliez, au lieu de le découvrir plus tard.

Ce que l'assistant peut faire

Domaine	L'assistant peut
Scène	lister, créer, déplacer, rattacher à un parent, dupliquer et supprimer des objets
Composants	lire et définir n'importe quel composant sur n'importe quel objet
Événements	lister les déclencheurs et les étapes, ajouter et modifier des événements
Patchs	lire, écrire et vérifier des graphes de nœuds, et les montrer sous forme de code
Animation	créer des presets de timeline
Physique	définir les corps, les colliders et la vitesse de départ
Ressources	parcourir l'arborescence des ressources du projet, créer des dossiers, importer et générer des assets
Interface	lire et écrire des cartes UI
Plugins	écrire des plugins, les ajouter au projet et lancer les commandes que proposent les plugins
Publication	publier, si le token le permet

Il peut aussi vérifier son propre travail :

Vérification	Ce qu'elle fait
Verify	trouve les problèmes qui s'enregistrent sans erreur mais cassent dans le lecteur : fichiers manquants, objets à l'échelle zéro, événements inconnus, étapes qui visent des objets supprimés, scène sombre ou entièrement masquée
Render	`render_scene` dessine une image de la scène — sans éditeur
Captures d'écran	capture la zone d'affichage d'un éditeur ouvert
Mesure	obtient la taille réelle d'un objet en mètres, pour vérifier l'échelle
Playtest	exécute les scripts et la physique, et actionne chaque contrôle qu'il trouve
Flows	`run_flows` joue des scénarios de test scriptés et vérifie les résultats — comme `arclip test`

Deux autres outils fonctionnent en dehors d'AR Clip :

Scene export enregistre une scène sous forme de données.
Blender bridge travaille avec un Blender ouvert : lister ses objets, lui envoyer une scène ou en récupérer une.

Ce que les vérifications ne peuvent pas vous dire

render_scene montre la disposition, l'échelle, les couleurs et les textures. Il ne dessine ni les scripts, ni les cartes UI, ni les effets. Pour playtest et flows, gardez le projet ouvert dans un onglet de l'éditeur. Aucune vérification ne peut dire si un marqueur est bien suivi dans une vraie pièce — pour cela, prenez un téléphone.

Si l'assistant invente des noms

list_component_schemas, list_event_types, list_patch_nodes et les outils describe_*_api montrent exactement ce qui existe. Si un assistant invente des noms de composants, dites-lui de les appeler d'abord.

Prompts prêts à l'emploi

Le serveur propose quelques prompts. Votre application les affiche sous forme de commandes :

Prompt	Ce qu'il fait
`build-scene`	construit une scène à partir d'une description
`add-interactivity`	configure les touchers, les déclencheurs et les étapes
`animate`	assemble une timeline
`audit-scene`	cherche les problèmes
`prepare-publish`	vérifie ce qui mérite de l'être avant de publier

Suite : Ligne de commande — laissez un agent de code construire votre projet depuis un dossier.

Avant de commencer​

Connecter votre application​

claude.ai ou Claude Desktop​

Claude Code​

Cursor​

Une application qui ne lance que des serveurs locaux​

Vérifier que ça fonctionne​

Connexion dans le navigateur​

Connexion avec un token​

Permissions​

Travailler sur un seul projet​

Le regarder travailler​

Ce que l'assistant peut faire​

Prompts prêts à l'emploi​