Sceneplane
Blender en la nube para agentes de IA: proyectos duraderos, revisiones inmutables, operaciones seguras de escenas, renders, MP4, STL y GLB a través de MCP remoto alojado.
Documentación
Documentación
Sceneplane proporciona a los agentes de IA cómputo de Blender aislado en la nube: proyectos duraderos, estado de escena versionado y renderizado asíncrono, todo a través de un único endpoint MCP remoto. Cada resultado es tuyo para descargar: renders, exportaciones GLB/OBJ/STL y los archivos de proyecto .blend. Todo lo siguiente aplica por igual a agentes y a humanos que usan el panel de control.
Inicio rápido
- Regístrate, luego crea y copia una clave API desde sceneplane.online/app (Inicio → Claves API, o el modal del Paso 4).
- Conecta un cliente MCP compatible con cabeceras a
https://mcp.sceneplane.online/v1con la clave como cabecera de portador:
{
"mcpServers": {
"sceneplane": {
"url": "https://mcp.sceneplane.online/v1",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}
- Ejecuta
platform_statuspara confirmar que el despliegue está listo y sus límites de política actuales. - Crea un proyecto. Una cuenta nueva recibe una organización Personal y un despliegue predeterminado aprovisionado automáticamente en la primera llamada, sin necesidad de hacer clic.
Autenticación
Claves API (para clientes compatibles con cabeceras)
Las claves tienen el formato sp_…, se crean en el panel de control, se muestran una sola vez y se almacenan en el servidor únicamente como hash SHA-256. Revocar una clave la bloquea en su siguiente solicitud. Una clave actúa como tu cuenta: sus permisos en cada despliegue siguen tu rol en la organización (propietario, administrador, editor, visor).
OAuth (para conectores compatibles con OAuth)
Los conectores basados en web (por ejemplo, conectores personalizados de Claude web) ejecutan OAuth con código de autorización + PKCE, contra la misma URL: añade https://mcp.sceneplane.online/v1 sin cabecera de Authorization y deja el ID de cliente vacío (se admite registro dinámico). Serás redirigido para iniciar sesión y elegir el despliegue al que se vinculará el conector durante el consentimiento.
Despliegues y vinculación
Un despliegue es un entorno de cómputo Blender aislado con su propia política, presupuesto y proyectos. Cada solicitud MCP se vincula a un despliegue:
- un despliegue en la cuenta → se vincula automáticamente;
- ninguno → se aprovisiona un despliegue predeterminado en la primera llamada;
- varios → se vincula el más recientemente actualizado; fija explícitamente con
https://mcp.sceneplane.online/v1?deployment=<slug>(verdeployments_list).
Catálogo de herramientas
Herramientas de escena y proyecto (limitadas al despliegue)
| Herramienta | Qué hace |
|---|---|
projects_list | Lista los proyectos de Blender en el despliegue vinculado (paginación por cursor). |
project_create | Crea un proyecto desde una plantilla (vacío, product_studio, three_point_lighting, low_poly, print_ready); devuelve el trabajo de inicialización asíncrono. |
project_get | Detalle del proyecto: revisión principal, revisiones recientes, trabajos activos, artefacto de vista previa. |
scene_inspect | Resumen estructurado de la escena de una revisión: objetos, materiales, cámaras, luces, estadísticas. |
scene_apply | Aplica un lote validado de operaciones de escena contra la revisión principal; confirma una nueva revisión inmutable (trabajo asíncrono). |
scene_validate | Valida una revisión contra un perfil (general, render, game_asset, three_d_print). deep=true ejecuta análisis real de malla en Blender: estanqueidad, voladizos e informe de impresión 3D con dimensiones, volumen, estimación de filamento y ajuste en la cama. |
scene_snapshot | VE la escena: la miniatura de la revisión actual (o cualquier fotograma de render/turntable) devuelta como imagen en línea real: verifica visualmente después de cada cambio, sin necesidad de trabajo de render. |
scene_script | Ejecuta Python arbitrario de Blender (bpy) contra una revisión, confirmando el resultado. Deshabilitado por defecto: un propietario habilita la escritura de scripts por despliegue (Configuración → Política). Se ejecuta en un contenedor aislado sin credenciales. |
docs_bpy_lookup / docs_bpy_search | Referencia autoritativa de la API de Python de Blender como herramientas: los agentes verifican firmas, miembros y enumeraciones de bpy antes de escribir código scene_script, con descubrimiento de espacios de nombres y sugerencias de "quisiste decir". |
docs_manual_search / docs_manual_get | Búsqueda de texto completo en todo el manual de usuario de Blender (más de 2100 páginas): respuestas conceptuales sobre cómo se comportan modificadores, sombreado, física y flujos de trabajo, con fragmentos clasificados y lecturas de página completa. |
asset_preview / assets_categories | Ve la miniatura de un activo como imagen real antes de importarlo y explora las categorías de Poly Haven con recuentos. |
assets_search | Busca fuentes de activos gratuitas por palabra clave: Poly Haven CC0 (HDRIs, conjuntos de texturas PBR, modelos, sin configuración) o modelos descargables de Sketchfab (trae tu propio token). Devuelve slugs para asset_library_import. |
asset_library_import | Importa un activo de biblioteca por slug: los HDRIs se convierten en el entorno mundial, los modelos se añaden a la escena, los conjuntos de texturas se convierten en un material PBR cableado que puedes asignar automáticamente a objetos (trabajo asíncrono). Fuentes: polyhaven, sketchfab, hyper3d, hunyuan3d, tripo3d. |
material_from_image | Una imagen → un material PBR completo, de forma determinista: una máscara alfa o de luminancia impulsa el color base compuesto, rugosidad mate/brillante, mapas de normales y altura en relieve, y metálico opcional: por ejemplo, un logotipo se convierte en una etiqueta brillante en relieve sobre una lata mate. |
presets_list / preset_apply | Presets seleccionados de una sola llamada: materiales PBR (vidrio, cromo, oro, neón…), rigs de iluminación (estudio de tres puntos, softbox, atardecer…), encuadres de cámara (héroe, vista superior, isométrico…) y perfiles de render (borrador, producción). Se compilan en operaciones de escena validadas. |
webhooks_set / webhooks_list / webhook_test / webhooks_delete | Empuja en lugar de sondear: registra una URL https y recibe POSTs firmados con HMAC en job.completed / job.failed / job.cancelled. El secreto de firma se muestra una vez; prueba las entregas bajo demanda. |
job_wait | Sondeo largo de un trabajo hasta 25 s por llamada: devuelve el momento en que alcanza un estado terminal. Encadena llamadas para trabajos más largos. |
platform_status | Descubrimiento de capacidades: si la ejecución de Blender está disponible actualmente, recuentos de trabajos abiertos y límites de política del despliegue: falla rápido en lugar de poner en cola trabajos condenados. |
project_update / project_delete | Renombra o elimina de forma suave proyectos (la eliminación se rechaza mientras haya trabajos abiertos). |
deployment_policy_update | Ajuste de política de autoservicio a través de MCP: tiempos de espera, profundidad de cola, límites de render y habilitación de scene_script (solo propietario), sin necesidad de panel de control. |
asset_generate_3d / asset_generate_status | Texto o imagen → modelo 3D mediante Hyper3D Rodin, Tencent Hunyuan3D o Tripo3D (trae tus propias claves). Inicia, sondea y luego importa el modelo terminado con asset_library_import, opcionalmente escalado a un targetSize del mundo real. |
integrations_set / integrations_list / integrations_delete | Credenciales de fuentes de terceros gestionadas por agentes (Sketchfab, Hyper3D, Hunyuan3D, Tripo3D), cifradas en reposo: configura una vez a través de MCP, sin necesidad de panel de control. |
upload_create / upload_complete | Carga directa en dos pasos para activos (PUT firmado, luego finalizar + escanear). |
asset_import | Importa un activo cargado y validado (glb/obj/fbx/stl…) en un proyecto como nueva revisión (trabajo asíncrono). |
render_create | Pone en cola un render Cycles de una revisión (ancho/alto/muestras/transparencia; limitado por política; trabajo asíncrono). |
render_turntable | De 2 a 12 vistas orbitales espaciadas uniformemente en UN trabajo: vistas previas Workbench casi instantáneas o fotogramas Cycles iluminados, cada uno visible en línea mediante scene_snapshot. targetObjectIds orbita y encuadra solo esos objetos, de modo que las tomas de producto mantienen suelos y fondos fuera del encuadre sin ocultarlos. |
render_animation | Secuencia con fotogramas clave → MP4 H.264 en un trabajo (hasta 600 fotogramas; Cycles o vista previa rápida). Las secuencias largas se renderizan como trabajos de segmento paralelos sobre rangos de fotogramas contiguos: segmentos MP4 seguros para concatenar. |
export_create | Exporta una revisión a glb, obj, stl o blend. Los presets de motor aplican convenciones de destino: unity, unreal, godot y print (STL escalado de metros a milímetros para que las cortadoras lean el tamaño real). |
revision_diff | Diferencia semántica entre una revisión y su padre: objetos añadidos/eliminados, transformaciones, materiales… |
revision_restore | Restaura una revisión anterior como nueva confirmación principal (el historial nunca se reescribe). |
artifact_get | Metadatos + URL de descarga con caducidad para un render, exportación o artefacto de vista previa. |
job_get / jobs_list / job_cancel | Sondea el estado y progreso del trabajo, lista trabajos, solicita cancelación. |
Herramientas de cuenta (solo endpoint de clave API)
| Herramienta | Qué hace |
|---|---|
organizations_list | Organizaciones a las que pertenece esta cuenta, con tu rol. |
deployments_list | Cada despliegue accesible; indica a cuál está vinculada esta sesión. |
deployment_create | Crea un nuevo despliegue aislado (propietario/administrador). |
deployment_update | Renombra o habilita/deshabilita un despliegue (propietario/administrador). |
deployment_delete | Elimina un despliegue vacío (propietario/administrador). |
Operaciones de escena
scene_apply toma un lote de operaciones tipadas y validadas, no código arbitrario. Cada lote se verifica contra la escena actual (las referencias deben existir, los nombres deben ser únicos) y se confirma atómicamente como una nueva revisión con una vista previa nueva.
| Familia | Operaciones |
|---|---|
object.* | create_primitive, transform, rename, duplicate, delete, parent, unparent, set_visibility |
collection.* | create, rename, link_object, unlink_object |
material.* | create, update_principled (parámetros PBR), assign, remove_assignment |
modifier.* | add / update / remove: bevel, subdivision, solidify, array, mirror, boolean |
mesh.* | apply_modifier, bevel, subdivide, recalculate_normals, shade_smooth, merge_vertices, center_origin, lay_flat, fill_holes, dissolve_degenerate, decimate (reducción por colapso/planar), remesh (retopología voxel/QuadriFlow), tris_to_quads, make_printable (preparación de impresión en una operación: remesh estanco + presupuesto de triángulos + colocación en cama), lathe (revoluciona un perfil [radio,z] — latas, botellas, vasos) |
uv.cylindrical_project | colocación paramétrica de etiquetas en cilindros: cobertura de arco, acimut central, extensión vertical, fijación de tapas |
light.* | upsert (punto/sol/spot/área con energía y color), delete |
camera.* | upsert (lente, clip, sensor, profundidad de campo: fstop / focusDistance / focusObject — el enfoque sigue al objeto a través de movimientos de cámara), look_at (re-enfoca automáticamente al objetivo cuando DOF está activado), set_active, delete |
world.update | color de fondo / intensidad |
render_settings.update | resolución, muestras, configuración del motor |
animation.* | set_range (extensión de fotogramas + fps), keyframe_transform (ubicación / escala / apuntado lookAt explícitos por momento — conjunto y clave atómicos), keyframe_camera (tirones de lente / apertura / enfoque), remove_keyframes — control de interpolación incl. retención constante para cortes duros |
Los lotes se ejecutan dentro de Blender real (bpy) en un contenedor aislado. Usa scene_validate para una prueba gratuita antes de confirmar.
Trabajos y revisiones
Todo lo que toca Blender es asíncrono: la herramienta devuelve un identificador de trabajo inmediatamente (jobId, status, pollAfterMs); sondea con job_get. Estados: en cola → esperando_capacidad → preparando → iniciando_contenedor → ejecutando → subiendo_salidas → confirmando → completado (o fallido / cancelado). El progreso se transmite en vivo al panel de control.
El estado de la escena es una cadena de revisiones inmutables. Los escritores concurrentes son seguros: un lote se confirma solo si la cabeza contra la que se construyó sigue siendo la cabeza (comparar e intercambiar); de lo contrario, el trabajo falla limpiamente y el agente reintenta contra la nueva cabeza. revision_restore revierte copiando una revisión anterior hacia adelante: el historial nunca se reescribe.
Límites y políticas (valores predeterminados)
| Política | Predeterminado |
|---|---|
| Trabajos concurrentes por despliegue | 2 (en cola hasta 25) |
| Tiempo de espera del trabajo | 300 s |
| Límites de render | 2048 × 2048 px, 256 muestras |
| Límite de carga | 100 MB por archivo |
| Solicitudes de herramienta | 120 / minuto por despliegue |
| Python arbitrario (scene_script) | deshabilitado por defecto; opt-in del propietario por despliegue |
Los propietarios pueden ajustar políticas por despliegue en el panel de control; se aplican límites duros de plataforma.
Configuración del cliente
Claude Code
claude mcp add sceneplane https://mcp.sceneplane.online/v1 \
--transport http --header "Authorization: Bearer <YOUR_API_KEY>"
Claude Desktop / cualquier cliente JSON compatible con cabeceras
Usa el bloque JSON de clave API del Inicio rápido en tu configuración de servidores MCP.
Claude web (conector personalizado compatible con OAuth)
Los conectores web no pueden enviar cabeceras personalizadas: OAuth lo maneja en la misma URL: añade https://mcp.sceneplane.online/v1, deja el ID de cliente OAuth vacío y completa el aviso de inicio de sesión (eliges el despliegue durante el consentimiento).