Conectar por MCP

Conecta Claude, Cursor u otra app de IA a tu proyecto para que cree la escena por ti. Esta página explica cómo conectarla, cómo iniciar sesión y cómo elegir lo que puede hacer la app.

MCP (Model Context Protocol) es una forma estándar de que las apps de IA usen herramientas externas. Una vez conectada, tu app puede leer la escena, añadir objetos, configurar eventos, escribir patches y revisar su propio trabajo.

Antes de empezar

Necesitas la dirección del servidor MCP de AR Clip:

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

Usa MCP sobre HTTP con streaming (streamable HTTP). Se puede conectar cualquier app que lo admita: claude.ai, Claude Desktop, Claude Code, Cursor y otras.

Hay dos formas de iniciar sesión:

• En el navegador: la mayoría de las apps. Solo necesitas la dirección. Consulta Iniciar sesión en el navegador.
• Con un token: para apps sin inicio de sesión en el navegador, para scripts y para CI. Consulta Iniciar sesión con un token.

¿Trabajas en una carpeta con un agente de programación? Usa la línea de comandos

arclip link prepara una carpeta para Claude Code en un solo paso. Añade el servidor MCP para esa carpeta, la vincula a un proyecto y no escribe ningún token en ningún archivo. Para Codex, Cursor u OpenCode, arclip skill install --mcp añade el servidor a sus ajustes. Consulta Línea de comandos.

¿Solo quieres que el asistente lea la documentación?

Conecta en su lugar el servidor MCP de la documentación. Busca y lee esta documentación, sin iniciar sesión.

Conecta tu app

claude.ai o Claude Desktop

1. Abre Settings → Connectors.
2. Haz clic en Add custom connector.
3. Pega la dirección.
4. Inicia sesión cuando te lo pida. Tu navegador abre la página de permisos; consulta Iniciar sesión en el navegador.

Claude Code

1. Añade el servidor:

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

2. Abre Claude Code y ejecuta /mcp.

3. Elige autenticarte. Tu navegador abre la página de permisos; consulta Iniciar sesión en el navegador.

Cursor

1. Abre .cursor/mcp.json para conectar un proyecto, o ~/.cursor/mcp.json para conectar todos los proyectos. Crea el archivo si no existe.

2. Añade el servidor:

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

3. La primera vez que Cursor se conecta, tu navegador abre la página de permisos; consulta Iniciar sesión en el navegador.

Una app que solo ejecuta servidores locales

Algunas apps solo pueden arrancar servidores MCP en tu ordenador. Conéctalas a través de mcp-remote con un token.

1. Crea un token; consulta Iniciar sesión con un token.

2. Añade esto a los ajustes MCP de la app, con tu token en lugar de <your-api-token>:

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

Comprueba que funciona

1. Abre tu proyecto en el editor.
2. Pide a tu asistente que liste los objetos de la escena de ese proyecto.
3. Te responde con los mismos objetos que ves en el editor.

Iniciar sesión en el navegador

No necesitas preparar nada antes.

1. Conecta tu app con la dirección. La primera vez que se conecta, tu navegador abre una página en tu cuenta de AR Clip. Muestra los permisos que pide la app.
2. Desmarca lo que no quieras permitir.
3. Pulsa Allow. La app recibe un token con exactamente esos permisos.

Para ver o revocar tokens más adelante, abre tu cuenta y ve a API & MCP.

Iniciar sesión con un token

Usa un token para apps sin inicio de sesión en el navegador, para scripts y para CI.

1. Abre tu cuenta de AR Clip y ve a API & MCP.

2. Crea un token y elige sus permisos.

3. Copia el token. Solo se muestra una vez.

4. Dáselo a tu app. La app lo envía en esta cabecera:

   Authorization: Bearer <your-api-token>

Guarda bien tu token

Un token puede cambiar tus proyectos. Trátalo como una contraseña: no lo compartas nunca y, si se filtra, revócalo en API & MCP.

Permisos

Un token solo puede hacer lo que tú permitas:

Permiso	Qué permite
editor:read	leer proyectos, escenas, recursos y el saldo de IA
editor:write	crear, cambiar y eliminar objetos, componentes y ajustes
editor:ai	las herramientas de generación; gastan los créditos de IA de tu organización
editor:publish	publicar, lo que hace público el proyecto
editor:plugins	escribir plugins del editor y añadirlos a un proyecto

