Este artigo também está disponível em:

Como conectar o MCP do VTurb ao seu assistente de IA

O que é o MCP do VTurb

Com o MCP do VTurb, você conecta seu assistente de IA (como o Claude ou o Cursor) à sua conta VTurb e pede, em linguagem natural, coisas que hoje faz pelo painel.

MCP é um padrão aberto que permite às assistentes de IA usar ferramentas de outros serviços. Na prática, depois de conectado, você pode escrever algo como "quais foram meus 5 vídeos com mais conversões nos últimos 30 dias?" ou "faça o upload do meu drive no painel do VTurb" e o assistente busca a resposta direto na sua conta ou realiza a ação, sem que você precise acessar o painel.

O servidor é hospedado pelo próprio VTurb: Não há nada para instalar, e você não precisa copiar nenhuma chave de API. O acesso é liberado por login no VTurb, pelo navegador.

Antes de começar

Você precisa de três coisas:

Uma conta VTurb ativa. Você vai entrar com o mesmo e-mail e senha que usa para acessar o painel.
Ser membro da company que quer operar. O assistente só enxerga as companies das quais o usuário que fez login é membro. As ações que você conseguirá fazer vão depender de que tipo de membro e permissões você tem na conta.
Um assistente de IA compatível com MCP remoto, como Claude, Cursor, VS Code, Gemini CLI, Codex ou Zed.

Como conectar

Todo assistente se conecta pelo mesmo endereço:

https://mcp.vturb.com/mcp

No Claude (web e Desktop)

Acesse Configurações → Conectores e clique em Adicionar connector.

Em nome, coloque VTurb. Em URL, cole https://mcp.vturb.com/mcp. Clique em Continuar.

A página de login do VTurb abre no navegador. Entre com sua conta e aprove a conexão.

Em uma conversa, clique no + ao lado da caixa de mensagem, abra Connectors e ative o VTurb.

Em outros assistentes

O endereço é sempre o mesmo; o que muda é onde ele é configurado.

Assistente	Onde configurar
Claude Code	Rode claude mcp add --transport http vturb ``https://mcp.vturb.com/mcp, depois `/mcp`
Cursor	Arquivo `.cursor/mcp.json`, com o campo `url`
VS Code	Arquivo `.vscode/mcp.json`, com `"type": "http"` e `url`
Gemini CLI	Arquivo `~/.gemini/settings.json`, com o campo `httpUrl`
Codex, Zed e outros	Pela ponte npx -y mcp-remote ``https://mcp.vturb.com/mcp

Os exemplos completos de configuração para cada assistente estão na documentação oficial do MCP do VTurb.

Atenção: cada assistente usa um nome de campo diferente para a URL. Copiar a configuração de um para outro sem ajustar esse campo impede a conexão.

Primeiro uso

Na primeira vez que o assistente usar uma ferramenta do VTurb, ele abre o login do VTurb no navegador para você aprovar a conexão. Depois disso, o acesso se renova sozinho.

Confira a conta antes de aprovar. O assistente vai operar com a conta VTurb que aprovar a conexão, independente do e-mail usado no assistente de IA.
Comece pedindo suas companies. Toda ação acontece dentro de uma company. Peça algo como "liste minhas companies no VTurb" e diga em qual delas o assistente deve trabalhar.
Você só vê o que pode usar. As ferramentas disponíveis correspondem às ações liberadas para a sua company.

O que dá para fazer

O MCP cobre boa parte do que você faz no painel: consultar resultados, ajustar players e organizar a conta.

Área	O que o assistente faz	Exemplo de pedido
Analytics	Ranking de vídeos por plays ou conversões, métricas completas de um vídeo, retenção e série diária	"Quais meus 10 vídeos com mais conversões neste mês?"
Testes A/B	Cria, inicia e acompanha testes, com resultado por variante e ajuste de divisão de tráfego	"Como está o teste A/B da VSL nova? Qual variante está ganhando?"
Configuração do player	Ajusta aparência, CTAs, mini-ganchos, pixels do Facebook e do Google, filtro de tráfego e smart autoplay	"Adicione meu pixel do Facebook no vídeo X."
Vídeos	Lista, duplica, move e importa vídeos a partir de uma URL pública	"Duplique o vídeo X e mova a cópia para a pasta Testes."
Arquivos e pastas	Envia imagens e legendas `.vtt` (até 20 MB) e organiza pastas	"Crie uma pasta chamada Lançamento Novembro."

A lista completa de ferramentas está na documentação oficial.

Segurança

O assistente nunca altera nada na sua conta sem mostrar a mudança antes e esperar sua confirmação.

Exclusões pedem confirmação explícita. Apagar um teste A/B ou uma pasta só acontece depois de você confirmar.
Importação por link é confirmada antes. É a única ação que acessa algo fora da sua conta, então o assistente pede que você confirme a URL.
Atenção aos testes A/B. Iniciar um teste é irreversível: não dá para pausar, só apagar. E apagar um teste faz o embed parar de funcionar e perde os resultados.

Problemas comuns

O que acontece	O que verificar
O assistente não encontra nenhuma company	Confira se a conta que aprovou a conexão é membro de alguma company. Se o navegador estava logado em outra conta VTurb, saia dela, remova o conector e conecte de novo.
Erro "usuário não é membro da company"	A conta conectada não faz parte dessa company. Peça para ser convidado ou reconecte com a conta certa.
As ferramentas do VTurb não aparecem na conversa (Claude)	Ative o conector no menu + → Connectors da conversa.
A conexão não funciona em Cursor, VS Code ou Gemini CLI	Confira o nome do campo da URL no arquivo de configuração (veja a tabela em "Como conectar").

Tenha acesso à documentação completa do MCP em: docs.vturb.com/pt/docs/guides/mcp.

Ficou com alguma dúvida? É só chamar a gente no chat.

Atualizado em: 22/10/2026

Este artigo foi útil?

Obrigado!