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

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

```text title="Endereço do conector"
https://mcp.leaper.com.br/mcp
```

### Claude

No [claude.ai](https://claude.ai) ou no app do Claude para computador e celular:

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

### ChatGPT

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

```bash title="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.

> [!NOTE]
> 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ã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

> [!WARNING]
> 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:

| 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](https://leaper.com.br/desenvolvedores/guia/) e os [webhooks](https://leaper.com.br/desenvolvedores/webhooks/).
