Sceneplane
Blender em nuvem para agentes de IA: projetos duráveis, revisões imutáveis, operações seguras de cena, renders, MP4, STL e GLB via MCP remoto hospedado.
Documentação
Documentação
O Sceneplane oferece aos agentes de IA computação Blender isolada na nuvem: projetos duráveis, estado de cena versionado e renderização assíncrona — por meio de um único endpoint MCP remoto. Cada saída é sua para baixar: renders, exportações GLB/OBJ/STL e os arquivos de projeto .blend. Tudo abaixo se aplica igualmente a agentes e a humanos que usam o dashboard.
Início rápido
Para um primeiro resultado sem configuração de agente, cadastre-se e escolha um starter de navegador. Você inicia explicitamente um pequeno trabalho predefinido dentro da sua cota da conta, acompanha o progresso e obtém um projeto editável, além de uma pré-visualização 3D e uma imagem. A criação personalizada usa um agente conectado.
- Cadastre-se gratuitamente. Você recebe 30 minutos de computação por mês UTC; não é necessário cartão de crédito.
- Abra Conecte seu agente no dashboard e escolha seu cliente. Clientes compatíveis recebem um link de instalação ou um comando pronto para copiar.
- Conclua o login no navegador e selecione seu workspace quando solicitado. Sua organização Personal e o deployment padrão são provisionados automaticamente na primeira conexão.
- Copie o prompt de primeiro projeto mostrado ali para o seu agente. Ele cria um plantador simples, renderiza uma pré-visualização de 512 pixels e exporta um GLB usando a cota Free. Peça ao agente para compartilhar sua pré-visualização ao vivo e os links de download concluídos.
Crie um primeiro projeto útil
Cada link seleciona um preset de navegador após o cadastro. Nada é executado até você clicar em Criar projeto starter. Aguarde alguns minutos de computação; o tempo real de worker vem da sua cota da conta. Contas gratuitas têm 30 minutos por mês UTC e não precisam de cartão de crédito. Esses presets não usam serviços externos pagos de geração.
Uma cena de produto
- Escolha o starter de plantador de cerâmica e crie-o.
- Acompanhe a página ao vivo até o trabalho concluir e baixe o GLB ou a imagem da pré-visualização. A cena Blender salva permanece no workspace do projeto.
- Use Altere com seu agente na mesma página. Copie o prompt específico do projeto e pergunte: “Mantenha este projeto. Mude a cerâmica para verde sálvia e faça um render de produto de 512px dentro da minha computação restante.”
Um adereço para seu jogo
- Escolha o starter de adereço de jogo e crie-o.
- Inspecione a caixa na pré-visualização GLB. A pré-visualização inclui a cena de estúdio; não é uma garantia de asset pronto para jogo.
- Conecte seu agente pela página ao vivo e pergunte: “Neste projeto existente, selecione apenas as partes da caixa, remova o estúdio da exportação, verifique a validação de asset de jogo e exporte um GLB para meu motor. Mantenha os materiais e verifique minha computação primeiro.” Informe qual motor você usa.
Um modelo em escala real
- Escolha o starter de modelo em escala de 20 mm e crie-o.
- Inspecione o bloco e suas bordas arredondadas. O preset de navegador fornece uma cena e uma pré-visualização, não um arquivo de impressão validado.
- Conecte seu agente e pergunte: “Inspecione o bloco de 20 mm neste projeto. Verifique as dimensões e execute uma validação profunda de impressão 3D. Resolva quaisquer problemas relatados antes de exportar apenas o bloco como STL em milímetros. Exclua o Studio Floor. Entregue também o .blend editável e verifique minha computação primeiro.”
Continue com seu agente habitual
No diálogo de conexão do dashboard, selecione seu cliente. Cursor e VS Code têm links de instalação. Claude Code usa claude mcp add --transport http sceneplane https://mcp.sceneplane.online/v1, seguido de /mcp para entrar. Codex usa codex mcp add sceneplane --url https://mcp.sceneplane.online/v1, depois codex mcp login sceneplane. Nenhuma edição de arquivo é necessária para esses caminhos OAuth. Seu cliente escolhido é lembrado neste dispositivo.
Conectores personalizados do ChatGPT e do Claude dependem do plano e da permissão do workspace. O diálogo explica esses requisitos e mantém um fallback de chave de API com escopo em Avançado. As cobranças do cliente e do provedor de modelo são separadas da cota Free do Sceneplane. Se um trabalho falhar, abra o workspace do projeto para tentar reiniciar a inicialização; atualizar a página ao vivo não cria um novo projeto.
Referências de clientes: Cursor MCP, VS Code MCP, Codex MCP, Claude Code MCP.
Avançado: configuração de chave de API
Para um cliente compatível com cabeçalho que exige configuração manual, crie uma chave de API em Início → Chaves de API e conecte-se a https://mcp.sceneplane.online/v1 com seu cabeçalho bearer:
{
"mcpServers": {
"sceneplane": {
"url": "https://mcp.sceneplane.online/v1",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}
Execute platform_status para confirmar a prontidão e os limites atuais e peça ao seu agente para criar um projeto. project_create retorna um trabalho de inicialização; aguarde a conclusão com job_wait antes de editar a cena.
Autenticação
Chaves de API (para clientes compatíveis com cabeçalho)
As chaves têm a aparência de sp_…, são criadas no dashboard, exibidas exatamente uma vez e armazenadas no servidor apenas como hash SHA-256. Revogar uma chave a bloqueia na próxima solicitação. Uma chave atua como sua conta: suas permissões em cada deployment seguem o papel da sua organização (proprietário, administrador, editor, visualizador).
OAuth (para conectores compatíveis com OAuth)
Conectores baseados na web (por exemplo, conectores personalizados do Claude web) executam OAuth authorization-code + PKCE — contra a mesma URL: adicione https://mcp.sceneplane.online/v1 sem cabeçalho Authorization e deixe o ID do cliente vazio (registro dinâmico é compatível). Você será redirecionado para entrar e escolher o deployment ao qual o conector será vinculado durante o consentimento.
Deployments e vinculação
Um deployment é um ambiente de computação Blender isolado com sua própria política e projetos. Os limites de computação e armazenamento são compartilhados na conta. Cada solicitação MCP vincula-se a um deployment:
- um deployment na conta → vinculado automaticamente;
- nenhum → um deployment padrão é provisionado na primeira chamada;
- vários → o mais recentemente atualizado é vinculado; fixe explicitamente com
https://mcp.sceneplane.online/v1?deployment=<slug>(vejadeployments_list).
Catálogo de ferramentas
Ferramentas de cena e projeto (com escopo de deployment)
| Ferramenta | O que faz |
|---|---|
projects_list | Lista projetos Blender na implantação vinculada (paginação por cursor). |
project_create | Cria um projeto a partir de um modelo (empty, product_studio, three_point_lighting, low_poly, print_ready); retorna o job de inicialização assíncrono. |
project_get | Detalhes do projeto: revisão principal, revisões recentes, jobs ativos, artefato de pré-visualização. |
scene_inspect | Resumo estruturado da cena de uma revisão. Objetos, materiais, câmeras e luzes paginam independentemente pelo detalhe solicitado; o modo completo pagina cada coleção no mesmo deslocamento. Siga nextCursor até null. |
scene_apply | Aplica um lote validado de operações de cena contra a revisão principal; confirma uma nova revisão imutável (job assíncrono). |
scene_validate | Valida uma revisão contra um perfil (general, render, game_asset, three_d_print). deep=true executa análise real de malha no Blender — estanqueidade, saliências e um relatório de impressão 3D com dimensões, volume, estimativa de filamento e ajuste na cama. |
scene_snapshot | Lê uma miniatura armazenada ou PNG inline sem renderizar. Verifique a revisão de origem, o motor e o enquadramento: imagens herdadas mostram trabalho anterior. Novas pré-visualizações usam a câmera ativa/proporção, limites da cena sem câmera e Cycles com 16 amostras para transmissão iluminada (EEVEE para outras cenas iluminadas, fallback Workbench). platform_status e docs_operations guide=true retornam a snapshotPolicy ao vivo versionada quando as descrições em cache diferem; atualize a descoberta ou reconecte clientes obsoletos. |
scene_script | Executa Python arbitrário do Blender (bpy) contra uma revisão, confirmando o resultado. Desabilitado por padrão — um proprietário ativa scripts por implantação (Configurações → Política). Executa em um contêiner isolado e sem credenciais. |
docs_bpy_lookup / docs_bpy_search | Referência autoritativa da API Python do Blender como ferramentas — agentes verificam assinaturas, membros e enums do bpy antes de escrever código scene_script, com descoberta de namespace e sugestões "você quis dizer". |
docs_manual_search / docs_manual_get | Pesquisa de texto completo em todo o manual do usuário do Blender (mais de 2.100 páginas) — respostas conceituais sobre como modificadores, sombreamento, física e fluxos de trabalho se comportam, com trechos classificados e leituras de página completa. |
asset_preview / assets_categories | Veja a miniatura de um ativo como imagem real antes de importar e navegue pelas categorias do Poly Haven com contagens. |
assets_search | Pesquisa fontes de ativos gratuitos por palavra-chave: Poly Haven CC0 (HDRIs, conjuntos de texturas PBR, modelos — sem configuração) ou modelos baixáveis do Sketchfab (token BYO). Retorna slugs para asset_library_import. |
asset_library_import | Importa um ativo de biblioteca por slug: HDRIs tornam-se o ambiente do mundo, modelos são adicionados à cena, conjuntos de texturas tornam-se um material PBR conectado que você pode atribuir automaticamente a objetos (job assíncrono). Fontes: polyhaven, sketchfab, hyper3d, hunyuan3d, tripo3d. |
material_from_image | Cria um material a partir de uma imagem validada. O fluxo de trabalho surface/decal prepara mapas rotulados por função; o fluxo de trabalho legado de máscara permanece disponível. Rugosidade e relevo derivados de imagem são aproximações, não propriedades de material medidas (job assíncrono). |
texture_maps_create / material_from_maps | Prepara mapas baixáveis, ZIP, manifesto e pré-visualização de repetição sem alterar a cena; depois aplique o pacote concluído com material_from_maps. Atribuir a objetos substitui os slots de material solicitados e confirma uma nova revisão; as UVs da malha são preservadas. |
image_prompt_assist / material_recipe / material_nodes | Planeje imagens de origem para o gerador de imagens do seu harness, proponha grafos de shader procedurais/híbridos editáveis e inspecione sockets de nós suportados. Essas ferramentas retornam orientação ou propostas sem chamar um provedor de imagens ou usar computação do Blender; execute operações de shader revisadas com scene_apply. |
presets_list / preset_apply | Presets curados de uma chamada: materiais PBR (vidro, cromo, ouro, neon…), rigs de iluminação (estúdio de três pontos, softbox, pôr do sol…), enquadramentos de câmera (herói, topo, isométrico…) e perfis de render (rascunho, produção). Compila para operações de cena validadas. |
webhooks_set / webhooks_list / webhook_test / webhooks_delete | Push em vez de polling: registre uma URL https e receba POSTs assinados com HMAC em job.completed / job.failed / job.cancelled. O segredo de assinatura é mostrado uma vez; testar entregas sob demanda. |
job_wait | Long-poll de um job até 25s por chamada — retorna no momento em que atinge um estado terminal. Encadeie chamadas para jobs mais longos. |
platform_status | Descoberta de capacidade: se a execução do Blender está disponível no momento, contagens de jobs abertos e os limites de política da implantação — falhe rápido em vez de enfileirar jobs condenados. |
project_update / project_delete | Renomeia ou exclui suavemente projetos (exclusão recusa enquanto jobs estão abertos). |
deployment_policy_update | Ajuste de política self-service via MCP: timeouts, profundidade de fila, limites de render e ativação de scene_script (somente proprietário) — sem necessidade de dashboard. |
asset_generate_3d / asset_generate_status | Texto ou imagem → modelo 3D via Hyper3D Rodin, Tencent Hunyuan3D ou Tripo3D (chaves BYO). Inicie, faça polling e depois importe o modelo concluído com asset_library_import — opcionalmente escalado para um targetSize do mundo real. |
integrations_set / integrations_list / integrations_delete | Credenciais de fontes de terceiros gerenciadas por agente (Sketchfab, Hyper3D, Hunyuan3D, Tripo3D), criptografadas em repouso — configure uma vez via MCP, sem necessidade de dashboard. |
upload_create / upload_complete | Upload direto em duas etapas para ativos (PUT assinado, depois finalize + escaneie). |
asset_import | Importa um ativo enviado validado (blend, glb, gltf, obj, stl, imagem ou fonte) para um projeto como nova revisão (job assíncrono). |
render_create | Enfileira um render Cycles de uma revisão (largura/altura/amostras/transparência; limitado por política; job assíncrono). |
render_turntable | 2-12 vistas de órbita uniformemente espaçadas em UM job — pré-visualizações Workbench quase instantâneas ou frames Cycles iluminados, cada um visualizável inline via scene_snapshot. targetObjectIds orbita e enquadra apenas esses objetos, então fotos de produto mantêm pisos e fundos fora do quadro sem ocultá-los. |
render_animation | Sequência com keyframes → MP4 H.264 em um job (até 600 frames; Cycles ou pré-visualização rápida). Sequências longas renderizam como jobs de segmentos paralelos em faixas de frames contíguas — segmentos MP4 seguros para concatenação. |
export_create | Exporta uma revisão para glb, obj, stl ou blend. Presets de motor aplicam convenções de destino — unity, unreal, godot e print (STL escalado de metros→milímetros para que slicers leiam o tamanho real). |
revision_diff | Compara duas revisões sem alterar a cena: objetos adicionados/removidos, transformações, materiais e configurações de render. Revise isso antes de restaurar uma cena anterior. |
revision_restore | Substitui a cena ativa por uma revisão mais antiga como novo commit principal; edições posteriores deixam a vista ativa, enquanto revisões anteriores permanecem disponíveis. Requer a revisão principal atual exata e pode exigir aprovação interativa (job assíncrono). |
artifact_get | Metadados + URL de download expirante para um render, exportação ou artefato de pré-visualização. |
job_get / jobs_list / job_cancel / job_report | Faça polling de um job, encontre jobs recentes, solicite cancelamento cooperativo ou leia páginas de relatório completas. Cancelamento é uma solicitação, não um resultado terminal; faça polling de job_get/job_wait para confirmar o que aconteceu. |
Ferramentas de conta (sujeitas ao escopo de credenciais)
As concessões OAuth são limitadas ao workspace consentido. Chaves de API seguem seus escopos e seu papel na organização.
| Ferramenta | O que faz |
|---|---|
organizations_list | Organizações às quais esta conta pertence, com seu papel. |
deployments_list | Toda implantação acessível; sinaliza a qual esta sessão está vinculada. |
deployment_create | Cria uma nova implantação isolada (proprietário/admin). |
deployment_update | Renomeia ou ativa/desativa uma implantação (proprietário/admin). |
deployment_delete | Exclui uma implantação vazia (proprietário/admin). |
Operações de cena
scene_apply recebe um lote de operações tipadas e validadas — não código arbitrário. Cada lote é verificado contra a cena atual (referências devem existir, nomes devem ser únicos) e confirmado atomicamente como uma nova revisão com uma pré-visualização nova.
| Família | Operações |
|---|---|
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 (colapso/redução planar), remesh (retopologia voxel/QuadriFlow), tris_to_quads, make_printable (preparação de impressão em uma operação: remesh estanque + orçamento de triângulos + posicionamento na cama), lathe (revolução de um perfil [radius,z] — latas, garrafas, copos) |
uv.cylindrical_project | Posicionamento paramétrico de rótulos em cilindros: cobertura de arco, azimute central, extensão vertical, fixação de tampa |
light.* | upsert (ponto/sol/spot/área com energia e cor), delete |
camera.* | upsert (lente, clip, sensor, profundidade de campo: fstop / focusDistance / focusObject — o foco acompanha o objeto através de movimentos de câmera), look_at (re-foca automaticamente no alvo quando DOF está ativo), set_active, delete |
world.update | cor de fundo / intensidade |
render_settings.update | resolução, amostras, configurações do motor |
animation.* | set_range (extensão de frames + fps), keyframe_transform (localização explícita / escala / alvo lookAt por momento — conjunto e keyframe atômicos), keyframe_camera (puxadas de lente / abertura / foco), remove_keyframes — controle de interpolação incl. retenção constante para cortes secos |
Lotes executam dentro do Blender real (bpy) em um contêiner isolado. Use scene_validate para um dry-run gratuito antes de confirmar.
Jobs e revisões
Qualquer coisa que toque o Blender é assíncrona: a ferramenta retorna um handle de job imediatamente (jobId, status, pollAfterMs); faça polling com job_get. Status: queued → awaiting_capacity → preparing → starting_container → running → uploading_outputs → committing → completed (ou failed / cancelled). O progresso flui ao vivo para o dashboard.
O estado da cena é uma cadeia de revisões imutáveis. Escritores concorrentes são seguros: um lote confirma somente se a revisão principal contra a qual foi construído ainda é a principal (compare-and-swap); caso contrário, o job falha limpo e o agente tenta novamente contra a nova principal. revision_restore faz rollback copiando uma revisão antiga para frente — o histórico nunca é reescrito.
Pré-visualização ao vivo
Seu agente compartilha um link Assistir pré-visualização ao vivo assim que cria seu projeto, antes de começar a construir. Você também pode abrir Pré-visualização ao vivo no workspace do projeto. Entre com uma conta que tenha acesso ao projeto. O mesmo liveUrl retornado por project_create ou project_get funciona durante toda a sua conversa.
A página mostra progresso do job, renders concluídos e um modelo interativo assim que sua exportação 3D está pronta, enquanto a imagem de pré-visualização termina de renderizar. Sua câmera permanece no lugar entre atualizações. Use a visualização de imagem para uma pré-visualização mais leve ou pause as atualizações a qualquer momento. Visualizar a página não consome minutos de computação do Blender.
Limites e políticas (plano gratuito)
| Política | Padrão |
|---|---|
| Jobs concorrentes por implantação | 1 (fila de até 10) |
| Timeout do job | 300 s |
| Limites de render | 1024 × 1024 px, 128 amostras |
| Limite de upload | 100 MB por arquivo |
| Solicitações de ferramenta | 120 / minuto por implantação |
| Python arbitrário (scene_script) | desabilitado por padrão; opt-in do proprietário por implantação |
Proprietários podem ajustar políticas por implantação no dashboard; limites rígidos da plataforma se aplicam.
Configuração do cliente
— escolha seu cliente para links de instalação, login no navegador ou um comando pronto para copiar. Sem edição de arquivos de configuração para clientes OAuth suportados. Seu workspace é provisionado automaticamente na primeira conexão.
Smithery
Abra o Sceneplane no Smithery para navegar pelas ferramentas, recursos e prompts ao vivo ou adicionar o servidor ao seu cliente MCP. Entre na sua conta Sceneplane quando seu cliente solicitar consentimento OAuth.
Claude Code
claude mcp add sceneplane https://mcp.sceneplane.online/v1 \
--transport http --header "Authorization: Bearer <YOUR_API_KEY>"
Claude Desktop / qualquer cliente JSON-config com suporte a headers
Use o bloco JSON da chave de API do Quickstart na configuração dos seus servidores MCP.
Claude web (conector personalizado compatível com OAuth)
Conectores web não podem enviar cabeçalhos personalizados — o OAuth lida com isso na mesma URL: adicione https://mcp.sceneplane.online/v1, deixe o ID do cliente OAuth vazio e conclua o prompt de login (você escolhe a implantação durante o consentimento).