Conecte seu assistente de IA ao Vi
O Vi tem um servidor MCP integrado. Adicione um endereço ao Claude, ao Claude Code, ao Cursor, ao VS Code ou ao Codex, aprove uma vez no navegador, e o assistente pode ler, criar e trabalhar em tarefas do Vi como você.
O que é o servidor MCP do Vi?
O servidor MCP do Vi é um endpoint remoto do Model Context Protocol em https://useviapp.com/mcp que permite a um assistente de IA trabalhar no Vi com a sua própria conta. Ele usa Streamable HTTP com login OAuth, então não há nada para instalar nem token para copiar. Está incluído em todos os planos do Vi, inclusive o Free, sem vaga extra para o assistente; o custo do próprio assistente continua com o serviço de IA que você já usa.
https://useviapp.com/mcp
Como adiciono o Vi ao meu assistente de IA?
Adicione o endereço do conector ao seu assistente e aprove a conexão uma vez no navegador com a sua conta do Vi. Escolha a sua ferramenta:
Claude Code
Execute isto uma vez em um terminal. Depois abra o Claude Code, digite /mcp, escolha vi e selecione Authenticate. Com --scope user, o Vi fica disponível em todos os seus projetos.
claude mcp add --scope user --transport http vi https://useviapp.com/mcp
Claude (claude.ai e Claude Desktop)
Abra Settings › Connectors, adicione um conector personalizado chamado Vi com o endereço do conector acima, clique em Connect e aprove na janela que se abrir. Os conectores personalizados dependem do seu plano do Claude; em um plano de equipe, talvez um proprietário precise adicioná-lo primeiro.
Cursor
Adicione o Vi a ~/.cursor/mcp.json (ou a .cursor/mcp.json em um projeto). Depois abra Cursor Settings › MCP e entre no vi quando o Cursor pedir.
{
"mcpServers": {
"vi": { "url": "https://useviapp.com/mcp" }
}
}
VS Code (GitHub Copilot)
Adicione o Vi a .vscode/mcp.json no seu workspace, ou execute “MCP: Add Server” na Paleta de Comandos e escolha HTTP. Inicie o servidor e aprove o login quando o VS Code pedir.
{
"servers": {
"vi": { "type": "http", "url": "https://useviapp.com/mcp" }
}
}
Codex CLI
Adicione o Vi a ~/.codex/config.toml e depois faça login uma vez com o segundo comando.
[mcp_servers.vi] url = "https://useviapp.com/mcp"
codex mcp login vi
Outros clientes MCP
Qualquer cliente que suporte servidores MCP remotos via Streamable HTTP com OAuth pode se conectar com o endereço do conector. Um cliente que só roda servidores locais (stdio) não consegue se conectar diretamente.
O que acontece quando eu conecto?
- 1
Seu assistente abre uma janela do navegador com a página de login do Vi. Entre com a sua conta normal do Vi; sua senha nunca é compartilhada com o assistente.
- 2
O Vi mostra qual app está pedindo acesso e a qual espaço de trabalho. Aprove só se você mesmo iniciou a conexão.
- 3
O assistente está conectado. Você o vê em Configurações › Acesso de IA no Vi e pode desconectá-lo ali a qualquer momento.
O que o assistente pode fazer no Vi?
Ler projetos, equipes, membros e tarefas, incluindo a descrição, os comentários, as subtarefas e a etapa atual do fluxo.
Buscar antes de criar e então criar tarefas e subtarefas. Possíveis duplicatas são mostradas primeiro, e ele informa para qual projeto, etapa e pessoa a tarefa foi.
Adicionar comentários internos a uma tarefa. Comentários adicionados assim nunca são enviados por e-mail aos clientes.
Trabalhar em uma tarefa pelo número: o Vi a inicia na sua IDE como se você tivesse clicado em Iniciar, e o assistente dá retorno com um comentário.
Pausar uma tarefa em andamento, depois que você concordar na IDE, para poder passar para outra tarefa ou uma subtarefa.
Pedir para você encerrar uma tarefa. Sua IDE mostra os arquivos alterados, você aprova, e roda o mesmo Commit & Close do botão Concluir.
O que ele nunca pode fazer?
O assistente tem as suas permissões e nunca mais do que isso. Ele não pode excluir nada, mover uma tarefa entre etapas do fluxo por conta própria, alterar configurações, membros ou planos, nem fazer commit e push sem a sua aprovação na IDE. Há um nível de acesso somente leitura, e o proprietário do espaço de trabalho pode desativar o acesso de IA para todo o espaço de trabalho.
Posso dizer “faça a tarefa 142” ao meu assistente?
Sim — o assistente inicia a tarefa 142 na sua IDE, lê a descrição, os comentários e as subtarefas, faz a alteração e adiciona um comentário de resumo. Quando você pede para encerrar a tarefa, o Vi repassa o pedido para a janela da sua IDE daquele projeto (VS Code, Visual Studio, RAD Studio ou Lazarus), onde você revisa os arquivos e aprova. Uma tarefa que um revisor devolveu é tratada a partir da nota do revisor. O Claude Code também recebe dois prompts prontos: /mcp__vi__do_task e /mcp__vi__plan_subtasks.
Como o assistente sabe qual projeto do Vi usar?
Ele procura um arquivo .vi no seu repositório, o mesmo arquivo que as extensões de IDE do Vi usam para ligar uma pasta a um projeto, e pede para você confirmar. Se não houver, ele lista seus projetos e pergunta qual usar.
{"tenant":"acme","projectId":12,"projectName":"Website"}
Perguntas frequentes
O servidor MCP do Vi é gratuito?
Sim — o servidor MCP está incluído em todos os planos do Vi, inclusive o Free, e o assistente não ocupa vaga. Você paga apenas pelo assistente de IA que já usa.
Preciso de uma chave de API ou de um token?
Não — você aprova a conexão uma vez no navegador com a sua conta do Vi (OAuth). Sua senha nunca é compartilhada com o assistente, e você pode remover a conexão em Configurações › Acesso de IA.
Quais assistentes de IA funcionam com o Vi?
Qualquer cliente MCP que suporte servidores remotos Streamable HTTP com login OAuth pode se conectar, incluindo Claude, Claude Code, Cursor, VS Code com GitHub Copilot e Codex.
O assistente pode encerrar ou excluir minhas tarefas?
Não — ele não pode excluir nada nem mover uma tarefa sozinho. Ele pode pedir para você encerrar uma tarefa, e o encerramento só acontece depois que você revisa os arquivos e aprova na sua IDE.
O Vi vê o meu código-fonte pelo MCP?
Não — o assistente edita o código na sua própria máquina e o Git roda localmente pela extensão de IDE do Vi. O Vi recebe dados das tarefas e metadados dos commits, nunca código-fonte.
O proprietário do espaço de trabalho pode desativar o acesso de IA?
Sim — o proprietário pode desativar o acesso de IA para todo o espaço de trabalho em Configurações › Acesso de IA, o que interrompe imediatamente todos os assistentes conectados.
Relacionados: gestão de projetos na IDE · Commit & Close · segurança · preços
Experimente nas suas próprias tarefas
Crie um espaço de trabalho grátis, adicione o endereço do conector ao seu assistente e peça a ele para listar seus projetos.
Comece grátis