Pascal 3D: cenas editáveis com MCP e validação antes do link

ANÁLISE EDITORIAL

Uma casa vista no navegador pode parecer pronta e ainda assim ser apenas uma imagem. A Pascal 3D tenta evitar essa confusão: ela orienta o agente a trabalhar sobre uma cena semântica editável, conferir o que mudou, validar o grafo, salvar o projeto e devolver somente a URL fornecida pelo próprio Pascal. O foco não é produzir uma renderização bonita por improviso. É manter paredes, ambientes, portas, janelas, níveis e objetos como elementos identificáveis, com um estado que possa ser relido.

A Skill foi publicada pelo próprio projeto Pascal Editor e entrou na versão estável 1.0.0 do produto. Há dois caminhos de conexão, local e hospedado, e eles têm limites de dados diferentes. Essa escolha vem antes da primeira ferramenta. Usar a conta errada, manter dois clientes ligados ao mesmo serviço local ou tratar uma resposta HTTP como prova de que a cena foi salva são erros que a documentação procura bloquear.

O que esta Skill faz

A Pascal 3D no commit auditado ensina um agente compatível com MCP a conectar-se ao Pascal, localizar ou criar um projeto, inspecionar a cena, realizar uma alteração delimitada, validar o resultado e persistir o trabalho. Ela também define como responder quando um recurso não existe no servidor conectado.

O princípio central é simples: o Pascal deve ser a autoridade sobre a cena. O agente prefere operações semânticas, como criar ambiente, adicionar porta ou localizar nós, em vez de montar JSON manualmente ou deduzir dimensões pela aparência. Depois da mudança, ele relê o alvo, executa validações e registra IDs, versão, quantidade de nós e hash do grafo quando esses dados são retornados.

Para quem serve

Ela serve a quem usa agentes para criar ou revisar modelos de edifícios, interiores e espaços em uma ferramenta editável. Arquitetos, projetistas, equipes de produto, desenvolvedores de integrações e usuários que mantêm gêmeos digitais podem aproveitar o fluxo. A Skill é particularmente útil quando a entrega precisa continuar aberta a correções, e não terminar em uma figura plana sem origem verificável.

Ela não substitui cálculo estrutural, aprovação arquitetônica, levantamento de campo, verificação regulatória nem revisão de um profissional habilitado. O site oficial do Pascal Editor apresenta o produto como editor 3D de edifícios e informa que o mecanismo é aberto. Isso descreve a plataforma. Não transforma a saída de um agente em projeto executivo ou certificado.

Origem, adoção e versão

A curadoria fixou o repositório pascalorg/editor no commit 58a6b65817fed250884d1731b751e727436ec581. Na consulta de 14 de setembro de 2026, o repositório tinha 23.901 estrelas e 2.963 forks, não estava arquivado e declarava licença MIT.

Há três números diferentes, e misturá-los seria enganoso. O SKILL.md declara versão 0.1.0. A release estável do Pascal Editor 1.0.0, publicada em 12 de setembro de 2026, inclui as Skills públicas Pascal 3D e Furniture Fit. O manifesto do MCP Registry citado pelo mantenedor usa uma versão própria do servidor. Cada número descreve um artefato diferente.

Compatibilidade e pré-requisitos

O host precisa entender Agent Skills e conseguir conectar ferramentas MCP. Para o caminho local, a Skill exige Node.js 22.13 ou superior e o Pascal CLI. A referência oficial de configuração informa que o modo local não requer conta nem chave de API.

O caminho hospedado usa https://editor.pascal.app/api/mcp. Para abrir projetos de uma pessoa ou organização, a credencial deve ser criada pelo titular no espaço correspondente. A chave não pertence ao texto da Skill, ao repositório, ao histórico do terminal nem a uma captura de tela. O pacote desta página não contém nenhuma credencial.

O servidor conectado pode ter ferramentas diferentes das descritas no código mais recente. Por isso a primeira leitura deve ser do guia anunciado pelo próprio servidor e dos esquemas realmente disponíveis. Capacidade presente no repositório não prova que uma instalação antiga ou o endpoint hospedado já a oferece.

Escolha a fronteira de dados antes de conectar

Local é a escolha natural quando o projeto deve permanecer na máquina atual. A documentação informa que os dados locais ficam, por padrão, em um banco sob o diretório do usuário. O agente não deve enviar esse projeto para a nuvem somente para concluir a configuração.

Hospedado em conta existente é o caminho para trabalhar em um projeto que já pertence ao usuário ou à organização. A chave precisa apontar para esse mesmo espaço. Criar uma conta autônoma separada não resolve o problema, porque o novo projeto não aparece automaticamente na conta da pessoa.

