Leadbay

npx add-mcp 'https://mcp.leadbay.app/mcp'

Leadbay MCP

O Leadbay MCP conecta seu assistente de IA à sua conta Leadbay, para que você possa trabalhar seus leads simplesmente pedindo.

Puxe leads, qualifique-os, rascunhe abordagens e registre atividades — em linguagem natural. Seu assistente age sobre seus dados reais do Leadbay, com suas permissões, exatamente como você faria no aplicativo.

Tudo é personalizado — nada para configurar. O Leadbay executa IA avançada no seu site e em dados de mercado para originar e pontuar leads de acordo com seu perfil-alvo, tornando a abordagem uma conexão significativa em vez de spam sem sentido.

Diga ao seu assistente quais leads prospectar, conecte seus canais, e ele busca contatos no Leadbay e cuida da abordagem em seu nome. Aproveite a abordagem que você não precisa mais fazer.

MCP significa Model Context Protocol — um padrão aberto que permite que assistentes de IA como o Claude se conectem com segurança a ferramentas e dados externos. Este servidor é open source e está em github.com/leadbay/mcp.

---

Como o Leadbay pensa (modelo mental para seu agente)

• Caixa de entrada, não um banco de dados. A cada dia que seu usuário faz login, um novo lote de leads é entregue. O tamanho do lote é ritmado por quantos leads o usuário realmente agiu recentemente — alguns fluxos de trabalho produzem um grande fluxo de prospects menores, outros um fluxo estreito de maiores. Puxar mais não produzirá mais; agir sobre os leads produz.
• Duas camadas de pontuação. Cada lead vem com um score básico (firmográfico — já decente, geralmente correlacionado com IA). Aproximadamente os 10 primeiros de cada lote também são qualificados por IA (pesquisa web direcionada + perguntas de qualificação → ai_agent_lead_score). Leads abaixo dos 10 primeiros não são piores — o sistema está economizando recursos. O agente pode solicitar qualificação mais profunda (leadbay_bulk_qualify_leads) ou enriquecimento de contato (leadbay_enrich_titles) em qualquer lead que pareça valer a pena.
• Ritmo diário. O agente funciona melhor como um check-in diário: puxe leads frescos, examine os melhores auto-qualificados, aprofunde 1-3 promissores, proponha abordagem e registre o que foi realmente enviado via leadbay_report_outreach. Se seu host suportar agendamento, configure uma execução diária.

---

Para usuários

Coloque o Leadbay MCP em funcionamento dentro do seu assistente de IA em alguns minutos. Sem necessidade de codificação.

Novo no Leadbay? O passo a passo amigável, com capturas de tela — o que é uma lente, como funciona a pontuação e a configuração completa do MCP para cada assistente — está no guia do usuário do Leadbay. Este README é o companheiro técnico.

Ainda não tem conta no Leadbay? Crie uma aqui primeiro — você precisará dela para entrar durante a configuração.

Conecte-se na web (sem instalação)

Se você usa o Claude na web, Claude Desktop ou ChatGPT, o caminho mais rápido é um conector personalizado — sem terminal, sem tokens para copiar. Adicione uma URL e entre com seu navegador:

• Nome: Leadbay
• URL: https://mcp.leadbay.app/mcp — uma URL para todas as regiões (/fr/mcp permanece como um alias de compatibilidade)
• No ChatGPT, use https://mcp.leadbay.app/chatgpt/mcp em vez disso. Mesmo servidor, mesmo login, mesmos leads — mas o assistente não pode gerar um link de recarga ou abrir sua página de cobrança lá, porque o diretório de aplicativos da OpenAI não permite que um aplicativo venda créditos. Compre créditos ou mude seu plano na sua conta Leadbay.

No Claude: Configurações → Conectores → + → Adicionar conector personalizado, cole a URL, abra o conector e clique em Conectar. Entre com o Leadbay, clique em Aprovar e você está vinculado. O servidor lida com OAuth no aplicativo; as atualizações são automáticas — você nunca toca em um arquivo de configuração.

