# Como conectar assistentes de IA à leadlovers (MCP) Você pode conectar o Claude, o ChatGPT, o Cursor e outras ferramentas de IA à sua conta leadlovers e pedir para criar leads, montar e-mails, consultar seus projetos e sequências. Não é preciso instalar nenhum programa nem copiar chaves. A conexão usa um único endereço, o do servidor MCP da leadlovers: ``` https://mcp.leadlovers.com/mcp ``` Você cola esse endereço na sua ferramenta de IA, confirma o acesso em uma página da leadlovers e pronto. ## O que é o MCP da leadlovers O MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA usem ferramentas externas. O servidor MCP da leadlovers dá ao seu assistente acesso seguro à sua conta: ele passa a consultar e criar leads, tags, campos personalizados, projetos, sequências, e-mails e páginas, sempre a partir do que você pede na conversa. ## Antes de começar Duas condições precisam estar atendidas na sua conta leadlovers: **Você precisa ser o titular da conta.** Sub-usuários não conseguem conectar ferramentas de IA. A conexão dá acesso completo à conta, então só quem responde por ela pode autorizar. Se você usa uma conta que não é sua, peça ao titular. **Sua conta precisa de um Token Web API válido.** Ele fica em [Meu perfil → LeadLovers API](https://app.leadlovers.com/v4/profile/api), no campo **Token Web API**. Se a sua conta ainda não tiver um, clique em **Gerar token** nessa mesma tela. Você não vai copiar nem ver o token durante a conexão, mas ele precisa existir e não pode estar expirado. ::figure[O Token Web API fica em Meu perfil, na seção LeadLovers API]{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fmcp-01-token-web-api.png" alt="Tela Meu perfil da leadlovers na seção LeadLovers API, com o campo Token Web API e os botões Mostrar token, Copiar token e Renovar token"} Se faltar alguma das duas condições, a tela de autorização diz exatamente qual é o problema, em vez de deixar você em uma página em branco. Do lado da ferramenta de IA, cada uma tem as próprias exigências de plano. Elas estão na seção de cada ferramenta, logo abaixo. ## Como conectar ### Claude Adicione o conector pelo site (claude.ai) ou pelo aplicativo para computador. Depois de conectado, ele também fica disponível no aplicativo do celular. O caminho muda conforme o seu plano do Claude. #### Planos Pro e Max 1. No menu lateral, abra **Personalização** e vá para a aba **Conectores**. 2. Clique em **Adicionar** e escolha **Adicionar conector personalizado**. 3. Em **Nome**, escreva `leadlovers`. Em **URL do servidor MCP**, cole `https://mcp.leadlovers.com/mcp`. 4. Clique em **Continuar**. O Claude verifica o servidor; conclua a segunda etapa para adicionar o conector. 5. Na lista **Meus**, clique em **Conectar** no leadlovers. O Claude abre a página da leadlovers para você autorizar. ::figure[No Claude, o conector personalizado é adicionado em Personalização → Conectores]{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fmcp-02-claude-conectores.png" alt="Janela Adicionar conector personalizado do Claude, etapa 1 de 2, com o nome leadlovers e a URL do servidor MCP preenchidos e o botão Continuar"} Quando o conector aparecer como **Conectado**, ele está pronto. Para usar em uma conversa, clique no **+** da caixa de mensagem (Adicionar arquivos, conectores e mais), abra **Conectores** e ative o leadlovers. #### Plano gratuito Funciona igual ao Pro, pelo mesmo caminho **Personalização → Conectores**, com uma limitação: o plano gratuito permite **um único conector personalizado**. Se você já tem outro conectado, será preciso removê-lo antes. #### Planos Team e Enterprise Aqui a conexão é feita em duas etapas, porque só um **proprietário** da organização pode adicionar conectores. O proprietário faz uma vez: 1. Abra **Configurações da organização → Conectores**. 2. Clique em **Adicionar**, passe o mouse sobre **Personalizado** e escolha **Web**. 3. Cole `https://mcp.leadlovers.com/mcp` e clique em **Adicionar**. Depois disso, cada pessoa da equipe abre **Personalização → Conectores**, encontra o conector leadlovers (marcado como **Personalizado**) e clica em **Conectar** para autorizar com a própria conta leadlovers. Se alguém da equipe tentar adicionar o mesmo endereço de novo, o Claude avisa que "Já existe um conector com esta URL na sua organização". Nesse caso, basta usar o conector que já existe e clicar em **Conectar**. ### ChatGPT :::warning[Atenção] No ChatGPT, conectar um servidor próprio depende do **Modo de desenvolvedor**, que não existe nos planos gratuito e Go, funciona só no navegador (não no aplicativo do celular) e que a OpenAI vem mudando de lugar. Se os nomes abaixo não baterem com o que você vê, procure por "Modo de desenvolvedor" ou "Developer mode" nas configurações. Se você não tem prática com esse tipo de ajuste, recomendamos usar o Claude. ::: Disponível nos planos Plus, Pro, Business, Enterprise e Edu. Em contas Business, só administradores e proprietários do workspace usam o modo de desenvolvedor. Em contas Enterprise e Edu, um administrador precisa liberar o acesso antes. Em alguns planos, o ChatGPT permite apenas as ferramentas de consulta, sem criar ou alterar dados. 1. Abra o ChatGPT no navegador e vá em **Configurações**. 2. Ative o **Modo de desenvolvedor**. Dependendo da versão da sua conta, ele fica em **Segurança e login** ou em **Aplicativos → Configurações avançadas**. 3. Crie um novo aplicativo (ou plugin, na versão mais recente) com o nome `leadlovers` e cole a URL `https://mcp.leadlovers.com/mcp`. Em autenticação, escolha **OAuth**. 4. Conclua a criação. O ChatGPT abre a página da leadlovers para você autorizar. 5. Para usar em uma conversa, abra o menu **+** da caixa de mensagem e escolha o **Modo de desenvolvedor**. ### Cursor Adicione ao arquivo `~/.cursor/mcp.json` (vale para todos os projetos) ou `.cursor/mcp.json` (só para o projeto aberto): ```json { "mcpServers": { "leadlovers": { "url": "https://mcp.leadlovers.com/mcp" } } } ``` Salve o arquivo e reinicie o Cursor. Na primeira vez em que o servidor for usado, o Cursor pede para você fazer login: siga o aviso e autorize na página da leadlovers. Os servidores ficam listados em **Customize → MCPs**. ### VS Code Rode no terminal (macOS e Linux): ```bash code --add-mcp '{"type":"http","name":"leadlovers","url":"https://mcp.leadlovers.com/mcp"}' ``` No Prompt de Comando do Windows, use aspas duplas escapadas: ```bash code --add-mcp "{\"type\":\"http\",\"name\":\"leadlovers\",\"url\":\"https://mcp.leadlovers.com/mcp\"}" ``` Depois inicie o servidor de uma destas formas: - Na **paleta de comandos**, rode **MCP: List Servers**, escolha **leadlovers** e clique em **Start Server**. - Ou, na visão de **Extensões**, na seção **MCP SERVERS - INSTALLED**, clique na engrenagem do **leadlovers** e escolha **Start Server**. O VS Code pede para você confiar no servidor e abre o navegador para você autorizar na página da leadlovers. ### Devin Desktop (antigo Windsurf) Em junho de 2026, o Windsurf passou a se chamar **Devin Desktop**. No painel do agente, abra o menu **...** e escolha **Open MCP config file**. Adicione: ```json { "mcpServers": { "leadlovers": { "url": "https://mcp.leadlovers.com/mcp" } } } ``` Na primeira vez em que o servidor for usado, o Devin Desktop pede para você autenticar. Se o acesso expirar, o servidor aparece como **Needs auth**: clique em **Authenticate** para conectar de novo. ### Claude Code Rode no terminal: ```bash claude mcp add --transport http --scope user leadlovers https://mcp.leadlovers.com/mcp ``` O `--scope user` deixa o leadlovers disponível em todos os seus projetos. Sem ele, o servidor fica disponível só na pasta atual. Depois abra uma sessão, rode `/mcp`, escolha **leadlovers** e clique em **Authenticate**. O navegador abre a página da leadlovers para você autorizar. ### Outras ferramentas Qualquer ferramenta compatível com MCP aceita o mesmo endereço. Se a sua só permitir servidores locais, use a ponte `mcp-remote` (é preciso ter o Node.js instalado): ```json { "mcpServers": { "leadlovers": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.leadlovers.com/mcp"] } } } ``` ## Autorizando o acesso Na primeira vez, sua ferramenta de IA abre o navegador em uma página da leadlovers. Confira três coisas antes de clicar em **Autorizar**: 1. O endereço é **app.leadlovers.com**. 2. A conta mostrada é a certa. Se não for, clique em **Trocar conta**. 3. O nome da ferramenta na tela é o da ferramenta que você está usando agora. ::figure[A tela de autorização mostra a ferramenta de IA, a sua conta e o que a ferramenta poderá fazer]{src="https://objectstorage.sa-saopaulo-1.oraclecloud.com/n/gryhpzkixl8s/b/assets/o/helpcenter%2Fmcp-03-consentimento.png" alt="Tela de autorização da leadlovers com o título Claude quer acessar sua conta leadlovers, a conta conectada com a opção Trocar conta, a lista de permissões e os botões Cancelar e Autorizar"} A tela também lista o que a ferramenta poderá fazer na sua conta: ver, criar, editar e excluir leads e campos personalizados; ver e criar projetos e sequências; e ver, criar e editar e-mails e modelos de e-mail. Depois de autorizar, o navegador volta sozinho para a ferramenta. Se mudar de ideia, clique em **Cancelar**. O navegador volta para a ferramenta do mesmo jeito e ela entende que você recusou, em vez de ficar esperando. Nada é conectado e você pode tentar de novo quando quiser. Seu token **não** aparece em nenhum momento e não fica salvo no seu computador. A ligação é feita diretamente entre a leadlovers e a ferramenta. ## O que você pode pedir Exemplos do que dá para escrever depois de conectar: > Liste meus projetos e me diga quantas sequências cada um tem. > Crie um lead com o e-mail joana@exemplo.com no projeto Lançamento, na primeira sequência. > Monte um template de e-mail de boas-vindas, com um botão para meu site, e me mostre a prévia. > Quais páginas eu tenho no projeto Lançamento? > Marque com a tag VIP os leads que entraram no projeto Lançamento esta semana. Sua ferramenta de IA escolhe sozinha qual ferramenta usar. As marcadas com **consulta** apenas leem dados; as demais criam, alteram ou excluem, e a sua ferramenta de IA pede confirmação antes. :::note[Observação] Os nomes técnicos das ferramentas estão em inglês. Neles, *machine* corresponde a **projeto** (por exemplo, `get_machines` lista os seus projetos). ::: ### Leads | Ferramenta | O que faz | | --- | --- | | `get_leads` | Lista e busca seus leads (consulta) | | `create_lead` | Cria um lead e, se você indicar, já o coloca em um projeto e sequência | | `update_lead` | Atualiza os dados de um lead | | `delete_lead` | Tira leads de projetos ou os exclui da conta | | `add_leads_to_machine` | Coloca leads que já existem em um projeto | | `get_lead_dynamic_fields` | Lê os campos personalizados de um lead (consulta) | | `get_bulk_action_status` | Acompanha operações em segundo plano, como aplicar tags ou excluir leads (consulta) | ### Tags | Ferramenta | O que faz | | --- | --- | | `get_tags` | Lista as tags da conta (consulta) | | `create_tag` | Cria uma tag | | `get_lead_tags` | Mostra as tags de um lead (consulta) | | `add_tags_to_leads` | Aplica tags a leads | | `remove_tags_from_leads` | Remove tags de leads | ### Campos personalizados | Ferramenta | O que faz | | --- | --- | | `get_custom_fields` | Lista os campos personalizados da conta (consulta) | | `create_custom_field` | Cria um campo personalizado | | `update_custom_field` | Altera um campo personalizado | | `delete_custom_field` | Exclui um campo personalizado | ### Projetos | Ferramenta | O que faz | | --- | --- | | `get_machines` | Lista seus projetos (consulta) | | `get_machine_details` | Detalha um projeto (consulta) | | `get_machines_structure` | Mostra projetos, sequências e níveis (consulta) | | `create_machine` | Cria um projeto | ### Sequências e e-mails | Ferramenta | O que faz | | --- | --- | | `get_sequences` | Lista as sequências de um projeto (consulta) | | `create_sequence` | Cria uma sequência | | `get_emails` | Lista os e-mails de uma sequência (consulta) | | `create_email` | Cria um e-mail | ### Templates de e-mail Funcionam em três passos: a IA cria uma primeira versão, você pede quantos ajustes quiser e, no fim, ela finaliza. | Ferramenta | O que faz | | --- | --- | | `create_email_template` | Monta a primeira versão do template | | `edit_email_template` | Aplica os ajustes que você pedir | | `finalize_email_template` | Fecha o template para uso | ### Páginas | Ferramenta | O que faz | | --- | --- | | `get_pages` | Lista suas páginas, da conta toda ou de um projeto (consulta) | | `get_page_details` | Mostra os dados de uma página (consulta) | | `get_page_html` | Devolve o HTML publicado de uma página (consulta) | | `create_page` | Cria uma página em um projeto | | `update_page` | Altera uma página | | `delete_page` | Exclui uma página | O nome da página entra na URL pública, então aceita apenas letras sem acento, números e hífen. ## Desconectando Você pode cortar o acesso de duas formas: **Na ferramenta de IA**, remova o conector leadlovers. Ela deixa de enxergar a sua conta. **Na leadlovers**, em [Meu perfil → LeadLovers API](https://app.leadlovers.com/v4/profile/api), clique no ícone **Renovar token** (as setas circulares ao lado do campo) e confirme em **Renovar**. Isso invalida na hora todas as conexões existentes, inclusive as que você não lembra de ter feito. Use esta opção se desconfiar de algo. :::warning[Atenção] Renovar o token também interrompe as outras integrações que usam o mesmo Token Web API, até que você as atualize com o token novo. ::: ## Se algo der errado **"Somente o titular da conta pode conectar ferramentas de IA."** Você está logado como sub-usuário. Peça ao titular da conta que faça a conexão. **"Sua conta ainda não possui um Token Web API."** Gere o token em [Meu perfil → LeadLovers API](https://app.leadlovers.com/v4/profile/api), clicando em **Gerar token**, e comece de novo pela sua ferramenta de IA. **"O Token Web API da sua conta expirou."** Renove o token em [Meu perfil → LeadLovers API](https://app.leadlovers.com/v4/profile/api) e comece de novo pela sua ferramenta de IA. **"Este link expirou."** O pedido de conexão vale por poucos minutos. Volte à ferramenta de IA e comece de novo. **"Este link de conexão está incompleto."** O endereço foi aberto pela metade, por exemplo copiado e colado de forma incompleta. Comece de novo pela sua ferramenta de IA. **"Esta conexão já foi respondida."** Você já autorizou ou já cancelou esse pedido. Volte para a ferramenta de IA. **A IA diz que a conexão foi recusada (`access_denied`).** É o que ela mostra quando você clica em **Cancelar** ou quando uma das condições acima não foi atendida. Resolva o que a tela apontou e conecte de novo. **A IA parou de enxergar a conta depois de um tempo.** Em geral, o Token Web API foi renovado depois que você conectou, o que derruba as conexões existentes de propósito. Remova o conector e conecte de novo. **A IA não encontra seus projetos.** Confirme que autorizou com a conta certa. Se você tem mais de uma conta leadlovers, a conexão vale para aquela em que estava logado na hora de autorizar. **Um pedido de template de e-mail demorou e não veio.** Peça algo mais simples, com menos seções ou sem imagens, e refine depois pedindo ajustes. ## Privacidade Ao conectar, os dados da sua conta que você pedir passam a ser processados também pelo fornecedor da ferramenta de IA que você escolher, sob os termos dele. Conecte apenas ferramentas em que você confia. Os detalhes estão no [Aviso de Privacidade para conexão com assistentes de IA](https://mcp.leadlovers.com/politica-de-privacidade). Para outras formas de integrar a sua conta, veja [Integrações da leadlovers: visão geral](/integracoes/integracoes-da-leadlovers-visao-geral) e a [documentação da API leadlovers](/integracoes/ferramentas/documentacao-para-integrar-com-api-leadlovers). ## Perguntas frequentes :::faq ### A leadlovers funciona com o Claude e o ChatGPT? Sim. A leadlovers tem um servidor MCP que se conecta ao Claude, ao ChatGPT (com o modo desenvolvedor), ao Cursor, ao VS Code, ao Devin Desktop (antigo Windsurf), ao Claude Code e a qualquer outra ferramenta compatível com MCP, pelo endereço https://mcp.leadlovers.com/mcp. ### Preciso copiar meu token para conectar? Não. Você só precisa ter um Token Web API válido na conta. A ferramenta de IA nunca vê o token: você autoriza o acesso em uma página da leadlovers e a conexão é feita diretamente entre as duas. ### Sub-usuários podem conectar uma ferramenta de IA? Não. Só o titular da conta pode autorizar, porque a conexão dá acesso completo à conta. ### Como desconectar uma ferramenta de IA da leadlovers? Remova o conector na própria ferramenta de IA ou renove o Token Web API em Meu perfil → LeadLovers API. A renovação derruba todas as conexões de uma vez, mas também interrompe outras integrações que usam o mesmo token. ### A IA pode apagar dados da minha conta? Pode, se você pedir: algumas ferramentas excluem leads, campos personalizados ou páginas. Antes de criar, alterar ou excluir, a sua ferramenta de IA pede a sua confirmação. ::: **Suporte**\ Se surgir qualquer dúvida ou se precisar de ajuda durante este procedimento, entre em contato com o nosso suporte!