리스트 구축은 늘 필터를 만지작거리는 작업이었어요: 드롭다운을 쌓고, 집계를 보고, 조정하고, 내보내고, 원하던 리스트가 아니었다는 걸 알고, 다시 반복하죠. 데이터베이스에 연결된 AI 에이전트는 그 루프를 대화로 바꿔요. 타깃을 설명하면 에이전트가 데이터를 조회하고 숫자가 말이 될 때까지 다듬고, 그다음에야 유료 결과를 승인해요.
이 안내는 Model Context Protocol로 Claude와 Argorant를 써요. 다른 MCP 클라이언트도 같은 원격 엔드포인트를 쓸 수 있지만, 커넥터 설정, 승인 UI, 인증 동작, 사용 가능한 도구는 따로 테스트해야 해요.
2분 설정
Argorant의 원격 MCP 서버 주소는 다음과 같아요: https://mcp.argorant.com/mcp. Claude 커넥터 설정에서(또는 Claude Code에서 `claude mcp add` 로) 이 URL을 원격 서버로 추가하세요. 첫 호출 때 브라우저에서 OAuth 절차가 시작돼요: Argorant 계정에 로그인하고 연결을 승인하면 에이전트가 범위가 정해진 토큰을 받아요. 설정 파일에 API 키를 붙여 넣을 필요가 없고, 언제든 계정에서 연결을 철회할 수 있어요.
연결되면 Claude는 계정 확인, 기업 및 인물 검색, 집계, 기업 인물, 가려진 미리보기, 연락처 공개, 보강, 저장된 리스트, 내보내기, 작업 상태를 다루는 문서화된 도구 15개를 볼 수 있어요. MCP 접근은 Argorant 유료 플랜에 포함되고, 별도의 선불 에이전트 잔액으로 반복 구독 없이 한도가 정해진 연락처 구매를 할 수 있어요.
경제성: 보는 건 무료, 가져가는 건 사용량 과금
도구 설계는 탐색과 유료 연락처 결과를 분리해요. 검색, 집계, 가려진 미리보기로 Claude는 연락처 데이터를 공개하거나 내보내기 전에 시장의 형태를 테스트할 수 있어요. 현재 제품 규칙에서는 이런 탐색 작업이 연락처 결과 크레딧을 쓰지 않지만, 일반 계정 한도와 속도 제한은 적용돼요.
크레딧은 검증된 연락처 데이터가 실제로 시스템 밖으로 나가는 공개와 내보내기에만 쓰여요. 그리고 Argorant는 내보낼 때 실시간 SMTP로 검증하고 무효 결과에는 0크레딧을 청구하므로, 과금 단계는 통과한 주소에만 비용을 매겨요. 에이전트가 탐색에 잔액을 날릴 수 없고, 반송에 날릴 수도 없어요.
처음부터 끝까지 실제 세션
실제로 이 루프는 이렇게 돌아가요. “독일과 네덜란드의 중견 물류 기업 운영 총괄을 찾아 줘.”라고 요청하면, Claude가 그 요청을 처음 해석한 기준(예: 직원 50~500명, 운송·물류 업종 필터, 국가 코드 두 개)으로 집계 도구를 호출하고, 일치하는 사람이 4,800명쯤이라고 알려 줘요.
그다음이 재미있는 부분이에요: 돈을 내기 전에 결과를 따져 보는 거예요. 집계가 국가별로 어떻게 나뉘는지 묻고 가려진 직함 샘플을 요청하세요. Claude가 미리보기 호출을 실행하고, 직함 필터가 창고 교대조 리더까지 잡고 있다는 걸 발견하면 조이고, 집계가 바뀌어요. 해석된 필터와 보이는 샘플이 실제로 믿을 수 있는 세그먼트를 설명할 때까지 계속하세요.
그다음에야 “상위 200명을 공개하고 CSV로 내보내 줘.”라고 말해요. 크레딧이 처음 쓰이는 순간이 바로 이때예요. 이미 세 가지 각도로 살펴본 리스트에, 모든 주소가 나가는 길에 SMTP 검증을 거친 상태로요.
반복해서 쓰기 위한 실전 팁 하나. 정의가 자리를 잡으면 Claude에게 최종 필터 세트(업종, 직원 수 구간, 국가, 직함 패턴)를 명시적으로 다시 정리해 달라고 하세요. 그걸 프로젝트 파일이나 시스템 프롬프트에 붙여 넣으면, 다음 세션은 ICP를 처음부터 다시 도출하지 않고 이미 확인한 기준점에서 시작해요.
Claude를 안전장치 안에 두는 프롬프트
Claude에게 단계별로 일하라고 하세요: 먼저 ICP를 명시적 필터로 다시 정리하고, 둘째로 집계를 돌리고, 셋째로 가려진 미리보기를 보여 주며 불일치를 설명하고, 넷째로 승인을 기다린 뒤에야 정해진 최대 수의 연락처를 공개하거나 내보내게 하세요. 그러면 에이전트가 승인 경계를 추론하길 기대하는 대신 작업 자체의 일부가 돼요.
실전 프롬프트 예시: '이 ICP를 명시적인 기업 및 인물 필터로 바꿔 줘. 필터를 보여 주고, 일치 수를 세고, 가려진 레코드 5개를 미리 보여 줘. 최종 필터와 최대 지출을 내가 승인하기 전에는 공개, 보강, 유료 내보내기, 다른 시스템으로 전송을 하지 마.' 미리보기 후에는 승인하기 전에 Claude에게 예상 유료 작업, 레코드 한도, 현재 잔액을 말해 달라고 하세요.
반복 실행을 위해 승인된 필터 객체와 제외 규칙을 저장하세요. '좋은 구매자 찾기' 같은 넓은 지시는 저장하지 마세요. 앞으로의 모델이나 바뀐 데이터 용어가 다르게 해석할 수 있어요.
정상 경로를 믿기 전에 실패 경로를 테스트하세요
작동하는 집계가 처음부터 끝까지의 증명은 아니에요. 결과 없는 쿼리, 일부러 지원하지 않는 필터, 만료되거나 취소된 연결, 잔액 부족, 속도 제한에 걸린 요청, 중복 내보내기 요청을 시험해 보세요. Claude는 몰래 타깃을 넓히거나 제한 없이 유료 작업을 재시도하지 말고, 상태를 설명하고 멈춰야 해요.
승인된 내보내기 후에는 요청 한도, 돌려받은 행, 유효 결과 수, 청구된 크레딧, 작업 상태를 비교하세요. 무효, 캐치올, 알 수 없음, 발송 제외, 중복 결과를 성공 숫자 하나로 뭉뚱그리면 안 돼요.
마지막으로 Claude에서 커넥터 연결을 해제하고 Argorant에서 철회하세요. 이전 토큰으로 더는 계정 데이터를 읽을 수 없는지 확인하세요. 철회는 나중에 하는 관리 작업이 아니라 설정 테스트의 일부예요.
터미널에 머물고 싶다면
중간에 에이전트 없이도 같은 워크플로를 쓸 수 있어요. Argorant CLI는 npm에 공개돼 있어서(`npx argorant` 로 설치 없이 실행) 검색, 집계, 공개, 내보내기를 스크립트로 쓸 수 있는 명령으로 제공해요. 같은 계정과 같은 크레딧 잔액으로 인증하므로, cron 작업, CI 단계, 셸에서의 간단한 일회성 추출이 모두 한곳에서 차감돼요.
CLI는 에이전트 워크플로의 실용적인 디버깅 레이어이기도 해요: 필터를 에이전트 지시에 넣기 전에 정확히 무엇과 일치하는지 확인하고 싶을 때, 명령 하나로 기준 답을 얻을 수 있어요.
대시보드 루프보다 나은 이유
구조적인 이점은 반복이 시간과 크레딧 모두에서 거의 공짜가 된다는 거예요. 기존 도구에서는 다듬을 때마다 페이지를 다시 불러오고 실수할 때마다 내보내기 비용이 들어요. 에이전트 루프에서는 다듬기가 문장 하나이고, 실수는 돈이 움직이기 전 미리보기 단계에서 잡혀요.
리스트 구축이 에이전트가 하는 다른 모든 일과 자연스럽게 이어진다는 뜻이기도 해요. Claude가 리스트를 가져오고, 각 기업의 업종을 언급하는 첫 메일 초안을 쓰고, 파일을 시퀀서에 넘길 수 있어요. 에이전트가 이미 쓰는 프로토콜 뒤에 202개국 연락처 630.7M개가 있으니 대화 하나로 끝나요. 한 번 연결하고, 드롭다운 클릭은 그만하세요.