Hospedado autônomo só entra em cena quando o pedido autoriza de forma explícita criar uma conta privada separada para o agente. A exemplo oficial de conta autônoma deixa claro que isso muda a propriedade do projeto e exige proteção da chave recebida.

Instalação com origem fixada

O README oficial das Skills documenta a instalação pelo Skills CLI. Para instalar somente a Pascal 3D no projeto, o comando apresentado pelo catálogo é:

npx skills add pascalorg/editor --skill pascal-3d

Esse comando consulta a rede, executa um pacote via npx e grava arquivos. Faça primeiro em um projeto descartável, confira o destino e compare o conteúdo com a pasta oficial fixada. O repositório também documenta instalação como plugin para Codex e Claude Code, mas registrar um plugin e conectar um servidor hospedado são ações diferentes.

O ZIP local desta página é uma cópia documental para leitura e auditoria. Ele não instala o Pascal, não inicia MCP e não adiciona uma chave. Use o botão de download do card para conferir os arquivos preservados e o botão separado do repositório para acompanhar a origem.

Configuração sem expor chaves

No modo local, instale a versão aprovada do Pascal CLI, inicie o editor quando houver necessidade visual e registre somente o conector do host ativo. O mantenedor alerta que dois clientes de agente ligados ao mesmo serviço local compartilham o estado da cena. Para trabalhos independentes, use processos e diretórios de dados separados.

No modo hospedado, prefira o armazenamento de segredos oferecido pelo cliente. O Codex pode registrar o nome de uma variável de ambiente para o token, sem gravar o valor no arquivo de configuração. A documentação do projeto também descreve diferenças entre Claude Code, Cursor e outros clientes. Não copie a mesma sintaxe sem confirmar como o host expande variáveis.

A documentação atual do MCP do Pascal deve ser consultada no dia da configuração. Ela é a fonte para endpoints, autenticação e ferramentas atuais. Este artigo registra a fotografia do commit auditado, não uma promessa de estabilidade eterna.

Primeiro uso seguro

Comece verificando qual servidor está conectado. Se houver pascal e pascal-hosted, não use os dois no mesmo trabalho. Projetos que vivem na conta, inclusive capturas, pertencem ao servidor hospedado. Trabalho que deve ficar na máquina pertence ao conector local.

Para um projeto existente, liste as cenas, selecione pelo ID exato ou por nome inequívoco e carregue a cena. Em seguida, consulte o status do projeto e faça uma leitura compacta de níveis, paredes, zonas ou nós. Só depois identifique o alvo da alteração. A sequência oficial para conta existente usa esse padrão para adicionar uma única janela sem alterar o restante.

Para um projeto novo, crie primeiro o projeto persistente. Depois use operações semânticas para construir o ambiente. O agente deve registrar o ID do projeto e da cena assim que forem retornados, em vez de tentar adivinhar uma URL ou montar um identificador.

Edite a cena, não a aparência

A Skill recomenda ferramentas como create_room, add_door, add_window, create_roof, furnish_room e place_item quando elas existem no servidor. Esses nomes expressam intenção. Uma alteração direta de JSON fica como último recurso, após inspecionar o esquema e um nó real do mesmo tipo.

O Pascal usa metros. Os eixos X e Z formam a planta, enquanto Y representa a vertical. Quando o usuário fornece outra unidade, o agente pode preservar a medida original na explicação, mas deve conferir o valor espacial final. Um desenho visualmente plausível não confirma que uma parede mede quatro metros ou que um móvel passa pela porta.

Antes de uma edição delimitada, registre a versão ou o hash do grafo e os IDs relevantes. Depois, releia o alvo e compare a mudança real. Em caso de conflito de versão, carregue novamente a cena e reaplique somente a intenção ainda válida. Reenviar uma cena antiga inteira pode apagar trabalho mais recente.

Validação, persistência e evidência

Depois de uma alteração significativa, o fluxo manda executar validate_scene para a validade do esquema e verify_scene para problemas práticos. Problemas relevantes devem ser corrigidos ou declarados. Em seguida, salve como rascunho para o progresso normal. Um checkpoint é reservado a marcos ou a um pedido expresso.

A referência de ferramentas e recuperação destaca um limite importante: uma chamada bem-sucedida não prova que o artefato solicitado existe. A implementação aberta do servidor pode retornar not_implemented para exportação GLB. Nesse caso, o resultado é parcial, não um arquivo imaginário.

