DaVinci Resolve MCP · Solução de problemas
Solução de problemas e limites
Os problemas mais comuns e como resolvê-los, seguidos pelas limitações reais do produto. Se o seu problema não estiver aqui, abra um ticket de suporte.
As ferramentas dizem que o DaVinci Resolve não está conectado
Sintoma: O cliente carrega o servidor, mas as ferramentas respondem com um erro de conexão.
Solução: Abra o DaVinci Resolve com um projeto e carregue o conector: Workspace → Console, escolha Lua e cole a linha de o guia de instalação. Repita esse processo toda vez que reiniciar o Resolve.
O Console mostra um erro quando eu colo a linha
Sintoma: O Console do Resolve responde com um erro em vez de informar que o conector está pronto.
Solução: Verifique se o Console está no modo Lua (não Py) e se você substituiu o nome de usuário pelo seu. O arquivo é criado na primeira vez que seu cliente MCP inicia o servidor com uma licença válida: inicie o cliente antes de colar a linha.
O Resolve abre uma janela de upgrade e para de responder
Sintoma: Uma ferramenta solicitou um recurso que existe apenas no DaVinci Resolve Studio. A edição gratuita abre a janela de upgrade, que bloqueia todas as janelas do Resolve até ser fechada.
Solução: Feche a janela usando o botão Not Yet: o Resolve e as ferramentas voltarão a funcionar. Peça ao seu cliente de IA para não usar recursos exclusivos do Studio (veja as limitações abaixo).
Erro de licença inválida
Sintoma: As ferramentas respondem que a licença está ausente ou é inválida, ou os logs do cliente indicam que DAVINCI_RESOLVE_MCP_LICENSE não foi configurado.
Solução: A licença na sua configuração não coincide com a de /dashboard/licenses. Copie-a novamente — verifique se não há espaços no início ou no final ao colá-la no JSON — e reinicie o cliente MCP.
As ferramentas pararam de funcionar após uma atualização
Sintoma: O servidor foi atualizado e as ferramentas agora falham ao se comunicar com o Resolve.
Solução: Uma atualização pode trazer um novo conector. Peça ao seu cliente de IA para executar resolve_reload_server, ou reinicie o DaVinci Resolve e cole a linha novamente.
No Mac, Conectar pede uma permissão ou não conecta
Sintoma: A janela do Synthetic DaVinci Resolve MCP informa que o macOS precisa da sua permissão, ou que não foi possível encontrar o menu Workspace ou o Console.
Solução: Ative «Synthetic DaVinci Resolve MCP» em Ajustes do Sistema → Privacidade e Segurança → Acessibilidade e pressione Conectar novamente. Se o Resolve estiver em um idioma diferente do inglês, Conectar pode não encontrar o menu: use Conectar manualmente (Workspace → Console, modo Lua, cole a linha de o guia de instalação), que não depende do idioma.
A janela informa que o Node.js não foi encontrado
Sintoma: A janela do Synthetic DaVinci Resolve MCP abre com uma mensagem sobre o Node.js em vez do status de conexão.
Solução: Instale o Node.js (LTS) em nodejs.org e abra a janela novamente. O próprio servidor MCP também precisa dele.
Limites
O que o DaVinci Resolve MCP não faz ou que ainda não foi testado. Estamos informando isso aqui para que você saiba antes de comprar.
- Verificado no Windows com a edição gratuita do DaVinci Resolve 21.1.1. O macOS está em beta: não foi totalmente testado e pode ter erros. Linux não é suportado.
- DaVinci Resolve Studio e Blackmagic Cloud não foram testados. Recursos exclusivos do Studio (por exemplo, isolamento de voz, Magic Mask, transcrição e classificação de áudio) abrem a janela de upgrade na edição gratuita.
- O Resolve precisa estar aberto, com um projeto carregado, e o conector deve ser carregado uma vez por sessão a partir do Console.
- Fusion: macros não podem ser criadas dentro de uma composição (instale-as como arquivos usando as ferramentas de complemento), e uma composição do Fusion não pode ser renderizada sozinha: renderize através da fila de renderização.
- Workflow Integration e plug-ins de codec não podem ser instalados com as ferramentas de complemento.
- O Resolve não possui IDs permanentes para clipes: as ferramentas localizam um clipe por sua trilha e posição, portanto, após mover clipes, seu cliente de IA deve ler a timeline novamente.
- No Mac, use o DaVinci Resolve baixado do site da Blackmagic Design: a versão da Mac App Store roda em uma sandbox que pode não permitir que o conector abra sua conexão local.
Se nada disso ajudar
Abra um ticket em seu painel de suporte com: (1) sua versão do DaVinci Resolve, (2) seu cliente MCP e a versão dele, (3) os logs do cliente ao tentar iniciar o servidor e (4) o trecho de configuração que você colou (sem a chave de licença). Você também pode perguntar no nosso Discord.