Conectarse por MCP
AR Clip expone un servidor MCP, así que una herramienta que hable el Model Context Protocol puede trabajar directamente sobre tu proyecto: leer la escena, añadir objetos, cablear eventos, escribir patches.
El endpoint
https://<your-server>/api/mcp/v1
La autenticación es un token bearer:
Authorization: Bearer <your-api-token>
Crea el token en los ajustes de tu cuenta, en API & MCP.
Puede cambiar tus proyectos. Mantenlo fuera de todo lo que compartas, y revócalo si se filtra.
Ámbitos
Un token solo lleva lo que tú le des:
| Ámbito | Permite |
|---|---|
editor:read | leer proyectos, escenas y recursos |
editor:write | crearlos y modificarlos |
editor:ai | las herramientas de generación |
editor:publish | publicar |
Da un token de solo lectura cuando solo quieras análisis. Un modelo que no puede escribir no puede romper nada, y una buena parte del trabajo útil —auditar una escena, explicar por qué algo no se dispara, planificar cambios— no necesita más.
Qué se conecta
Cualquier cosa que implemente MCP sobre HTTP en streaming. En la práctica: Claude Desktop, Claude Code, Cursor, y un número creciente de editores. Cada uno tiene su sitio para declarar un servidor: le das la URL de arriba y tu token.
Trabajar junto al editor
Los cambios que hace un asistente aparecen en vivo en tu editor, igual que los de un compañero, y quedan en el historial de colaboración como cualquier otra edición.
Así que la forma productiva es: mantén el editor abierto en una pantalla, pide cambios y míralos suceder. Ves al momento cuando algo no es lo que querías decir, en vez de descubrirlo después.
Una sesión recuerda con qué proyecto y qué space trabajas, así que no tienes que repetirlo en cada petición.
Qué cubren las herramientas
Agrupadas por lo que pedirías:
| Área | El asistente puede |
|---|---|
| Escena | listar, crear, mover, emparentar, duplicar y eliminar objetos |
| Componentes | leer y fijar cualquier componente en cualquier objeto |
| Eventos | listar disparadores y pasos, añadir y editar eventos |
| Patches | leer, escribir y validar grafos de nodos, y ver el código en que compilan |
| Animación | crear presets de línea de tiempo |
| Física | fijar cuerpos, colliders y velocidades iniciales |
| Recursos | recorrer el árbol del proyecto, crear carpetas, importar y generar assets |
| Interfaz | leer y escribir tarjetas de UI |
| Publicación | publicar, con el ámbito adecuado |
Cuatro más que es fácil pasar por alto, porque salen fuera del servidor:
| También | Qué hace |
|---|---|
| Capturas | capturar el viewport, para que un asistente pueda mirar lo que construyó |
| Medición | el tamaño real de un objeto en metros: así comprueba la escala |
| Exportar escena | sacar una escena como datos |
| Puente a Blender | hablar con un Blender abierto: listar objetos, enviarle una escena, traerse otra |
Un asistente puede ver su propio trabajo, y eso ayuda; pero un fotograma fijo no dice nada sobre si los scripts corren, si la física se asienta, o si un marcador rastrea. Para eso hace falta una vista previa en un dispositivo real.
list_component_schemas, list_event_types, list_patch_nodes y las herramientas describe_*_api
responden desde el motor en vivo, así que un asistente puede consultar exactamente lo que existe
en vez de adivinar por sus datos de entrenamiento. Si un modelo se inventa nombres de componente,
dile que llame primero a esas.
Tareas ya preparadas
El servidor ofrece además unos cuantos prompts que un cliente MCP muestra como comandos:
| Prompt | Hace |
|---|---|
build-scene | construir una escena a partir de una descripción |
add-interactivity | cablear toques, disparadores y pasos |
animate | montar una línea de tiempo |
audit-scene | buscar problemas |
prepare-publish | revisar lo que conviene revisar antes de publicar |
Leer sin cambiar nada
El servidor publica su propia referencia como recursos que un cliente puede leer:
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
Se generan desde el motor, así que nunca describen una versión de la plataforma que ya no existe.
Siguiente: Las habilidades del asistente