Você precisa de três coisas
- Uma conta Reachant com o e-mail verificado. Criar conta grátis.
- O uv instalado no seu computador. É o gerenciador que baixa e roda o conector. Instalar o uv leva um comando.
- Um cliente com suporte a MCP: Claude Desktop, Claude Code ou Cursor.
reachant-mcp, é um pacote público que roda na sua máquina e fala com a sua conta usando a sua chave.Três passos, uma vez só
Gere a sua chave
No app, abra Configurações → Integrações, dê um nome à chave (por exemplo, "Claude") e clique em Gerar chave. Ela começa com rk_.
Cole a configuração no seu cliente
Troque REACHANT_API_KEY pela chave que você copiou. Depois reinicie o cliente.
Claude Desktop
Abra Configurações → Desenvolvedor → Editar configuração. Isso abre o arquivo claude_desktop_config.json. Cole dentro dele:
{
"mcpServers": {
"reachant": {
"command": "uvx",
"args": [
"reachant-mcp"
],
"env": {
"REACHANT_API_KEY": "REACHANT_API_KEY"
}
}
}
}
Claude Code
No terminal, um comando registra o conector:
claude mcp add reachant -e REACHANT_API_KEY=REACHANT_API_KEY -- uvx reachant-mcp
Cursor
Crie ou edite o arquivo .cursor/mcp.json na raiz do projeto, ou ~/.cursor/mcp.json para valer em todos os projetos:
{
"mcpServers": {
"reachant": {
"command": "uvx",
"args": [
"reachant-mcp"
],
"env": {
"REACHANT_API_KEY": "REACHANT_API_KEY"
}
}
}
}
Faça a primeira pergunta
Pergunte ao assistente: "Qual é o meu saldo no Reachant?" Se ele responder com o seu plano, os leads e os créditos restantes, está tudo conectado.
Na primeira vez o uvx baixa o conector, o que pode levar alguns segundos.
Estimar, confirmar, executar
Uma busca gasta leads e créditos do seu plano, então o assistente não consegue rodá-la direto. O fluxo tem três partes e só a última custa algo.
Estimativa
O assistente valida as categorias e a região e recebe quantos leads serão concedidos, quantos créditos custam e avisos, como saldo baixo.
Confirmação
Ele mostra os números e pergunta. A busca só segue com o seu sim explícito.
Execução
A estimativa vira um token válido por 15 minutos e de uso único. Repetir o pedido não cobra duas vezes.
O que você paga
- Leads: cada empresa encontrada consome um lead do seu ciclo. Se pedir 200 e tiver 40, a busca traz 40 e o assistente avisa.
- Créditos: o enriquecimento de cada lead (site, e-mail, sócios, decisor) consome créditos. Se os créditos acabarem no meio, os leads restantes ficam com os dados básicos e o assistente informa.
- Nenhum valor em dinheiro entra na conversa. Só leads e créditos do plano.
Limites e tempos
- Até 5 categorias por busca. Os leads são divididos igualmente entre elas: 40 leads em 4 categorias dá 10 por categoria.
- Até 200 leads por pedido, sempre cortado ao seu saldo.
- Os dados básicos (nome, telefone, endereço) aparecem em cerca de um minuto. O enriquecimento roda em seguida e leva alguns minutos. Você pode listar os leads enquanto ele acontece.
- O CSV sai como um link válido por uma hora. O assistente entrega o link; você clica.
O que o assistente consegue fazer
Você não precisa decorar nenhum nome. Estes são os comandos que o assistente escolhe sozinho a partir do que você pede. Só um deles gasta.
| Ferramenta | O que faz | Gasta? |
|---|---|---|
| get_account_status | Plano, leads e créditos restantes, e se a conta pode buscar agora. | não |
| list_categories | Traduz termos livres ("dentista", "ortodontista") para as categorias exatas aceitas em cada mercado. | não |
| estimate_search | Valida a busca e devolve leads concedidos, créditos, avisos e o token de confirmação. | não |
| run_search | Executa a busca aprovada. Aceita apenas o token da estimativa que você confirmou. | sim |
| get_search | Progresso de uma busca: fase, leads encontrados, leads enriquecidos. | não |
| list_searches | Suas buscas recentes, para achar "a busca de dentistas de ontem". | não |
| list_leads | Leads de uma busca em páginas de até 50, com filtros como "só quem tem e-mail". | não |
| get_lead | Ficha completa de um lead: contatos, redes, decisores, dados da empresa. | não |
| export_leads_csv | Link para baixar o CSV da busca, válido por uma hora. | não |
Fale como você falaria com uma pessoa
- Quero 50 clínicas de estética em Belo Horizonte.
- Busca 100 escritórios de contabilidade em Austin, Texas.
- Como está a busca de ontem? Já terminou?
- Me mostra só os leads que têm e-mail.
- Quem é o decisor da terceira empresa da lista?
- Exporta essa lista em CSV.
Dica: peça pelo segmento inteiro, não só por uma palavra. "Dentistas" costuma render mais leads quando o assistente inclui ortodontia, endodontia e implantes, e a estimativa mostra o custo antes.
Quando algo não funciona
Missing or invalid API keyA chave está errada, incompleta ou foi revogada. Gere uma nova em Configurações → Integrações e atualize a configuração do cliente.Email verification requiredSua conta ainda não confirmou o e-mail. Abra o link que enviamos ou peça um novo no app.subscription_inactiveA conta não pode buscar agora: assinatura pendente ou suspensa. Veja Configurações → Plano no app.quota_exhaustedOs leads do ciclo acabaram. Eles voltam no próximo ciclo, ou antes com um upgrade.token_expiredPassaram mais de 15 minutos entre a estimativa e a confirmação. Peça uma nova estimativa.credits_lowÉ um aviso, não um erro: a busca roda, mas parte dos leads fica sem enriquecimento porque os créditos não cobrem todos.uvx: command not foundO uv não está instalado ou o cliente foi aberto antes da instalação. Instale o uv e reinicie o Claude ou o Cursor.O servidor não apareceConfira se o JSON ficou válido (vírgulas e chaves) e se o cliente foi reiniciado depois de salvar.
O que a chave pode e não pode fazer
- A chave dá acesso só à sua conta: leads, buscas e saldo. Não altera plano, pagamento nem dados da conta.
- Guardamos apenas um resumo criptográfico da chave. Ninguém, nem o suporte, consegue ler a chave depois de gerada.
- Você revoga qualquer chave a qualquer momento em Configurações → Integrações. Clientes que usam essa chave param na hora.
- Nenhuma busca roda sem a sua confirmação na conversa. A estimativa é grátis e o token de execução vale uma vez só.
- Trate a chave como uma senha: não a compartilhe nem a envie em conversas. O arquivo de configuração fica só no seu computador.