O que dá para fazer
Depois de conectado, é só pedir em linguagem natural. Alguns exemplos:
- "Quantos leads entraram este mês e quantos viraram venda?"
- "Quais campanhas do Meta trouxeram mais leads nos últimos 30 dias, e quanto gastei em cada uma?"
- "Quais palavras-chave do Google geraram vendas em outubro?"
- "Quanto tempo, em média, um lead leva para ir do primeiro contato até a venda?"
- "Resuma a conversa de WhatsApp da Maria Souza e diga o que falta para fechar."
- "Liste os leads que estão parados na etapa Proposta há mais de 7 dias."
- "Mova o lead do João para Venda ganha com valor de R$ 2.500."
O assistente escolhe sozinho as consultas que precisa fazer. Antes de qualquer alteração, como criar, editar ou mover um lead, ele pede a sua confirmação.
Conectar
Em todos os assistentes o caminho é o mesmo: adicionar um conector com o endereço abaixo e, na janela da Leaper que abre, entrar, escolher a empresa e clicar em Autorizar. Só administradores da empresa podem conectar.
https://mcp.leaper.com.br/mcp
Claude
No claude.ai ou no app do Claude para computador e celular:
- 1Abra Configurações → Conectores e clique em Adicionar conector personalizado.
- 2Dê o nome Leaper e cole o endereço https://mcp.leaper.com.br/mcp.
- 3Clique em Conectar. Na janela da Leaper, entre com seu e-mail e senha, escolha a empresa e clique em Autorizar.
- 4Abra uma conversa nova e confira se a Leaper aparece ligada no menu de ferramentas da conversa.
ChatGPT
- 1Abra Configurações → Apps e conectores e, em Configurações avançadas, ative o modo desenvolvedor.
- 2Volte em Apps e conectores e clique em Criar.
- 3Dê o nome Leaper, cole o endereço https://mcp.leaper.com.br/mcp e escolha a autenticação OAuth.
- 4Na janela da Leaper, entre, escolha a empresa e clique em Autorizar.
- 5Numa conversa nova, ative a Leaper no menu + antes de fazer a pergunta.
Claude Code e outros assistentes
Qualquer client compatível com MCP por HTTP (Streamable HTTP) e OAuth funciona. No Claude Code:
claude mcp add --transport http leaper https://mcp.leaper.com.br/mcp
Depois rode /mcp dentro do Claude Code, escolha leaper e autorize no navegador.
Uma empresa por conexão
Cada conexão dá acesso a uma única empresa: a que você escolheu na hora de autorizar. Para perguntar qual empresa está ligada, peça ao assistente "em qual empresa da Leaper você está conectado?".
Se você usa a Leaper com mais de uma empresa, como numa agência, desconecte e conecte de novo escolhendo a outra empresa. Por enquanto não dá para consultar duas empresas na mesma conversa.
Permissões
Na tela de autorização a Leaper mostra o que o assistente vai poder fazer:
| Permissão | O que libera |
|---|---|
| Ver leads | Leads, conversas de WhatsApp, etapas do funil e dados da empresa |
| Alterar leads | Criar e atualizar leads e mover leads de etapa |
| Ver relatórios | Relatórios de leads, campanhas, anúncios e palavras-chave, inclusive o gasto do gerenciador de anúncios |
Ferramentas
Estas são as ferramentas que o assistente recebe. Você não precisa chamá-las pelo nome: basta pedir o que quer.
| Ferramenta | O que faz |
|---|---|
| buscar_leads | Procura leads por nome, telefone, e-mail, etapa, origem, tag ou período |
| obter_lead | Dados de um lead: contato, campos personalizados, valor, etapa e origem (campanha, anúncio, UTM) |
| obter_conversa_lead | Mensagens de WhatsApp do lead, das mais recentes para as mais antigas |
| obter_historico_etapas_lead | Por quais etapas do funil o lead passou, e quando |
| listar_etapas_funil | Etapas do funil da empresa, na ordem |
| obter_empresa | Empresa a que a conexão dá acesso |
| relatorio_leads | Resumo do período, leads por etapa, origem, campanha, anúncio e palavra-chave, evolução ao longo do tempo e tempo de funil |
| criar_lead | Cria um lead na primeira etapa do funil |
| atualizar_lead | Atualiza só os dados informados de um lead |
| mover_lead_etapa | Move um lead para outra etapa do funil |
Antes de usar
- Números de mídia e números da Leaper são diferentes. Gasto, cliques e conversões de mídia vêm do gerenciador do Meta e do Google. Leads e vendas vêm da atribuição da Leaper. Os dois não batem um com o outro, e o assistente informa de onde vem cada número.
- Relatórios cobrem até 92 dias por consulta. Para períodos maiores, peça um trimestre de cada vez.
- O assistente pode errar. Para decisões importantes, confira os números na plataforma.
Desconectar
Na Leaper, abra Configurações → Aplicativos conectados. Lá aparecem os assistentes ligados à empresa, quem conectou cada um e quando ele foi usado pela última vez. Clique em Desconectar e o acesso é cortado na hora, mesmo que o conector continue instalado no assistente.
Para tirar o conector também do assistente, remova a Leaper nas configurações de conectores do Claude ou do ChatGPT.
Dados técnicos
Para quem vai configurar um client MCP próprio:
| Item | Valor |
|---|---|
| Endereço do servidor | https://mcp.leaper.com.br/mcp |
| Transporte | Streamable HTTP |
| Autenticação | OAuth 2.1 com PKCE, via https://api.external.leaper.com.br |
| Registro do client | Client ID Metadata Document (client_id é uma URL HTTPS) |
| Escopos | leads:read, leads:write, reports:read |
Se você prefere integrar o seu sistema direto, sem assistente de IA, use a API de Integração e os webhooks.