Instale no Claude Desktop (pacote de um clique)

Prefere uma extensão de desktop empacotada? Pegue o arquivo de um clique.

1. Baixe a extensão

👉 Baixe o Leadbay MCP mais recente para Claude (.dxt)

Na página de releases, clique no arquivo que termina em .dxt para baixá-lo.

2. Instale-o

Clique duas vezes no arquivo .dxt baixado. O Claude abre e mostra um diálogo de instalação — clique em Instalar e pronto.

Se o clique duplo não abrir o Claude, instale manualmente:

1. Abra o Claude e vá para perfil → Configurações → Extensões.
2. Abra Configurações avançadas.
3. Escolha Instalar extensão… e selecione o arquivo .dxt que você baixou.

3. Entre

O Claude solicitará que você conecte o Leadbay. Entre com sua conta Leadbay e você está pronto — basta pedir leads ao seu agente.

Usando um assistente local?

O Leadbay MCP também funciona com Claude Code, Claude Desktop, Cursor e Codex. O instalador universal configura tudo para você e permite entrar com o Leadbay.

Requer Node.js 22+. Em seguida, execute:

npx -y -p @leadbay/mcp@latest installer

Ele abre no seu navegador, onde você clica em Entrar com Leadbay e escolhe quais assistentes conectar. Funciona em macOS, Windows e Linux.

Para desinstalar, execute o mesmo instalador com --uninstall:

npx -y -p @leadbay/mcp@latest installer --uninstall

Ele abre uma janela de desinstalação mostrando apenas os assistentes que têm o Leadbay conectado — escolha os que deseja remover e clique em Remover selecionados. Ele remove apenas o Leadbay; suas outras configurações e conexões ficam intactas.

Peça seus primeiros leads

Abra uma nova conversa e descreva o resultado — você nunca nomeia uma ferramenta, apenas diz o que quer, do jeito que pediria a um colega:

Mostre-me os leads de hoje e diga quais dois valem a pena abrir primeiro.

Uma primeira resposta bem-sucedida é uma tabela classificada de prospects, não uma parede de texto: cada linha tem uma pontuação de adequação, uma linha de por que se encaixa e o melhor contato para alcançar. Depois continue:

Pesquise o primeiro — é adequado para nós?

Rascunhe um e-mail de abordagem para eles.

Acabei de enviar um e-mail para eles. Registre como abordagem.

---

Para desenvolvedores

Tudo abaixo é para contribuidores e qualquer pessoa que execute o Leadbay MCP a partir do código-fonte ou o integre à automação.

Instale uma versão local com o instalador personalizado

Para executar seu checkout local (em vez do pacote publicado), primeiro compile-o a partir do código-fonte:

pnpm install
pnpm prompts:build
pnpm -r build

Em seguida, aponte o instalador para sua versão recém-compilada com --local:

pnpm --filter @leadbay/mcp installer -- --local

--local registra o(s) cliente(s) MCP contra o build em sua árvore de trabalho em vez de @leadbay/mcp@latest. O OAuth é tratado automaticamente — você não precisa passar --oauth. O instalador pergunta por destino antes de escrever qualquer coisa.

Todos os métodos de instalação

Cada maneira suportada de conectar o Leadbay MCP:

Método	Comando / ação	Plataformas	Notas
Conector hospedado (sem instalação)	Adicionar conector personalizado → https://mcp.leadbay.app/mcp (todas as regiões)	Claude web / Desktop	OAuth no navegador no aplicativo. Nada para instalar; atualizações automáticas.
Conector hospedado — ChatGPT	Adicionar conector personalizado → https://mcp.leadbay.app/chatgpt/mcp	ChatGPT	Mesmo servidor; as ferramentas de recarga e cobrança não são registradas (regra do diretório OpenAI).
Pacote .dxt / .mcpb	Baixe de Releases, clique duas vezes → Instalar	Claude Desktop	Extensão de desktop de um clique.
Instalador guiado (GUI)	npx -y -p @leadbay/mcp@latest installer	macOS, Windows, Linux	Assistente no navegador: entre com Leadbay, escolha clientes. Funciona para todos.
Build de desenvolvimento local	pnpm --filter @leadbay/mcp installer -- --local	macOS, Windows, Linux	Registra clientes contra seu build local. OAuth automático. Compile a partir do código-fonte primeiro (acima).
Mercado de plugins do Claude Code	/plugin marketplace add leadbay/mcp e depois /plugin install leadbay@leadbay-mcp	Claude Code	Registra o servidor MCP e instala habilidades de acionamento automático.

