Claude — Desktop e Code

A forma mais fácil é o Claude Desktop — sem terminal, sem Node, sem arquivos de configuração. O servidor tdmcp inteiro vem embutido em um único arquivo de extensão. Três passos, cerca de 3 minutos. Usa Claude Code ou Cursor? Veja a seção mais abaixo. Prefere Codex, ou um modelo local gratuito, sem API? Veja Codex ou Copiloto local.

Usa Claude Code, Cursor ou Codex?

Você não precisa fazer nada disso na mão. Cole esta mensagem na sua IA e ela instala tudo para você:

Install and connect tdmcp for me by reading and following
https://raw.githubusercontent.com/Pantani/tdmcp/main/tdmcp-install-prompt.md
Do every step yourself; only stop when you need me to paste one line into TouchDesigner.

1. Baixe a extensão

⬇ Baixar tdmcp.mcpb

Um .mcpb (MCP Bundle) é um único arquivo que o Claude Desktop instala como extensão. O servidor está dentro dele — não há mais nada para baixar. (.mcpb é o formato atual; antes se chamava .dxt, e qualquer .dxt mais antigo que você já tenha continua instalando.)

Se o link de download não funcionar

Pode ser que ainda não exista uma release publicada. Peça o arquivo tdmcp.mcpb diretamente a quem te indicou o tdmcp e continue no passo 2.

2. Instale no Claude Desktop

1. Abra o Claude Desktop → Settings → Extensions.
2. Escolha Install from file (ou simplesmente arraste o tdmcp.mcpb para a janela).
3. Se pedir configurações, deixe TouchDesigner host = 127.0.0.1 e TouchDesigner port = 9980. (Os padrões estão certos quando o TouchDesigner roda no mesmo computador.)
4. Ative a extensão "TouchDesigner (tdmcp)".

3. Ligue a ponte dentro do TouchDesigner

É isso que permite o Claude realmente controlar o TouchDesigner. Você só faz uma vez.

1. Abra o TouchDesigner.

2. Abra o Textport: menu Dialogs → Textport and DATs.

3. Cole esta única linha e aperte Enter:

   import urllib.request; exec(urllib.request.urlopen("https://raw.githubusercontent.com/Pantani/tdmcp/main/td/bootstrap.py").read().decode())

Você deve ver:

[tdmcp] bridge running on port 9980 (/project1/tdmcp_bridge)

Pronto. ✅ É seguro e reversível — adiciona um único componente organizado, tdmcp_bridge. Para remover depois, cole from mcp import install; install.uninstall().

Você está conectado

Com o TouchDesigner aberto e a ponte ligada, está tudo pronto para criar seu primeiro visual.

Uma observação de segurança

A ponte deixa o Claude rodar código dentro do TouchDesigner e escuta na porta 9980. Use apenas numa rede confiável (como o seu próprio computador), não em Wi-Fi público sem firewall. Desenvolvedores podem reforçar isso — veja Security (em inglês).

Claude Code, Cursor e outros clientes MCP

O Claude Desktop (acima) é a rota sem terminal. Para Claude Code ou Cursor, conecte o tdmcp a partir do código-fonte — você vai precisar do Node.js 20+. (O Codex tem o próprio passo a passo na página do Codex; o mesmo build a partir do código-fonte também roda o copiloto local.)

Mais fácil — deixe a IA fazer

Cole o comando do topo desta página na sua IA; ela clona, compila e conecta tudo sozinha, parando só na linha da ponte no passo 3.

Ou conecte na mão:

git clone https://github.com/Pantani/tdmcp.git
cd tdmcp
npm run setup   # instala, compila e imprime a linha exata para conectar seu cliente

O npm run setup imprime um comando pronto para colar, com os seus caminhos reais preenchidos. Os equivalentes manuais (<project-path> é a pasta clonada — rode pwd nela):

• Claude Code — claude mcp add tdmcp -- node <project-path>/dist/index.js

• Codex CLI — codex mcp add tdmcp -- node <project-path>/dist/index.js, ou adicione ao ~/.codex/config.toml:

  [mcp_servers.tdmcp]
  command = "node"
  args = ["<project-path>/dist/index.js"]

• Cursor — crie .cursor/mcp.json no seu workspace:

  {
    "mcpServers": {
      "tdmcp": { "command": "node", "args": ["<project-path>/dist/index.js"] }
    }
  }

Reinicie seu cliente para ele carregar o servidor, depois ligue a ponte — passo 3 acima. É a mesma linha única para todos os clientes.

Algum problema?

Veja Solução de problemas — cobre "TouchDesigner não está acessível", erros de download e o popup de permissão de microfone no macOS.