Leaper Desenvolvedores
Central de Ajuda Entrar
MCP

Leaper no Claude e no ChatGPT (MCP)

Conecte a Leaper ao seu assistente de IA e converse com os dados do seu CRM: pergunte quais campanhas trouxeram mais vendas, peça o resumo da conversa de um lead ou mande mover um lead de etapa, tudo em português e sem exportar planilha. A conexão usa o MCP (Model Context Protocol), o padrão aberto que Claude, ChatGPT e outros assistentes usam para acessar sistemas externos. Você entra com o seu usuário da Leaper, escolhe a empresa e autoriza. Não precisa de chave de API nem de programação.

Abrir no ChatGPT ↗ Abrir no Claude ↗ Ver .md
Endereço do conector
https://mcp.leaper.com.br/mcp

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.

Endereço do conector
https://mcp.leaper.com.br/mcp

Claude

No claude.ai ou no app do Claude para computador e celular:

  1. 1Abra Configurações → Conectores e clique em Adicionar conector personalizado.
  2. 2Dê o nome Leaper e cole o endereço https://mcp.leaper.com.br/mcp.
  3. 3Clique em Conectar. Na janela da Leaper, entre com seu e-mail e senha, escolha a empresa e clique em Autorizar.
  4. 4Abra uma conversa nova e confira se a Leaper aparece ligada no menu de ferramentas da conversa.

ChatGPT

  1. 1Abra Configurações → Apps e conectores e, em Configurações avançadas, ative o modo desenvolvedor.
  2. 2Volte em Apps e conectores e clique em Criar.
  3. 3Dê o nome Leaper, cole o endereço https://mcp.leaper.com.br/mcp e escolha a autenticação OAuth.
  4. 4Na janela da Leaper, entre, escolha a empresa e clique em Autorizar.
  5. 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:

Terminal
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.

Observação A conexão dá acesso aos dados da empresa escolhida, e as alterações feitas pelo assistente ficam registradas no seu usuário, como se você mesmo tivesse feito pela plataforma.

Permissões

Na tela de autorização a Leaper mostra o que o assistente vai poder fazer:

PermissãoO que libera
Ver leadsLeads, conversas de WhatsApp, etapas do funil e dados da empresa
Alterar leadsCriar e atualizar leads e mover leads de etapa
Ver relatóriosRelató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.

FerramentaO que faz
buscar_leadsProcura leads por nome, telefone, e-mail, etapa, origem, tag ou período
obter_leadDados de um lead: contato, campos personalizados, valor, etapa e origem (campanha, anúncio, UTM)
obter_conversa_leadMensagens de WhatsApp do lead, das mais recentes para as mais antigas
obter_historico_etapas_leadPor quais etapas do funil o lead passou, e quando
listar_etapas_funilEtapas do funil da empresa, na ordem
obter_empresaEmpresa a que a conexão dá acesso
relatorio_leadsResumo do período, leads por etapa, origem, campanha, anúncio e palavra-chave, evolução ao longo do tempo e tempo de funil
criar_leadCria um lead na primeira etapa do funil
atualizar_leadAtualiza só os dados informados de um lead
mover_lead_etapaMove um lead para outra etapa do funil

Antes de usar

Atenção Mover um lead de etapa pelo assistente tem o mesmo efeito de mover pela plataforma: dispara as conversões configuradas para o Meta Ads e o Google Ads e os webhooks da empresa. Confira a etapa antes de confirmar.
  • 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:

ItemValor
Endereço do servidorhttps://mcp.leaper.com.br/mcp
TransporteStreamable HTTP
AutenticaçãoOAuth 2.1 com PKCE, via https://api.external.leaper.com.br
Registro do clientClient ID Metadata Document (client_id é uma URL HTTPS)
Escoposleads: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.