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 se aplica por igual a agentes y a humanos que usan el panel de control.
Inicio rápido
Para obtener un primer resultado sin configuración de agente, regístrate y elige un iniciador de navegador. Inicias explícitamente un pequeño trabajo predefinido dentro de tu asignación de cuenta, ves su progreso y obtienes un proyecto editable, una vista previa 3D y una imagen. La creación personalizada utiliza un agente conectado.
- Regístrate gratis. Obtienes 30 minutos de cómputo por mes UTC; no se necesita tarjeta de crédito.
- Abre Conecta tu agente en el panel de control y elige tu cliente. Los clientes compatibles obtienen un enlace de instalación o un comando listo para copiar.
- Completa el inicio de sesión en el navegador y selecciona tu espacio de trabajo cuando se te solicite. Tu organización Personal y la implementación predeterminada se aprovisionan automáticamente en la primera conexión.
- Copia el prompt del primer proyecto que se muestra allí en tu agente. Este crea una maceta simple, renderiza una vista previa de 512 píxeles y exporta un GLB usando la asignación gratuita. Pide a tu agente que comparta tu vista previa en vivo y los enlaces de descarga completados.
Crea un primer proyecto útil
Cada enlace selecciona un ajuste predefinido de navegador después del registro. Nada se ejecuta hasta que haces clic en Crear proyecto inicial. Permite unos minutos de cómputo; el tiempo real de trabajo proviene de tu asignación de cuenta. Las cuentas gratuitas tienen 30 minutos por mes UTC y no necesitan tarjeta de crédito. Estos ajustes predefinidos no usan servicios externos de generación de pago.
Una escena de producto
- Elige el iniciador de maceta de cerámica y créalo.
- Observa la página en vivo hasta que el trabajo se complete, luego descarga la vista previa GLB o la imagen. La escena de Blender guardada permanece en el espacio de trabajo del proyecto.
- Usa Cámbialo con tu agente en esa misma página. Copia su prompt específico del proyecto y luego pregunta: "Mantén este proyecto. Cambia la cerámica a verde salvia y haz un render de producto de 512px dentro de mi cómputo restante".
Un accesorio para tu juego
- Elige el iniciador de accesorio de juego y créalo.
- Inspecciona la caja en la vista previa GLB. La vista previa incluye la escena de estudio; no es una afirmación de un activo listo para el juego.
- Conecta tu agente desde su página en vivo y pregunta: "En este proyecto existente, selecciona solo las partes de la caja, elimina el estudio de la exportación, verifica la validación de activos de juego y exporta un GLB para mi motor. Mantén los materiales y verifica mi cómputo primero". Dile qué motor usas.
Un modelo a escala real
- Elige el iniciador de modelo a escala de 20 mm y créalo.
- Inspecciona el bloque y sus bordes redondeados. El ajuste predefinido de navegador proporciona una escena y una vista previa, no un archivo de impresión validado.
- Conecta tu agente y pregunta: "Inspecciona el bloque de 20 mm en este proyecto. Verifica las dimensiones y ejecuta una validación profunda de impresión 3D. Resuelve cualquier problema reportado antes de exportar solo el bloque como STL en milímetros. Excluye el piso de estudio. Dame también el .blend editable y verifica mi cómputo primero".
Continúa desde tu agente habitual
En el diálogo de conexión del panel de control, selecciona tu cliente. Cursor y VS Code tienen enlaces de instalación. Claude Code usa claude mcp add --transport http sceneplane https://mcp.sceneplane.online/v1, seguido de /mcp para iniciar sesión. Codex usa codex mcp add sceneplane --url https://mcp.sceneplane.online/v1, luego codex mcp login sceneplane. No se necesita edición de archivos para estas rutas OAuth. Tu cliente elegido se recuerda en este dispositivo.
Los conectores personalizados de ChatGPT y Claude dependen del plan y los permisos del espacio de trabajo. El diálogo explica esos requisitos y mantiene una alternativa de clave API con alcance bajo Avanzado. Los cargos del cliente y del proveedor de modelos son separados de la asignación gratuita de Sceneplane. Si un trabajo falla, abre su espacio de trabajo de proyecto para reintentar la inicialización; actualizar la página en vivo no crea un proyecto nuevo.
Referencias de clientes: Cursor MCP, VS Code MCP, Codex MCP, Claude Code MCP.
Avanzado: configuración de clave API
Para un cliente compatible con encabezados que necesita configuración manual, crea una clave API en Inicio → Claves API y conéctate a https://mcp.sceneplane.online/v1 con su encabezado de portador:
{
"mcpServers": {
"sceneplane": {
"url": "https://mcp.sceneplane.online/v1",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}
Ejecuta platform_status para confirmar la disponibilidad y los límites actuales, luego pide a tu agente que cree un proyecto. project_create devuelve un trabajo de inicialización; espera su finalización con job_wait antes de editar la escena.
Autenticación
Claves API (para clientes compatibles con encabezados)
Las claves se ven como sp_…, se crean en el panel de control, se muestran exactamente una vez y se almacenan en el servidor solo como un hash SHA-256. Revocar una clave la bloquea en su próxima solicitud. Una clave actúa como tu cuenta: sus permisos en cada implementación siguen tu rol de organización (propietario, administrador, editor, visor).
OAuth (para conectores compatibles con OAuth)
Los conectores basados en web (por ejemplo, conectores personalizados web de Claude) ejecutan OAuth de código de autorización + PKCE en su lugar, contra la misma URL: agrega https://mcp.sceneplane.online/v1 sin encabezado de Autorización y deja el ID de cliente vacío (se admite registro dinámico). Serás redirigido para iniciar sesión y elegir la implementación a la que el conector estará vinculado durante el consentimiento.
Implementaciones y vinculación
Una implementación es un entorno de cómputo de Blender aislado con su propia política y proyectos. Los límites de cómputo y almacenamiento se comparten en toda la cuenta. Cada solicitud MCP se vincula a una implementación:
- una implementación en la cuenta → vinculada automáticamente;
- ninguna → se aprovisiona una implementación predeterminada en la primera llamada;
- varias → se vincula la más recientemente actualizada; fija explícitamente con
https://mcp.sceneplane.online/v1?deployment=<slug>(verdeployments_list).
Catálogo de herramientas
Herramientas de escena y proyecto (con ámbito de implementación)
| Herramienta | Qué hace |
|---|---|
projects_list | Lista proyectos de Blender en el despliegue vinculado (paginación por cursor). |
project_create | Crea un proyecto desde una plantilla (vacía, 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 y luces se paginan de forma independiente según el detalle solicitado; el modo completo pagina cada colección con el mismo desplazamiento. Sigue nextCursor hasta que sea null. |
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 de malla real en Blender: estanqueidad, voladizos e informe de impresión 3D con dimensiones, volumen, estimación de filamento y ajuste en la cama. |
scene_snapshot | Lee una miniatura almacenada o PNG en línea sin renderizar. Comprueba la revisión de origen, el motor y el encuadre: las imágenes heredadas muestran trabajo anterior. Las nuevas vistas previas usan la cámara activa/relación de aspecto, los límites de la escena sin cámara y Cycles de 16 muestras para transmisión iluminada (EEVEE para otras escenas iluminadas, respaldo Workbench). platform_status y docs_operations guide=true devuelven la snapshotPolicy en vivo versionada cuando las descripciones en caché difieren; actualiza el descubrimiento o reconecta clientes obsoletos. |
scene_script | Ejecuta Python arbitrario de Blender (bpy) contra una revisión, confirmando el resultado. Deshabilitado por defecto: un propietario habilita el scripting por despliegue (Configuración → Política). Se ejecuta en un contenedor aislado y 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 enums 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 importar y explora 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 (token propio). 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 | Crea un material a partir de una imagen validada. El flujo de trabajo de superficie/decal prepara mapas etiquetados por rol; el flujo de trabajo de máscara heredado sigue disponible. La rugosidad y el relieve derivados de la imagen son aproximaciones, no propiedades de material medidas (trabajo asíncrono). |
texture_maps_create / material_from_maps | Prepara mapas descargables, ZIP, manifiesto y vista previa de repetición sin cambiar la escena; luego aplica el paquete completado con material_from_maps. Asignar a objetos reemplaza las ranuras de material solicitadas y confirma una nueva revisión; los UVs de la malla se conservan. |
image_prompt_assist / material_recipe / material_nodes | Planifica imágenes de origen para el generador de imágenes de tu arnés, propone gráficos de sombreado procedurales/híbridos editables e inspecciona los sockets de nodos compatibles. Estas herramientas devuelven orientación o propuestas sin llamar a un proveedor de imágenes ni usar cómputo de Blender; ejecuta operaciones de sombreado revisadas con scene_apply. |
presets_list / preset_apply | Presets curados 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; entregas de prueba bajo demanda. |
job_wait | Sondear 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 los 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 suavemente proyectos (eliminar se rechaza mientras haya trabajos abiertos). |
deployment_policy_update | Ajuste de políticas 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. |
asset_generate_3d / asset_generate_status | Texto o imagen → modelo 3D mediante Hyper3D Rodin, Tencent Hunyuan3D o Tripo3D (claves propias). 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 agente (Sketchfab, Hyper3D, Hunyuan3D, Tripo3D), cifradas en reposo: configura una vez a través de MCP, sin necesidad de panel. |
upload_create / upload_complete | Carga directa en dos pasos para activos (PUT firmado, luego finalizar + escanear). |
asset_import | Importa un activo cargado validado (blend, glb, gltf, obj, stl, imagen o fuente) en un proyecto como nueva revisión (trabajo asíncrono). |
render_create | Pone en cola un render de Cycles de una revisión (ancho/alto/muestras/transparencia; limitado por política; trabajo asíncrono). |
render_turntable | De 2 a 12 vistas de órbita espaciadas uniformemente en UN trabajo: vistas previas de Workbench casi instantáneas o fotogramas de Cycles iluminados, cada uno visible en línea mediante scene_snapshot. targetObjectIds orbita y enmarca solo esos objetos, por lo 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 segmentos 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 rebanadoras lean el tamaño real). |
revision_diff | Compara dos revisiones sin cambiar la escena: objetos añadidos/eliminados, transformaciones, materiales y ajustes de render. Revisa esto antes de restaurar una escena anterior. |
revision_restore | Reemplaza la escena activa con una revisión anterior como nuevo commit principal; las ediciones posteriores dejan la vista activa, mientras que las revisiones anteriores siguen disponibles. Requiere la cabeza actual exacta y puede requerir aprobación interactiva (trabajo asíncrono). |
artifact_get | Metadatos + URL de descarga con caducidad para un render, exportación o artefacto de vista previa. |
job_get / jobs_list / job_cancel / job_report | Sondea un trabajo, encuentra trabajos recientes, solicita cancelación cooperativa o lee páginas de informes completas. La cancelación es una solicitud, no un resultado terminal; sondea job_get/job_wait para confirmar lo que sucedió. |
Herramientas de cuenta (sujetas al alcance de credenciales)
Las concesiones de OAuth se limitan al espacio de trabajo consentido. Las claves API siguen sus alcances y tu rol organizativo.
| Herramienta | Qué hace |
|---|---|
organizations_list | Organizaciones a las que pertenece esta cuenta, con tu rol. |
deployments_list | Cada despliegue accesible; indica cuál está vinculado a esta sesión. |
deployment_create | Crea un nuevo despliegue aislado (propietario/admin). |
deployment_update | Renombra o habilita/deshabilita un despliegue (propietario/admin). |
deployment_delete | Elimina un despliegue vacío (propietario/admin). |
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 fresca.
| 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 en el objetivo cuando DOF está activado), set_active, delete |
world.update | color de fondo / intensidad |
render_settings.update | resolución, muestras, ajustes de motor |
animation.* | set_range (extensión de fotogramas + fps), keyframe_transform (ubicación explícita / escala / apuntado lookAt por momento — conjunto y clave atómica), keyframe_camera (lente / apertura / tirones de 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.
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.
Vista previa en vivo
Tu agente comparte un enlace de Ver vista previa en vivo tan pronto como crea tu proyecto, antes de comenzar a construir. También puedes abrir Vista previa en vivo desde el espacio de trabajo del proyecto. Inicia sesión con una cuenta que tenga acceso al proyecto. El mismo liveUrl devuelto por project_create o project_get funciona durante toda tu conversación.
La página muestra el progreso del trabajo, renders completados y un modelo interactivo tan pronto como su exportación 3D está lista, mientras la imagen de vista previa termina de renderizar. Tu cámara permanece en su lugar entre actualizaciones. Usa la vista de Imagen para una vista previa más ligera o pausa las actualizaciones en cualquier momento. Ver la página no consume minutos de cómputo de Blender.
Límites y políticas (plan gratuito)
| Política | Predeterminado |
|---|---|
| Trabajos concurrentes por despliegue | 1 (en cola hasta 10) |
| Tiempo de espera del trabajo | 300 s |
| Límites de render | 1024 × 1024 px, 128 muestras |
| Límite de carga | 100 MB por archivo |
| Solicitudes de herramientas | 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; se aplican límites duros de plataforma.
Configuración del cliente
— elige tu cliente para enlaces de instalación, inicio de sesión en navegador o un comando listo para copiar. Sin edición de archivos de configuración para clientes OAuth compatibles. Tu espacio de trabajo se aprovisiona automáticamente en la primera conexión.
Smithery
Abre Sceneplane en Smithery para explorar las herramientas, recursos y prompts en vivo o añadir el servidor a tu cliente MCP. Inicia sesión en tu cuenta de Sceneplane cuando tu cliente solicite consentimiento OAuth.
Claude Code
claude mcp add sceneplane https://mcp.sceneplane.online/v1 \
--transport http --header "Authorization: Bearer <YOUR_API_KEY>"
Claude Desktop / cualquier cliente JSON-config con capacidad de encabezados
Usa el bloque JSON de la clave de API del Quickstart en la configuración de tus servidores MCP.
Claude web (conector personalizado compatible con OAuth)
Los conectores web no pueden enviar encabezados personalizados: OAuth lo maneja en la misma URL: agrega https://mcp.sceneplane.online/v1, deja vacío el ID de cliente de OAuth y completa el aviso de inicio de sesión (tú eliges el despliegue durante el consentimiento).