Se a sua equipe já usa o ChatGPT, o Claude ou outra ferramenta de IA no dia a dia, não precisa trocar de app para consultar o Vendelo: a Filipa também existe como conector. Tecnicamente ele se chama servidor MCP (Model Context Protocol, o padrão aberto que permite a uma IA usar ferramentas externas). Adicionado à sua IA, o conector faz a IA consultar o Vendelo com o seu login, somente para leitura, e responder com dados reais. Este artigo explica o que o conector faz, como conectá-lo nas ferramentas mais comuns, como funciona o login, o que pedir e como revogar o acesso.
Índice
- O que é o conector da Filipa
- Requisitos
- O endereço do conector
- Conectando no ChatGPT
- Conectando no Claude
- Outras ferramentas compatíveis
- A tela de login do conector
- Usando: onboarding, empresas e exemplos
- Prompts prontos e guias
- Limites e proteção contra abuso
- Renovação e revogação do acesso
- Perguntas frequentes
O que é o conector da Filipa
O conector é um serviço da Vendelo que expõe, para IAs compatíveis, um conjunto de ferramentas de consulta ao Vendelo: listar empresas, descobrir quais recursos existem, consultar registros com filtros e ordenação, obter indicadores e avaliar a fila de aprovação de pedidos. Ele se identifica para a IA como Filipa da Vendelo, e a IA passa a se apresentar assim nas conversas que usam o conector. A mesma tecnologia é usada pela Filipa dentro do Vendelo e pelos agentes autônomos.
- Somente leitura: nenhuma ferramenta do conector cria, altera ou exclui registros do Vendelo. A única marcada como gravação registra contadores anônimos de correção de consultas, sem dados da empresa.
- Suas permissões: cada pessoa entra com o próprio e-mail e senha do Vendelo, e a IA só vê o que aquela pessoa vê.
- Sem senha guardada: o login gera credenciais temporárias e renováveis; a senha não é armazenada nem pela IA nem pelo conector.
Requisitos
Instalação autorizada: a instalação do Vendelo da sua empresa precisa estar autorizada pela Vendelo para o serviço de IA, com contrato vigente. Sem isso, o login é recusado.
Conta na ferramenta de IA com suporte a conectores: no ChatGPT e no Claude, o recurso de conectores ou integrações costuma exigir planos pagos. Consulte o plano da sua conta.
Usuário do Vendelo com e-mail confirmado: o mesmo requisito do login normal.
Permissão Chat da Filipa, assistente de IA, no perfil: a mesma permissão que libera a Filipa no Vendelo.
O endereço do conector
O administrador da sua empresa (ou a Vendelo) informa o endereço do conector. Ele tem a forma https://<servidor-do-conector>/mcp. Guarde esse endereço: é o único dado que você precisa informar na ferramenta de IA. O login e as permissões são resolvidos depois, na tela de login da Vendelo.
Confira o endereço com o administrador antes de conectar. Um endereço errado não expõe seus dados, porque o login é feito só no servidor da Vendelo, mas simplesmente não funcionará.
Conectando no ChatGPT
Abra as configurações do ChatGPT: procure a seção de conectores (ou apps e conectores, conforme a versão).
Adicione um conector personalizado: informe um nome (por exemplo, “Filipa Vendelo”) e o endereço do conector terminado em
/mcp. O ChatGPT se identifica sozinho para o conector; não é preciso cadastrar chaves.Autorize: o ChatGPT abre a tela de login da Vendelo. Entre com e-mail e senha do Vendelo e conclua a verificação de segurança.
Ative o conector na conversa: em uma conversa nova, selecione o conector da Filipa entre as ferramentas disponíveis e faça a primeira pergunta.
Conectando no Claude
Abra as configurações do Claude: na seção de conectores ou integrações.
Adicione um conector personalizado: informe o nome e o endereço do conector terminado em
/mcp. O Claude se registra automaticamente no conector.Autorize: o Claude abre a tela de login da Vendelo; entre com o seu usuário do Vendelo.
Use: nas conversas, habilite o conector da Filipa e pergunte. O mesmo vale para o Claude Desktop e o Claude Code.
Outras ferramentas compatíveis
Qualquer cliente compatível com MCP por HTTP e com login OAuth funciona: Claude Desktop, Claude Code, VS Code, Gemini CLI, Cursor, Windsurf, Codex e similares. O procedimento é sempre o mesmo: cadastrar o endereço /mcp e completar o login na tela da Vendelo. Esses clientes se registram sozinhos no conector; não há chave de cliente para copiar.
A tela de login do conector
A tela é leve e traz o logotipo da Vendelo com a marca MCP e o retrato da Filipa. Ela informa qual ferramenta está pedindo o acesso (por exemplo, “Solicitado por Claude”), pede e-mail e senha e, como na Filipa do navegador, só mostra o campo de servidor quando você marca Usar servidor dedicado (para empresas com instalação própria; aceita código, host ou URL). O botão se chama Entrar e autorizar, e o rodapé lembra que a conexão é protegida, com reCAPTCHA em dois níveis, e que a senha não é armazenada. A verificação de segurança é invisível; se for necessário, aparece o desafio para marcar. Ao concluir, aparece “Acesso autorizado! Você já pode voltar para o [nome da ferramenta]. Esta janela pode ser fechada.”, a ferramenta de IA recebe uma credencial temporária e você volta para ela. Se o retorno não acontecer sozinho, use o link “Não foi redirecionado? Clique aqui.”
A credencial de acesso vale por 30 minutos e é renovada automaticamente pela ferramenta por até 30 dias sem pedir a senha. Depois desse prazo, ou se a sessão do Vendelo expirar, a ferramenta pede para entrar de novo.
Usando: onboarding, empresas e exemplos
Na primeira conversa após conectar, a Filipa se apresenta com um onboarding: lista as suas empresas, as áreas disponíveis, mais de vinte exemplos de perguntas e o catálogo de indicadores, no idioma da conversa. Se você já começar com um pedido claro, ela vai direto ao ponto.
- Empresa: com uma só empresa, ela é selecionada automaticamente. Com várias, a Filipa pergunta qual (ou todas) antes da primeira consulta e não escolhe sozinha.
- Perguntas: as mesmas do artigo “O que perguntar”: clientes, produtos, cotações e pedidos, funil, atividades, metas e indicadores, fila de aprovação com risco.
- Idioma: português, inglês ou espanhol, conforme a conversa. Os valores de status e categorias vêm traduzidos.
- Datas: o conector orienta a IA a usar o fuso horário do seu computador para “hoje”, “esta semana” etc. Se a IA não souber o fuso, ela pergunta.
Prompts prontos e guias
O conector publica prompts prontos, que aparecem na ferramenta de IA como atalhos: resumo executivo, funil e leads, atividades e follow-ups, pedidos, aprovações e status, metas e desempenho de vendas, e riscos operacionais. Todos aceitam empresa e período opcionais. Também há três guias de leitura (primeiros passos, exemplos e indicadores) em cada idioma, que a IA pode consultar para orientar você.
Limites e proteção contra abuso
Para proteger o Vendelo, o conector aplica limites por usuário: quantidade de chamadas por minuto, número de consultas simultâneas e tamanho máximo de resposta. Quando um limite é atingido, a ferramenta recebe um aviso para aguardar e tentar de novo. Consultas em várias empresas consomem proporcionalmente mais. Além disso, cada consulta é revalidada contra o seu perfil antes de executar: recursos, campos e registros sem permissão simplesmente não aparecem.
O conector guarda apenas o estado técnico do login (criptografado) e contadores globais anônimos que ajudam a IA a corrigir erros de consulta. Ele não guarda prompts, resultados, empresas ou qualquer dado da sua conversa.
Renovação e revogação do acesso
- Renovação: automática, sem senha, por até 30 dias de uso contínuo.
- Revogar do seu lado: remova o conector nas configurações da ferramenta de IA. Sem a credencial, não há acesso.
- Revogar pela empresa: o administrador pode retirar a permissão Chat da Filipa, assistente de IA do seu perfil ou desativar o usuário; a próxima consulta é recusada. A Vendelo também pode bloquear a instalação inteira.
- Troca de senha: a credencial ativa continua válida até expirar; para cortar de imediato, remova o conector na ferramenta.
Perguntas frequentes
A IA externa vai “aprender” com os dados da minha empresa?
O conector da Vendelo não armazena dados de negócio. O tratamento que o ChatGPT ou o Claude dão ao conteúdo das conversas segue a política e o plano da sua conta nessas ferramentas; consulte-os.
Posso conectar mais de uma pessoa?
Sim. Cada pessoa conecta na própria conta da ferramenta de IA e entra com o próprio usuário do Vendelo. As permissões são individuais.
Por que a IA pediu para eu escolher a empresa?
Porque o seu usuário tem mais de uma e a Filipa nunca assume todas. Responda com o nome da empresa ou diga “todas”.
A IA disse que a consulta foi recusada por limite. E agora?
Aguarde um minuto e repita. Se acontecer com frequência, reduza consultas em várias empresas ao mesmo tempo.
Consigo criar um pedido pelo ChatGPT com esse conector?
Não. O conector é exclusivamente de leitura. Para criar pedidos, use o Vendelo ou o SDR Supreme.
A resposta veio com o nome “Filipa” dentro do ChatGPT. É normal?
Sim. O conector se identifica como Filipa da Vendelo e orienta a IA a se apresentar assim quando usa as ferramentas do Vendelo.
O login do conector aceita o servidor dedicado da minha empresa?
Sim, desde que a instalação esteja autorizada pela Vendelo. Marque “Usar servidor dedicado” e informe o código, host ou URL.
Próxima leitura
Filipa dentro do Vendelo: visão geral e menus: conheça o menu Filipa IA e cada tela que ele abre.