O que cada instalador escreve por cliente

Os instaladores GUI/CLI tocam apenas nos clientes realmente instalados na máquina:

Cliente	Comportamento do instalador
Claude Code	Registra/remove leadbay com claude mcp add/remove --scope user
Claude Desktop	Escreve/remove apenas a entrada mcpServers.leadbay em claude_desktop_config.json
Cursor	Escreve/remove apenas a entrada mcpServers.leadbay na configuração MCP do Cursor
Codex	Escreve/remove apenas o bloco [mcp_servers.leadbay] em ~/.codex/config.toml e o bloco de exportação de shell gerenciado pelo Leadbay

Mercado de plugins do Claude Code

/plugin marketplace add leadbay/mcp

/plugin install leadbay@leadbay-mcp

O Claude Code solicita autenticação/configuração do Leadbay. Registra o servidor MCP e instala um conjunto de habilidades que acionam automaticamente em pedidos em linguagem natural — incluindo leadbay_daily_check_in ("pegue meus leads hoje"), leadbay_research_a_domain ("pesquise acme.com"), leadbay_followup_check_in, leadbay_qualify_top_n, leadbay_refine_audience, leadbay_log_outreach, leadbay_import_file, leadbay_plan_tour_in_city, leadbay_prospecting_overview, leadbay_extend_my_lens, leadbay_setup_team_prospecting, leadbay_build_campaign e leadbay_work_campaign. Cada SKILL.md é gerado por @leadbay/promptforge a partir da mesma fonte dos prompts MCP, para que as duas superfícies nunca divergem.

Desinstalação

npx -y -p @leadbay/mcp@latest installer --uninstall

Abre o assistente de desinstalação — mostra apenas clientes que já têm o Leadbay MCP configurado. Remove o registro do Claude Code, remove a estrofe JSON das configurações do Claude Desktop / Cursor, remove o bloco TOML [mcp_servers.leadbay] do Codex e remove o bloco gerenciado export LEADBAY_* de ~/.zshrc / ~/.bashrc. A desinstalação é limitada ao Leadbay — nunca reescreve configurações não relacionadas do cliente nem remove outros servidores MCP.

Ferramentas

Seu assistente chama estas em seu nome — você nunca as chama diretamente. Você pede em linguagem natural ("mostre-me os leads de hoje", "pesquise acme.com", "registre que enviei um e-mail para a Jane") e o agente escolhe a ferramenta certa. A superfície padrão abaixo está sempre exposta; a referência completa por ferramenta está no guia do usuário.

Ferramentas de leitura (sempre ativas)

Estas respondem perguntas sobre sua conta. Nenhuma delas cria, exclui ou envia nada. Algumas escrevem uma pequena coisa de volta ao responder — quais leads foram mostrados a você, ou o filtro que você pediu — e a tabela diz quais, porque é por isso que não são rotuladas como somente leitura pela rede.

Descubra e acompanhe

Ferramenta	Descrição
leadbay_pull_leads	Puxe o lote fresco de leads pontuados e classificados de hoje. Registra cada um como visto, para que saia do lote de amanhã
leadbay_pull_followups	Puxe os leads que precisam de uma ação de acompanhamento. Salva o filtro quando você pede um
leadbay_account_status	Verifique cota, créditos e estado da conta
leadbay_scan_portfolio_signals	Examine seus leads existentes em busca de um sinal web em uma passada ("quais dos meus leads adquiriram uma empresa desde 2025?") — sem queimar cota. Salva o filtro quando você pede um