Los permisos se aplican en todos los sitios donde funciona el token. Un token sin editor:write no puede cambiar una escena de ninguna manera.

¿Solo necesitas analizar? Da un token de solo lectura. Un asistente que no puede escribir no puede romper nada. Muchas tareas útiles no necesitan más: revisar una escena, explicar por qué algo no se dispara, planificar cambios.

Los plugins se ejecutan para todos

El código de un plugin se ejecuta en el editor de todos los que abren el proyecto al que se ha añadido. Su código de ejecución también se ejecuta para todos los que abren el proyecto publicado. Permite editor:plugins solo a una app en la que confíes para eso.

Tu plan también cuenta. Con Free, una app puede leer y revisar proyectos. Para crear, generar y publicar hace falta un plan de pago.

Trabajar en un proyecto

Una sesión recuerda su proyecto y su escena, así que no tienes que repetirlos en cada petición. Un asistente cambia de proyecto con set_active_project.

Para vincular una conexión a un solo proyecto de forma fija, añade el proyecto a la dirección:

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

Una sesión fijada no puede pasar a otro proyecto. Tampoco cambia el «último proyecto» que usan tus otras apps. La línea de comandos siempre se conecta así.

El id del proyecto es la última parte de la dirección del editor: editor.arclip.design/project/<project-id>.

Míralo trabajar

Los cambios que hace el asistente aparecen al momento en tu editor, como los de un compañero. Entran en el historial de cambios como cualquier otra edición.

Deja el editor abierto mientras pides cambios y míralos aparecer. Verás enseguida si algo no es lo que querías, en lugar de descubrirlo más tarde.

Qué puede hacer el asistente

Área	El asistente puede
Escena	listar, crear, mover, emparentar, duplicar y eliminar objetos
Componentes	leer y configurar cualquier componente de cualquier objeto
Eventos	listar disparadores y pasos, añadir y editar eventos
Patches	leer, escribir y revisar grafos de nodos, y mostrarlos como código
Animación	crear presets de la línea de tiempo
Física	configurar cuerpos, colisionadores y velocidad inicial
Recursos	explorar el árbol de recursos del proyecto, crear carpetas, importar y generar assets
Interfaz	leer y escribir tarjetas de interfaz
Plugins	escribir plugins, añadirlos al proyecto y ejecutar los comandos que ofrecen los plugins
Publicación	publicar, si el token lo permite

También puede revisar su propio trabajo:

Comprobación	Qué hace
Verify	encuentra problemas que se guardan sin errores pero fallan en el reproductor: archivos que faltan, objetos con escala cero, eventos desconocidos, pasos dirigidos a objetos eliminados, una escena oscura o completamente oculta
Render	render_scene dibuja una imagen de la escena, sin necesidad del editor
Capturas	captura el visor de un editor abierto
Medición	obtiene el tamaño real de un objeto en metros, para comprobar la escala
Playtest	ejecuta los scripts y la física, y pulsa todos los controles que encuentra
Flows	run_flows reproduce escenarios de prueba guionizados y comprueba los resultados; es lo mismo que arclip test

Hay otras dos herramientas que funcionan fuera de AR Clip:

• Exportar escena guarda una escena como datos.
• Puente con Blender trabaja con un Blender abierto: lista sus objetos, le envía una escena o trae una de vuelta.

Lo que no pueden decirte las comprobaciones

render_scene muestra la distribución, la escala, los colores y las texturas. No dibuja scripts, tarjetas de interfaz ni efectos. Para playtest y flows, mantén el proyecto abierto en una pestaña del editor. Ninguna comprobación puede decirte si un marcador se sigue bien en una sala real; para eso, usa un móvil.

Si el asistente se inventa nombres

list_component_schemas, list_event_types, list_patch_nodes y las herramientas describe_*_api muestran exactamente lo que existe. Si un asistente se inventa nombres de componentes, dile que las llame primero.

Prompts listos para usar

El servidor ofrece algunos prompts. Tu app los muestra como comandos:

Prompt	Qué hace
build-scene	crea una escena a partir de una descripción
add-interactivity	configura toques, disparadores y pasos
animate	monta una línea de tiempo
audit-scene	busca problemas
prepare-publish	revisa lo que conviene revisar antes de publicar

---

Siguiente: Línea de comandos: deja que un agente de programación cree tu proyecto desde una carpeta.