Montar listas sempre foi um exercício de ajustar filtros: empilhar menus, olhar a contagem, ajustar, exportar, descobrir que a lista não era o que você queria e repetir. Um agente de IA conectado à base de dados transforma esse ciclo numa conversa. Você descreve o público, o agente consulta os dados e refina até os números fazerem sentido, e só então você autoriza o resultado pago.
Este passo a passo usa o Claude e o Argorant pelo Model Context Protocol. Outros clientes MCP podem usar o mesmo endpoint remoto, mas a configuração do conector, a interface de aprovação, o comportamento da autenticação e as ferramentas disponíveis precisam ser testados separadamente.
A configuração de dois minutos
O Argorant oferece um servidor MCP remoto em https://mcp.argorant.com/mcp. Nas configurações de conectores do Claude (ou via `claude mcp add` no Claude Code), adicione essa URL como servidor remoto. A primeira chamada abre um fluxo OAuth no seu navegador: você entra na sua conta do Argorant, aprova a conexão e o agente recebe um token com escopo. Nenhuma chave de API colada em arquivos de configuração, e você pode revogar a conexão na sua conta a qualquer momento.
Depois de conectado, o Claude vê 15 ferramentas documentadas que cobrem inspeção da conta, busca de empresas e pessoas, contagens, pessoas por empresa, prévias mascaradas, revelação de contatos, enriquecimento, listas salvas, exportações e status de tarefas. O acesso via MCP está incluído nos planos pagos do Argorant; um saldo pré-pago separado para agentes permite compras de contatos com limite, sem assinatura recorrente.
A economia: olhar é grátis, levar é cobrado
O desenho das ferramentas separa a descoberta dos contatos pagos. Busca, contagem e prévia mascarada permitem ao Claude testar o formato do mercado antes de revelar ou exportar dados de contato. Essas ações de descoberta não consomem créditos de contatos pelas regras atuais do produto, embora os limites normais da conta e de requisições continuem valendo.
Os créditos só são gastos em revelações e exportações, quando dados de contato verificados realmente saem do sistema. E como o Argorant verifica ao vivo na exportação e cobra 0 créditos por resultados inválidos, a etapa cobrada só cobra pelos endereços que passam. Um agente não consegue queimar seu saldo explorando, nem com bounces.
Uma sessão real, de ponta a ponta
Veja como o ciclo funciona na prática. Você pede: "Encontre heads de operações em empresas de logística de médio porte na Alemanha e na Holanda." O Claude chama a ferramenta de contagem com a primeira interpretação do pedido (talvez 50 a 500 funcionários, um filtro de setor de transporte e logística, dois códigos de país) e informa algo como 4,800 pessoas compatíveis.
Depois vem a parte interessante: você questiona o resultado antes de pagar por ele. Pergunte como a contagem se divide por país e peça uma amostra mascarada de cargos. O Claude roda as chamadas de prévia, você percebe que o filtro de cargo está pegando líderes de turno de armazém, aperta o filtro e a contagem muda. Continue até os filtros interpretados e a amostra visível descreverem um segmento em que você realmente acredita.
Só então você diz "revele os 200 primeiros e exporte como CSV". É o primeiro momento em que créditos são gastos, numa lista que você já conferiu por três ângulos, com cada endereço verificado ao vivo na saída.
Uma dica prática para repetir o processo: quando a definição estiver ajustada, peça ao Claude para reescrever o conjunto final de filtros de forma explícita (setores, faixas de funcionários, países, padrões de cargo). Cole isso num arquivo de projeto ou num prompt de sistema, e a próxima sessão começa de uma base que já funciona, em vez de redescobrir o ICP do zero.
O prompt que mantém o Claude dentro dos limites
Peça ao Claude para trabalhar em etapas: primeiro, reescrever o ICP como filtros explícitos; segundo, rodar uma contagem; terceiro, mostrar uma prévia mascarada e explicar as divergências; quarto, esperar a aprovação; só então revelar ou exportar um número máximo fixo de contatos. Isso faz do limite de aprovação parte da tarefa, em vez de depender de o agente deduzi-lo.
Um prompt prático é: 'Traduza este ICP em filtros explícitos de empresa e pessoa. Mostre os filtros, conte os resultados e mostre uma prévia de cinco registros mascarados. Não revele, não enriqueça, não crie uma exportação paga nem envie para outro sistema até eu aprovar os filtros finais e um gasto máximo.' Depois da prévia, peça ao Claude para dizer a ação paga esperada, o limite de registros e o saldo atual antes de aprovar.
Para execuções repetíveis, salve o objeto de filtros aprovado e as regras de exclusão. Não salve uma instrução ampla como 'encontre bons compradores', porque um modelo futuro ou um vocabulário de dados alterado pode interpretá-la de outro jeito.
Teste os caminhos de falha antes de confiar no caminho feliz
Uma contagem que funciona não é uma prova de ponta a ponta. Teste uma consulta sem resultado, um filtro deliberadamente não suportado, uma conexão expirada ou revogada, saldo insuficiente, uma requisição com limite atingido e um pedido de exportação duplicado. O Claude deveria explicar o estado e parar, não ampliar o público em silêncio nem repetir uma ação paga sem limite.
Depois de uma exportação autorizada, compare o limite pedido, as linhas retornadas, a contagem de resultados válidos, os créditos cobrados e o status da tarefa. Resultados inválidos, catch-all, desconhecidos, excluídos e duplicados não deveriam ser achatados num único número de sucesso.
Por fim, desconecte o conector no Claude e revogue-o no Argorant. Confirme que o token antigo não consegue mais ler dados da conta. A revogação faz parte do teste de configuração, não é uma tarefa administrativa para depois.
Se você prefere ficar no terminal
O mesmo fluxo está disponível sem um agente no meio. A CLI do Argorant está publicada no npm (`npx argorant` roda sem instalação) e oferece busca, contagens, revelações e exportações como comandos que você pode automatizar. Ela se autentica na mesma conta e no mesmo saldo de créditos, então um cron job, uma etapa de CI ou uma extração rápida pelo shell saem todos do mesmo lugar.
A CLI também é a camada prática de depuração para workflows com agentes: quando você quer confirmar exatamente o que um filtro encontra antes de colocá-lo nas instruções de um agente, um único comando dá a resposta concreta.
Por que isso supera o ciclo dos painéis
O ganho estrutural é que iterar fica quase de graça, em tempo e em créditos. Numa ferramenta tradicional, cada refinamento custa um recarregamento de página e cada erro custa uma exportação. No ciclo com agente, refinar é uma frase, e os erros são pegos na etapa de prévia, antes de o dinheiro sair.
Isso também significa que a montagem de listas se combina com tudo o que o seu agente faz. O Claude pode puxar a lista, redigir a primeira mensagem citando o setor de cada empresa e entregar o arquivo ao seu sequenciador: uma única conversa, com 630.7M de contatos em 202 países por trás de um protocolo que o agente já fala. Conecte uma vez e pare de clicar em menus suspensos.