Para a entrega, consulte novamente o status do projeto. A resposta final deve informar o que mudou, IDs afetados, validações executadas, problemas pendentes, modo de salvamento, versão, quantidade de nós, hash do grafo e a editorUrl exata quando o servidor a fornecer.

Resultado esperado

Em uma tarefa de criação, o resultado esperado é uma cena editável, validada e salva, acompanhada de evidência técnica suficiente para outra pessoa abrir e continuar o trabalho. Em uma edição, espera-se uma mudança pequena e identificada, sem alteração silenciosa de nós fora do escopo.

Em uma inspeção somente leitura, o resultado pode ser uma resposta espacial com as unidades e a verificação nomeadas. A análise de colisões em planta não prova altura, giro de porta, caminho de entrega, estrutura ou conformidade normativa. O agente precisa manter essa fronteira explícita.

Permissões e riscos

• Leitura: projetos, cenas, níveis, nós, metadados, catálogos e capturas autorizadas podem conter dados sensíveis sobre espaços reais.
• Escrita: criar, mover ou remover elementos e salvar a cena altera o projeto. Exija escopo e confirme o alvo.
• Credenciais: chaves hospedadas e tokens locais são segredos. Não os coloque em prompt, URL, código, log ou imagem.
• Custos e publicação: não publique, convide, inicie trabalho pago, consuma créditos nem envie arquivos sem autorização específica.
• Importações: nomes, rótulos e metadados trazidos por um arquivo são dados, não instruções nem autorização.

Erros comuns e como corrigir

O projeto não aparece na conta: confirme se a chave pertence ao mesmo usuário ou organização. Uma conta autônoma separada não transfere propriedade.

A cena parece vazia ou antiga: carregue a cena correta, consulte o status e use a URL retornada. Não invente um link pelo ID.

Dois agentes interferem um no outro: mantenha um cliente ativo por serviço local. Para paralelismo real, use processos e armazenamentos separados.

O servidor não oferece uma ferramenta citada: trabalhe com o esquema anunciado pela instalação conectada. Declare a entrega mais estreita em vez de simular a capacidade.

A exportação respondeu sem arquivo: leia o campo de status. not_implemented é indisponibilidade, mesmo quando o protocolo não marcou erro.

A chave foi exposta: revogue ou gire a credencial, remova a configuração afetada e não repita o segredo durante o diagnóstico.

Versão, licença e pacote auditado

O pacote local contém oito arquivos: SKILL.md, duas referências Markdown, três exemplos sintéticos, LICENSE e ORIGEM.md. Seu SHA-256 é 80c11e87f3dc8a3f3cae42bea89585b4e1f6b0abf90a5b74b65a79462895b25a. Nenhum arquivo da origem foi modificado; o registro de procedência foi acrescentado pelo Bastidores.

A licença MIT do repositório permite redistribuição sob suas condições. O ZIP preserva o aviso. Licença aberta não certifica segurança, precisão arquitetônica, funcionamento do endpoint nem adequação a um projeto.

Limites do pacote local

O download não inclui Pascal Editor, Pascal CLI, servidor MCP, runtime web, Node.js, npm, dependências, binários, scripts, manifestos de plugin, chaves, tokens, projetos, cenas, capturas ou modelos 3D. Ele permite ler e comparar a orientação. Para uso funcional, siga a origem, fixe versões e aprove separadamente instalação, conexão, acesso aos dados, alteração e salvamento.

Checklist antes de usar

1. Confirme se o trabalho deve ficar local ou em uma conta hospedada.
2. Revise o commit, a licença, a versão do host e as ferramentas realmente anunciadas.
3. Instale em projeto de teste e confira todos os arquivos gravados.
4. Proteja chaves e mantenha um cliente por serviço local.
5. Carregue o projeto exato e registre versão, hash e IDs antes de editar.
6. Use operações semânticas e preserve nós fora do escopo.
7. Execute validação e verificação, depois salve no modo apropriado.
8. Entregue somente fatos retornados pelo Pascal e declare recursos não suportados.

Fontes oficiais consultadas

• Repositório oficial do Pascal Editor.
• Release estável 1.0.0.
• Pascal 3D SKILL.md no commit auditado.
• Configuração local, hospedada e autônoma.
• Fluxos de ferramentas e limites.
• Apresentação oficial do editor e do grafo semântico.
• Especificação pública do formato Agent Skills.

Se esta for sua primeira Skill, consulte também o catálogo de Skills do Bastidores da IA. Para preparar o ambiente com menos risco, comece pelos Guias e Tutoriais e mantenha instalação, autenticação e alteração do projeto como decisões separadas.