O que é Embody (Envoy MCP)?
O Embody é um componente do TouchDesigner, de Dylan Roscover, que você arrasta para um projeto como arquivo .tox. Ele reúne quatro partes: o Envoy, um servidor MCP embutido na sessão do TouchDesigner em execução; a externalização, que grava os operadores marcados em arquivos no disco que espelham a rede; o TDXN, um formato YAML que captura uma rede inteira em um único arquivo legível; e o Convoy, um recurso em prévia que permite que nós do Embody em uma LAN confiável controlem uns aos outros.
O Envoy dá a clientes como Claude Code, Codex, Cursor e Copilot cerca de 70 ferramentas para criar operadores, conectá-los, ajustar parâmetros, rodar Python, capturar quadros renderizados e ler erros. O projeto é Python com licença MIT, tem cerca de 218 estrelas, lançou a v6.3.3 em 1 de novembro de 2026 e exige TouchDesigner 2025.33230 ou mais recente no Windows ou macOS. O TouchDesigner em si só é gratuito para trabalho não comercial; projetos pagos exigem uma licença Commercial de $600 ou Pro de $2,200.
Como instalar Embody (Envoy MCP)
Download the Embody .tox from https://github.com/dylanroscover/Embody/tree/main/release and drag it into a TouchDesigner projectEmbody (Envoy MCP) vale a pena?
A contribuição real do Embody é tornar legíveis as redes do TouchDesigner. Um projeto .toe é um arquivo binário que um agente não consegue ler e o git não consegue comparar; o TDXN transforma a rede em YAML que os dois entendem. O read_tdxn devolve a rede ao vivo nesse formato, o que, segundo a documentação, usa de 20 a 90 vezes menos tokens do que percorrer os operadores um a um. Cada chamada de ferramenta que altera algo fica dentro de um bloco de desfazer do TouchDesigner, então Ctrl+Z reverte a mudança de um agente, e o capture_top deixa o agente ver o que renderizou e sinaliza quadros pretos ou vazios.
O modelo de segurança é a parte a ler antes de instalar. O Envoy escuta em 127.0.0.1:9870, procurando até a 9879 se houver várias instâncias, e verifica os cabeçalhos Host e Origin contra ataques vindos do navegador. Não há autenticação: a documentação diz que qualquer processo local que alcance a porta tem controle total da sessão, incluindo o execute_python, que roda Python arbitrário na thread principal do TouchDesigner com acesso a arquivos, rede e processos. Isso é aceitável em uma estação de trabalho pessoal e um risco real em máquinas compartilhadas ou desktops na nuvem. A opção de permissão que o assistente de configuração recomenda para o Claude Code, Don't ask, pré-aprova todas as ferramentas do Envoy, execute_python incluído; Ask for some mantém edições e execução atrás de uma confirmação.
O Convoy amplia a exposição. Ele instala um aplicativo em segundo plano por usuário que continua rodando a cada login, abre um listener na LAN criptografado e com autenticação mútua e repassa trabalho entre máquinas mesmo com o TouchDesigner fechado. Python e shell remotos vêm desligados por padrão e só podem ser ligados localmente, mas as ferramentas comuns repassadas ainda podem alterar projetos, e a documentação diz para não ativá-lo em redes de convidados ou públicas. O Convoy é rotulado como prévia de desenvolvimento, e a operação entre nós no macOS ainda não foi validada.
Os rivais estão por perto. O touchdesigner-mcp, mais antigo, de 8beeeaaat, tem cerca de 626 estrelas, e o TDMCP, da própria Derivative, é público desde setembro de 2026; o Embody credita ideias dos dois. O Embody ganha em abrangência, no formato de texto e em uma suíte de 5,720 testes executados dentro do TouchDesigner, e perde na pegada: grava AGENTS.md, CLAUDE.md, .mcp.json e outros arquivos de cliente no seu repositório e mantém um ambiente Python próprio.
Onde ele se destaca
Uma artista visual autônoma criando conteúdo para festivais
Esboçar três variações de um visual de loop de feedback em uma noite
Descreva cada visual ao Claude Code; o Envoy cria e conecta os operadores, o capture_top mostra o resultado e cada tentativa é exportada para TDXN para comparação. Trabalhos pagos exigem uma licença TouchDesigner Commercial de $600.
Um estúdio de instalações interativas de três pessoas
Manter os projetos de TouchDesigner no git e revisar as mudanças
Marque os COMPs para externalização, e cada salvamento grava arquivos .tdxn e .py que se comparam de forma limpa em pull requests; o .toe continua sendo a referência, a menos que o modo Roundtrip seja ligado.
Um diretor técnico com um rack de nós de renderização
Distribuir uma atualização do projeto e reiniciar todas as máquinas a partir de uma sessão
O Convoy repassa salvamentos, reinícios e envios de arquivos a cada nó pela LAN. Só em uma rede de produção confiável, com Allow Execute TD Python e Allow Full Shell desligados, a menos que um fluxo de trabalho precise deles.
Antes de decidir
- Configuração
- Baixe o .tox da pasta release e arraste para um projeto; o assistente de configuração escolhe o cliente de IA, as permissões e o Convoy. O Envoy grava um .mcp.json com uma ponte stdio que pode abrir o TouchDesigner; o HTTP direto é http://127.0.0.1:9870/mcp. Exige TouchDesigner 2025.33230+ no Windows ou macOS.
- Integrações
- Cerca de 70 ferramentas: create_op, set_parameter, connect_ops, execute_python, exec_op_method, read_tdxn, export_network e import_network, capture_top, get_op_errors, run_tests, launch_td, além das ferramentas de repasse do Convoy. Gera configurações para Claude Code, Codex, OpenCode, Gemini, Cursor, Windsurf e Copilot.
- Dados e privacidade
- Local. O Envoy escuta só em 127.0.0.1, valida Host e Origin e não tem autenticação; execute_python e exec_op_method dão a qualquer cliente conectado execução de código com o seu usuário. O Convoy abre um listener autenticado na LAN por meio de um aplicativo anfitrião que persiste no login; Python e shell remotos vêm desligados por padrão. Os logs guardam as últimas 200 operações e arquivos diários.
- Custo em escala
- O Embody é gratuito. O TouchDesigner Non-Commercial é gratuito, mas limitado a 1280x1280 e proibido para trabalho pago; Commercial $600, Pro $2,200, Educational $300.
- Limites
- A timeline precisa estar rodando; operadores clone e replicant não podem ser externalizados. O Convoy é uma prévia sem validação de LAN no macOS. 9 issues abertas. Em máquinas compartilhadas, a porta sem autenticação fica exposta a outros usuários.
O que é bom
- TDXN torna as redes comparáveis e legíveis por agentes
- Mudanças do agente se desfazem com Ctrl+Z
- Captura de quadros com detecção automática de tela preta
- Licença MIT e lançamentos frequentes
O que não é
- A porta local do Envoy não tem autenticação
- execute_python roda código arbitrário; a configuração recomendada o aprova automaticamente
- O Convoy adiciona um serviço de LAN em segundo plano e ainda é prévia
- Grava vários arquivos de configuração e de agente no seu projeto
Ideal para
Artistas e estúdios de TouchDesigner em estações de trabalho de um só usuário que querem que um agente construa e depure redes e querem seus projetos no git.
Alternativas ao Embody (Envoy MCP)
Embody (Envoy MCP): perguntas frequentes
- Embody (Envoy MCP) vale a pena?
- O Embody deixa um agente construir dentro do TouchDesigner ao vivo e guarda o trabalho no git, desde que você lembre que a porta dele não tem senha e que uma das ferramentas executa qualquer Python que receber. Damos nota 3.9 de 5.
- Quanto custa Embody (Envoy MCP)?
- O Embody é gratuito e de código aberto (MIT). O TouchDesigner Non-Commercial é gratuito; Educational $300, Commercial $600, Pro $2,200.
- Quais são as desvantagens de Embody (Envoy MCP)?
- A porta local do Envoy não tem autenticação; execute_python roda código arbitrário; a configuração recomendada o aprova automaticamente; o Convoy adiciona um serviço de LAN em segundo plano e ainda é prévia; grava vários arquivos de configuração e de agente no seu projeto.
- Para quem Embody (Envoy MCP) é indicado?
- Artistas e estúdios de TouchDesigner em estações de trabalho de um só usuário que querem que um agente construa e depure redes e querem seus projetos no git.
- Quanto custa Embody (Envoy MCP) para uma equipe ou em produção?
- O Embody é gratuito. O TouchDesigner Non-Commercial é gratuito, mas limitado a 1280x1280 e proibido para trabalho pago; Commercial $600, Pro $2,200, Educational $300.
- Embody (Envoy MCP) é seguro para dados da empresa?
- Local. O Envoy escuta só em 127.0.0.1, valida Host e Origin e não tem autenticação; execute_python e exec_op_method dão a qualquer cliente conectado execução de código com o seu usuário. O Convoy abre um listener autenticado na LAN por meio de um aplicativo anfitrião que persiste no login; Python e shell remotos vêm desligados por padrão. Os logs guardam as últimas 200 operações e arquivos diários.
- Quais são as melhores alternativas ao Embody (Envoy MCP)?
- As alternativas mais próximas que analisamos são MCP for Blender.
Respostas verificadas em 11 de nov. de 2026.