> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.vturb.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Como conectar o MCP do VTurb ao seu assistente de IA # 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) 1. Acesse **Configurações → Conectores** e clique em **Adicionar connector**. ![](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/compartilhamentodetela_1qnbm1a.gif) 2. Em nome, coloque `VTurb`. Em URL, cole `https://mcp.vturb.com/mcp`. Clique em **Continuar**. ![](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_1d914pu.png) 3. A página de login do VTurb abre no navegador. Entre com sua conta e aprove a conexão. ![](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_l6567c.png) 4. Em uma conversa, clique no **+** ao lado da caixa de mensagem, abra **Connectors** e ative o VTurb. ![](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_16ct2e.png) ### 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](https://docs.vturb.com/pt/docs/guides/mcp). || 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](https://docs.vturb.com/pt/docs/guides/mcp). ## 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](https://docs.vturb.com/pt/docs/guides/mcp). | Ficou com alguma dúvida? É só chamar a gente no chat.