Pesquise uma empresa

Ferramenta	Descrição
leadbay_research_lead_by_id	Cartão de pesquisa aprofundada para um lead conhecido — detalhes + qualificação por IA + contatos em uma resposta. Registra o lead como visto
leadbay_research_lead_by_name_fuzzy	Procure um lead pelo nome da empresa ou domínio quando você não tem o ID. Registra o lead encontrado como visto
leadbay_account_history	Histórico completo de uma conta — sinais de IA atuais + todas as notas + linha do tempo de interações, em uma chamada ("por que esta conta ressurgiu?"). Registra o lead como visto
leadbay_prepare_outreach	Construa um resumo de abordagem personalizado para um lead. Com enriquecimento ativado, também ordena os detalhes do contato

Viagens e vendas de campo

Ferramenta	Descrição
leadbay_followups_map	Agrupe geograficamente seus acompanhamentos em um mapa para planejamento de viagem. Salva o filtro quando você pede um
leadbay_tour_plan	Construa um itinerário de visitas para uma próxima viagem a uma cidade. Registra os novos leads que mostra como vistos

Campanhas

Ferramenta	Descrição
leadbay_list_campaigns	Liste suas campanhas existentes
leadbay_campaign_progression	Mostre as métricas de funil de uma campanha
leadbay_campaign_call_sheet	Puxe a folha de chamadas de uma campanha

Lentes, público e qualificação

Ferramenta	Descrição
leadbay_list_sectors	Lista os rótulos reais da taxonomia de setores — para que você (e o agente) nomeiem setores corretamente, sem adivinhar
leadbay_list_previously_enriched_titles	Recupera os títulos de cargos previamente enriquecidos pela organização (use antes de leadbay_enrich_titles)
leadbay_list_lens_seed_candidates	Superfície de descoberta somente leitura para construir uma visão mais ampla
leadbay_get_qualification_questions	Recupera as perguntas de qualificação do agente de IA da organização (como os leads são pontuados)
leadbay_get_lead_custom_fields	Recupera os valores de campos personalizados armazenados em um lead. Registra o lead como visto
leadbay_list_mappable_fields	Lista os campos do CRM nos quais você pode mapear uma importação. Dadas linhas de exemplo, envia-as para obter as sugestões de mapeamento do backend

Importações e trabalhos

Ferramenta	Descrição
leadbay_import_status	Status de um trabalho de importação em execução
leadbay_qualify_status	Status de um trabalho de qualificação em execução
leadbay_bulk_enrich_status	Status de um trabalho de enriquecimento em execução
leadbay_resolve_import_rows	Mapeia linhas importadas de volta para seus IDs de lead

Equipe, cobrança e sinais de produto

Ferramenta	Descrição
leadbay_team_activity	Ranking por representante voltado a gerentes + tendência de atividade (não administradores são limitados a si mesmos)
leadbay_create_topup_link	Gera um link de recarga do Stripe (você paga no seu navegador — nada é cobrado automaticamente)
leadbay_open_billing_portal	Abre o portal de cobrança
leadbay_acknowledge_notification	Limpa uma notificação de trabalho em lote terminal para que ela pare de reaparecer
leadbay_report_friction	Reporta um problema à equipe do Leadbay — pergunta primeiro e mostra o que foi enviado (nenhuma alteração na conta)
leadbay_get_artifact_runtime	Busca os view-models headless que o agente usa para construir um artefato HTML interativo

Ações de escrita (ativas por padrão desde 0.3.0; defina LEADBAY_MCP_WRITE=0 para desativar)

Estas ações afetam sua conta. Cada ação é algo que você mesmo poderia fazer no aplicativo — não há nada destrutivo no nível da plataforma, e exclusões são confirmadas antes de executar.

Qualificar e enriquecer

Ferramenta	Descrição
leadbay_bulk_qualify_leads	Dispara qualificação por IA em um lote de leads
leadbay_enrich_titles	Enriquece contatos por título de cargo
leadbay_enrich_contacts	Enriquece uma pessoa específica (e-mail / telefone) — o contato que você nomear, não um título de cargo

