SyntheticSynthetic/Docs
ProdutosNovidades
Dashboard →

DaVinci Resolve MCP · Instalação

Instalando o DaVinci Resolve MCP

O DaVinci Resolve MCP é um servidor que roda no seu computador e que o seu cliente MCP inicia (Claude Desktop, Cursor, Claude Code, Codex). Você o instala com o Synthetic Setup. Ele se comunica com o DaVinci Resolve através de um pequeno conector que você carrega dentro do Resolve. Funciona no Windows. O macOS está em beta: não foi totalmente testado e pode ter erros. A janela da Synthetic, instalada junto com o servidor no Windows, pode carregar o conector para você com apenas um botão (passo 5).

Requisitos

DaVinci Resolve21, edição gratuita
Node.js18 ou superior
OSWindows 10/11 · macOS (beta: pode ter erros)
Janela da SyntheticInstalada pelo Synthetic Setup no Windows; macOS (beta): baixe-a no passo 5
Cliente MCPClaude Desktop, Cursor, Codex ou qualquer cliente MCP
LicençaSua chave de licença do DaVinci Resolve MCP (veja /dashboard/licenses)

1. Instalar com o Synthetic Setup

Baixe o Synthetic Setup em /dashboard/downloads e execute-o. Ele encontrará seus clientes MCP (Claude Desktop, Cursor, Claude Code, Codex) e adicionará o DaVinci Resolve MCP a cada um deles com sua licença já carregada. Quando terminar, ele mostrará a linha que você deve colar no DaVinci Resolve no passo 3.

Prefere editar a configuração do seu cliente manualmente? O Guia de configuração do cliente MCP mostra a entrada exata.

2. Reinicie seu cliente MCP

Feche o seu cliente MCP e abra-o novamente: os servidores são carregados na inicialização. Na primeira vez, o servidor é baixado em alguns segundos e, assim que a sua licença for verificada, ele cria o conector para o DaVinci Resolve no seu computador.

O Synthetic Setup também cuida do Node.js: se o seu computador não o tiver, ele o adiciona para os seus clientes MCP.

3. Carregue o conector dentro do DaVinci Resolve

Abra o DaVinci Resolve com um projeto. Vá em Workspace → Console, escolha Lua no topo do Console e cole a linha correspondente ao seu sistema, substituindo YOUR_USER pelo seu nome de usuário nesse computador:

Windows

dofile([[C:\Users\YOUR_USER\.synthetic\davinci-resolve-mcp\bridge\synthetic_server.lua]])

macOS

dofile([[/Users/YOUR_USER/.synthetic/davinci-resolve-mcp/bridge/synthetic_server.lua]])

O Console mostrará que o conector está pronto, e o Resolve continuará funcionando normalmente. Você faz isso uma vez por sessão do Resolve: depois de fechar e abrir o Resolve, cole a linha novamente.

Na primeira vez que o servidor criar o conector, o log do seu cliente MCP mostrará esta mesma linha com a sua própria pasta já incluída, pronta para copiar.

4. Experimente

Com o Resolve aberto e o conector carregado, peça algo simples ao seu cliente MCP:

Qual projeto está aberto no DaVinci Resolve e o que há na linha do tempo atual?

Se ele responder com seu projeto e sua linha do tempo, tudo funciona. Então experimente algo maior: adicione marcadores, aplique um LUT, renderize a linha do tempo.

Importante: o DaVinci Resolve deve estar aberto, com um projeto e o conector carregado, sempre que seu cliente MCP executar uma ferramenta. Caso contrário, as ferramentas informam que o Resolve não está conectado.

5. A janela da Synthetic

A janela Synthetic DaVinci Resolve MCP mostra se o Resolve está conectado e tem um botão Conectar que abre o Console do Resolve e carrega o conector para você. Ela precisa do Node.js no computador (o mesmo que seu cliente MCP usa). Se Conectar não conseguir, Conectar manualmente mostra a linha para colar. No Windows, o Synthetic Setup a instala junto com o servidor: você a encontra no menu Iniciar como «Synthetic DaVinci Resolve MCP». Você também pode baixá-la em /dashboard/downloads.

  • Windows: o Synthetic Setup a instala para você; se baixar o instalador manualmente, execute-o. Ele ainda não é assinado, então o Windows pode exibir um aviso do SmartScreen: clique em Mais informações e depois em Executar assim mesmo.
  • macOS: baixe o .dmg para o chip do seu Mac, Apple Silicon (M1 e posteriores) ou Intel, e arraste o app para a pasta Aplicativos. Ele ainda não é assinado pela Apple: na primeira vez, clique com o botão direito no app e escolha Abrir. Se o macOS ainda recusar, vá em Ajustes do Sistema → Privacidade e Segurança e clique em Abrir Mesmo Assim.

No Mac, Conectar precisa da permissão de Acessibilidade para digitar a linha no Console do Resolve: Ajustes do Sistema → Privacidade e Segurança → Acessibilidade → ative «Synthetic DaVinci Resolve MCP» (o macOS também pode pedir permissão para ela controlar o System Events). Se preferir não conceder, use Conectar manualmente: Workspace → Console, modo Lua, cole a linha do passo 3, uma vez por sessão do Resolve.

No Mac, esta janela e o botão Conectar foram testados apenas em máquinas de teste, ainda não com o DaVinci Resolve. Se Conectar não funcionar, use Conectar manualmente e conte para nós o que aconteceu.