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 Resolve | 21, edição gratuita |
| Node.js | 18 ou superior |
| OS | Windows 10/11 · macOS (beta: pode ter erros) |
| Janela da Synthetic | Instalada pelo Synthetic Setup no Windows; macOS (beta): baixe-a no passo 5 |
| Cliente MCP | Claude Desktop, Cursor, Codex ou qualquer cliente MCP |
| Licença | Sua 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.
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.
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.
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.