Prospecção e atividade

Ferramenta	Descrição
leadbay_report_outreach	Registra uma ação de prospecção (ligação, e-mail, reunião) — obrigatório após cada contato
leadbay_add_note	Adiciona uma nota a um lead
leadbay_like_lead	Marca um lead como curtido — ensina seu perfil de preferências
leadbay_dislike_lead	Marca um lead como não curtido — ensina seu perfil de preferências

Contatos

Ferramenta	Descrição
leadbay_add_contact	Adiciona uma pessoa a uma empresa (nome + LinkedIn / cargo / e-mail / telefone opcionais)
leadbay_remove_contact	Remove um contato que você adicionou
leadbay_pin_contact	Fixa um contato como prioridade em uma empresa
leadbay_unpin_contact	Desfixa um contato
leadbay_update_contact	Edita os detalhes de um contato (cargo, e-mail, LinkedIn…)

Lentes e público

Ferramenta	Descrição
leadbay_manage_lenses	Lista, alterna, renomeia/descreve ou exclui suas lentes (exclusão é confirmada antes de executar)
leadbay_new_lens	Cria uma lente nomeada com critérios de setor / tamanho da empresa (e localização opcional)
leadbay_adjust_audience	Edita o público de uma lente ("pare de me mostrar empresas com mais de 50 funcionários"); passe lensName para editar uma lente pelo nome
leadbay_extend_lens	Preenche sua lente atual com mais leads sob demanda (sujeito a uma cota diária de recarga)
leadbay_refine_lead_targeting	Refina o prompt de qualificação que pontua seus leads
leadbay_answer_clarification	Responde a uma pergunta de esclarecimento que o Leadbay fez sobre seu público

Importações e campanhas

Ferramenta	Descrição
leadbay_import_leads	Importa uma lista de domínios de empresas
leadbay_import_and_qualify	Importa uma lista e a qualifica imediatamente
leadbay_create_campaign	Cria uma nova campanha
leadbay_add_leads_to_campaign	Adiciona leads a uma campanha
leadbay_remove_leads_from_campaign	Remove leads de uma campanha

Campos personalizados e perguntas de qualificação

Ferramenta	Descrição
leadbay_create_custom_field	Cria um campo personalizado no CRM (ex.: para preservar um ID do sistema de origem)
leadbay_update_custom_field	Renomeia ou altera o tipo de um campo personalizado
leadbay_delete_custom_field	Exclui um campo personalizado (confirmado antes de executar)
leadbay_set_qualification_questions	Modifica as perguntas de qualificação do agente de IA da organização (máx. 5; remoções confirmadas antes de executar)

Feedback

Ferramenta	Descrição
leadbay_send_feedback	Envia uma mensagem à equipe do Leadbay (mesma caixa de entrada do formulário de feedback no aplicativo)

Ferramentas granulares avançadas (controladas por LEADBAY_MCP_ADVANCED=1)

Ferramentas de baixo nível, de chamada única à API, para usuários avançados e integrações (leadbay_discover_leads, leadbay_get_lead_profile, leadbay_get_contacts, leadbay_list_lenses, …). Desativadas por padrão; ative definindo LEADBAY_MCP_ADVANCED=1 no ambiente do servidor MCP. Veja packages/mcp/README.md para a lista completa.

Como funciona

O servidor MCP usa automaticamente sua lente ativa (a última lente que você usou no Leadbay). Basta chamar leadbay_pull_leads e funciona — nenhuma configuração de lente é necessária.

Você também pode gerenciar lentes diretamente do chat: leadbay_manage_lenses as lista e alterna/renomeia/exclui; leadbay_new_lens cria uma nomeada com critérios de setor/tamanho; e leadbay_adjust_audience edita uma lente existente (a ativa, ou qualquer lente pelo nome via lensName). Nomes de setores são resolvidos contra a taxonomia ao vivo — leadbay_list_sectors revela os rótulos reais.

