MCP
Conecte Claude, Codex ou ChatGPT à Vensy e gerencie os acessos autorizados.
A Vensy expõe um servidor MCP para Claude, Codex e ChatGPT. Você configura a URL, faz login na sua conta e autoriza o workspace. O aplicativo passa a operar com o mesmo papel de quem autorizou.
URL do conector
https://mcp.vensy.com.br/mcpÉ a mesma URL para todos os workspaces. O workspace é escolhido na tela de autorização, depois do login.
No app, a URL também está em Configurações → MCP, com botão de copiar.
Claude
- Abra as Configurações do Claude.
- Vá em Conectores.
- Escolha Adicionar conector personalizado.
- Cole a URL
https://mcp.vensy.com.br/mcp. - Clique em Conectar.
- Faça login na Vensy.
- Escolha o workspace.
- Autorize o acesso.
Codex
-
Abra o terminal com o Codex instalado.
-
Adicione o servidor MCP da Vensy:
codex mcp add vensy --url https://mcp.vensy.com.br/mcp -
Inicie a autorização:
codex mcp login vensy -
Faça login na Vensy, escolha o workspace e autorize o acesso.
ChatGPT
- Abra as Configurações do ChatGPT.
- Ative o modo desenvolvedor.
- Adicione um conector MCP.
- Cole a URL
https://mcp.vensy.com.br/mcp. - Autorize o acesso na Vensy e escolha o workspace.
Vários workspaces
Na autorização você marca um ou mais workspaces. A IA só enxerga os marcados e, em cada um, age com o papel que você tem nele. Com mais de um marcado, ela precisa dizer em qual workspace vai agir a cada pedido; quando o pedido não deixa claro, ela pergunta. Ela nunca escolhe sozinha.
Permissões
| Permissão | O que libera |
|---|---|
mcp:read | Ler contatos, empresas, negócios, conversas, campanhas, funis e relatórios |
mcp:write | Criar e alterar registros, registrar notas, enviar mensagens, publicar funis e automações |
Uma conexão só com mcp:read não altera nada: toda tentativa de escrita é recusada pela Vensy, que devolve ao aplicativo o pedido de reconexão com a permissão de escrita. A IA age com o papel de quem autorizou. Um agente conectado não ganha poderes de administrador.
O que a IA vê e o que pode fazer
- Dados compartilhados: os dados dos workspaces autorizados que o seu papel já permite ver — contatos (nome, telefone, e-mail), negócios, conversas e mensagens, notas internas, campanhas, funis e métricas. Senhas, tokens e segredos de integração não são devolvidos.
- Efeitos: leituras não mudam nada. Escritas mudam o workspace de verdade. Envio de mensagem, campanha e publicação de funil ou automação falam com clientes reais e não têm volta.
- Confirmação: ações destrutivas, em massa ou de cobrança mostram antes o efeito e só executam numa segunda chamada, com um token que vale 5 minutos para aquele mesmo pedido.
- Segredos: a IA não pede senha, token nem chave, e não recebe segredos de volta. Credenciais de automação se cadastram no app, em Automações → fluxo → Segurança e horários; o segredo do webhook de uma automação se gera em Entrada e testes; o WhatsApp oficial se conecta em Canais.
Dados reais
A IA vê dados de clientes reais. Revise o que ela propõe antes de confirmar envios e ações em massa.
Limites
- Cerca de 100 chamadas de ferramenta por minuto por conexão, além do limite da própria API.
- Listas voltam em páginas de 25 itens; a IA segue o cursor quando precisa de mais. Resposta grande demais volta cortada e marcada como incompleta, nunca como se estivesse inteira.
- Depois de uma falha de rede numa escrita, a IA deve conferir o resultado antes de repetir: criação, nota e envio podem duplicar.
Revogar o acesso
Em Configurações → MCP, a lista Conexões ativas mostra cada aplicativo autorizado (nome, data e permissões), com o botão Revogar.
Depois de revogar, o acesso cai em até 5 minutos: o token tem validade curta e a verificação é local.
Quem ainda não conectou nada vê a lista vazia nessa mesma tela.