Use com IA · MCP

Peça a lista ao Claude. O Reachant faz a busca.

Conecte sua conta ao Claude Desktop, ao Claude Code ou ao Cursor e prospecte conversando. Antes de cada busca você vê quantos leads e créditos vai usar, e nada roda sem o seu sim.

Configuração em 5 minutos Nada é gasto sem confirmação Funciona em todos os planos
Claude Desktop · Reachant conectado
Quero 50 dentistas em Curitiba.
get_account_status list_categories dentista, ortodontista, implante dentário estimate_search 50 leads · 3 categorias
50 leads em 3 categorias em Curitiba, PR: 50 créditos. Depois sobram 950 leads e 2.850 créditos no ciclo. Confirma?
Confirma.
run_search
Busca #124 iniciada. Os dados básicos aparecem em um minuto e o enriquecimento leva alguns. Quer ver os primeiros leads?
Antes de começar

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.
MCP é o protocolo aberto que permite a um assistente de IA usar ferramentas externas. O conector do Reachant, reachant-mcp, é um pacote público que roda na sua máquina e fala com a sua conta usando a sua chave.
Passo a passo

Três passos, uma vez só

/ 01

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

A chave aparece uma única vez. Copie na hora. Se perder, revogue e gere outra. Cada conta pode ter até 5 chaves ativas.
/ 02

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:

claude_desktop_config.json
{
  "mcpServers": {
    "reachant": {
      "command": "uvx",
      "args": [
        "reachant-mcp"
      ],
      "env": {
        "REACHANT_API_KEY": "REACHANT_API_KEY"
      }
    }
  }
}

Claude Code

No terminal, um comando registra o conector:

terminal
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:

.cursor/mcp.json
{
  "mcpServers": {
    "reachant": {
      "command": "uvx",
      "args": [
        "reachant-mcp"
      ],
      "env": {
        "REACHANT_API_KEY": "REACHANT_API_KEY"
      }
    }
  }
}
/ 03

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.

Como a busca funciona

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.

1 · grátis

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.

2 · você

Confirmação

Ele mostra os números e pergunta. A busca só segue com o seu sim explícito.

3 · gasta

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.
As nove ferramentas

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.

FerramentaO que fazGasta?
get_account_statusPlano, leads e créditos restantes, e se a conta pode buscar agora.não
list_categoriesTraduz termos livres ("dentista", "ortodontista") para as categorias exatas aceitas em cada mercado.não
estimate_searchValida a busca e devolve leads concedidos, créditos, avisos e o token de confirmação.não
run_searchExecuta a busca aprovada. Aceita apenas o token da estimativa que você confirmou.sim
get_searchProgresso de uma busca: fase, leads encontrados, leads enriquecidos.não
list_searchesSuas buscas recentes, para achar "a busca de dentistas de ontem".não
list_leadsLeads de uma busca em páginas de até 50, com filtros como "só quem tem e-mail".não
get_leadFicha completa de um lead: contatos, redes, decisores, dados da empresa.não
export_leads_csvLink para baixar o CSV da busca, válido por uma hora.não
Exemplos de pedidos

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.

Erros comuns

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.
Segurança

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.