leadbay_research_lead_by_id agrupa múltiplas chamadas à API (detalhes do lead + qualificação por IA + contatos) em uma única resposta. Se alguns dados ainda não estiverem disponíveis, retorna resultados parciais em vez de falhar.

Configuração

Variável de ambiente	Obrigatória	Descrição
LEADBAY_TOKEN	Sim	Credencial OAuth bearer local (definida pelo instalador)
LEADBAY_REGION	Sim	us ou fr
LEADBAY_MCP_WRITE	Não	Defina como 0 para desativar ferramentas de escrita (padrão: ativas desde 0.3.0)
LEADBAY_MCP_ADVANCED	Não	Defina como 1 para expor ferramentas granulares (padrão: desativadas)
LEADBAY_BASE_URL	Não	Substitui a URL da API (para staging/dev)
LEADBAY_TIMEOUT_MS	Não	Prazo final de segurança para uma solicitação de saída, em ms (padrão: 600000)

A referência completa de variáveis de ambiente (telemetria, modo mock, registro, timeouts) está em packages/mcp/README.md.

Fluxos de trabalho

O inventário canônico do que o MCP suporta — suportado / parcial / planejado / bloqueado no backend — é WORKFLOWS.md. Use-o para triar solicitações recebidas: encontre a linha correspondente ou adicione uma nova. Uma pequena auditoria garante que toda ferramenta/prompt e caminho de teste citado seja real, para que a tabela não possa divergir silenciosamente.

Amostra rápida:

leadbay_pull_leads → leadbay_research_lead_by_id → leadbay_prepare_outreach   # discover & research
leadbay_pull_followups → leadbay_followups_map → leadbay_prepare_outreach     # travel/geo follow-ups
leadbay_import_leads → leadbay_bulk_qualify_leads                             # import & qualify

Requisitos

• Node.js 22+
• Uma conta Leadbay

Política de Privacidade

O servidor MCP do Leadbay acessa os dados da sua conta Leadbay (leads, contatos, campanhas, notas) em seu nome por meio da API do Leadbay, usando um token que você autoriza via OAuth. Ele não lê seu histórico de conversas, memória do Claude ou arquivos locais. O tratamento de dados é regido pela política de privacidade e pelos termos de uso do Leadbay.

Compilando a partir do código-fonte

pnpm install

pnpm prompts:build

pnpm -r build

pnpm -r test

pnpm -r typecheck

Níveis de teste

• Testes unitários (packages/core/test/unit/) — mapeamento de códigos de erro, ramificações de ferramentas. Use mockHttp de test/harness.ts para simular node:https. Nenhuma rede necessária.
• Testes de integração (packages/core/test/integration/) — opcionais. Defina LEADBAY_TEST_TOKEN e execute pnpm test:smoke.
• Testes de auditoria (packages/mcp/test/audit/) — verificam descrições de ferramentas, blocos de roteamento e consistência do WORKFLOWS.md no momento da compilação. Sempre executados no CI.
• Avaliações de agente (evals/) — jornadas declarativas, agentes de teste isolados e verificação independente de evidências. pnpm test:eval valida contratos de artefatos; não afirma cobertura comportamental.

Veja CLAUDE.md para o guia completo de contribuidores: estrutura de ferramentas, convenções de teste, pipeline de compilação e como adicionar uma nova ferramenta.

Publicação

Todas as versões são orientadas por tags — nunca execute npm publish localmente. O GitHub Actions é responsável pela publicação.

1. Aumente a versão em packages/mcp/package.json#version + adicione uma entrada no CHANGELOG, faça o merge do PR.

git checkout main && git pull

git tag mcp-v0.x.0

git push origin mcp-v0.x.0

2. Acompanhe o fluxo de trabalho de versão: preflight-npm → publish-mcp.

Para execuções de teste: Actions → release → "Run workflow" → package: mcp, dry_run: true.

Runbook completo (configuração de autenticação, modos de falha, reexecuções manuais): RELEASE.md.