リスト作成はこれまで、フィルターをいじる作業の繰り返しでした。プルダウンを重ね、件数を確認し、調整してエクスポートし、意図したリストではなかったと気づいてやり直す。データベースに接続したAIエージェントは、このループを会話に変えます。ターゲットを説明すれば、エージェントがデータを調べ、数字が納得できるまで絞り込みます。有料の出力を承認するのは、その後です。
このウォークスルーでは、Model Context Protocolを介してClaudeとArgorantを使います。ほかのMCPクライアントでも同じリモートエンドポイントを使える場合がありますが、コネクタの設定、承認の画面、認証の挙動、使えるツールは個別にテストする必要があります。
2分でできるセットアップ
Argorantは次のURLでリモートMCPサーバーを公開しています：https://mcp.argorant.com/mcp. Claudeのコネクタ設定で（Claude Codeなら `claude mcp add` で）、このURLをリモートサーバーとして追加します。最初の呼び出しでブラウザにOAuthの画面が開きます。Argorantのアカウントにログインして接続を承認すると、エージェントは範囲が限定されたトークンを受け取ります。設定ファイルにAPIキーを貼り付ける必要はなく、接続はいつでもアカウントから取り消せます。
接続すると、Claudeはドキュメント化された15個のツールを使えるようになります。アカウントの確認、企業と人物の検索、件数確認、企業ごとの人物、伏せ字のプレビュー、連絡先の表示、データ補完、保存済みリスト、エクスポート、ジョブのステータスに対応します。MCPアクセスはArgorantの有料プランに含まれます。別途、前払いのエージェント用ウォレットを使えば、継続的なサブスクリプションなしで上限付きのコンタクト購入ができます。
コスト構造：見るのは無料、取得した分だけ課金
ツールは、探索と有料のコンタクト取得を分けて設計されています。検索、件数確認、伏せ字のプレビューで、Claudeは連絡先データを表示またはエクスポートする前に市場の形を確かめられます。現在の製品ルールでは、これらの探索の操作でコンタクト取得用のクレジットは消費されません。ただし、通常のアカウントの制限とレート制限は適用されます。
クレジットを使うのは、連絡先の表示とエクスポート、つまり確認済みのコンタクトデータが実際にシステムの外に出るときだけです。さらにArgorantはエクスポート時にリアルタイムでメールアドレスをチェックし、無効な結果は0クレジットなので、課金されるステップでも請求されるのはチェックに合格したアドレスの分だけです。エージェントが探索で残高を使い切ることも、バウンスで使い切ることもありません。
実際のセッションを最初から最後まで
実際のループは次のように進みます。「ドイツとオランダの中堅物流企業で、オペレーションの責任者を探して」と頼むと、Claudeはその依頼を最初に解釈した条件（たとえば従業員50〜500人、運輸・物流の業界フィルター、2つの国コード）で件数確認のツールを呼び出し、「一致する人物は4,800人です」といった結果を返します。
ここからが面白いところです。支払う前に、結果を掘り下げて確かめられます。件数が国別にどう分かれるかを尋ね、伏せ字の役職のサンプルを求めます。Claudeがプレビューを実行し、役職のフィルターが倉庫のシフトリーダーまで拾っていることに気づいたら、条件を絞り、件数が変わります。解釈されたフィルターと表示されたサンプルが、本当に納得できるセグメントを表すまで続けましょう。
そこで初めて「上位200人を表示して、CSVでエクスポートして」と頼みます。クレジットが使われるのはこのときが最初です。すでに3つの角度から確認したリストに対してであり、すべてのアドレスはエクスポートの際にチェックされます。
再現性を高める実践的なコツ：定義が固まったら、最終的なフィルターの組み合わせ（業界、従業員数の規模帯、国、役職のパターン）をClaudeに明示的に書き出してもらいましょう。それをプロジェクトのファイルやシステムプロンプトに貼り付けておけば、次のセッションはICPを一から導き直すのではなく、確かな基準から始められます。
Claudeをガードレールの内側にとどめるプロンプト
Claudeには段階を踏んで作業するよう指示しましょう。1つ目に、ICPを明確なフィルターとして言い直す。2つ目に、件数を数える。3つ目に、伏せ字のプレビューを表示し、条件に合わない点を説明する。4つ目に、承認を待つ。そのあとで初めて、決まった上限数までのコンタクトを表示またはエクスポートする。こうすれば、承認の境界をエージェントの推測に頼らず、タスクの一部として組み込めます。
実用的なプロンプトの例：「このICPを、企業と人物の明示的なフィルターに変換してください。フィルターを示し、一致する件数を数え、伏せ字のレコードを5件プレビューしてください。最終的なフィルターと支出の上限を私が承認するまで、表示、データ補完、有料のエクスポート、他システムへの送信は行わないでください。」プレビューの後、承認する前に、予定している有料の操作、レコードの上限、現在の残高をClaudeに示してもらいましょう。
繰り返し実行する場合は、承認済みのフィルターオブジェクトと除外ルールを保存してください。「良い購買担当者を探して」のような大まかな指示は保存しないでください。将来のモデルや、変更されたデータの用語によって、違う意味に解釈される可能性があります。
うまくいくケースを信じる前に、失敗するケースをテストする
件数が出ても、全体が動く証明にはなりません。結果ゼロの検索、意図的に未対応にしたフィルター、期限切れまたは取り消された接続、残高不足、レート制限されたリクエスト、重複したエクスポートのリクエストを試してください。Claudeは状況を説明して止まるべきで、黙って対象を広げたり、上限なしで有料の操作を再試行したりしてはいけません。
許可されたエクスポートの後は、リクエストした上限、返された行数、有効な成果の件数、課金されたクレジット、ジョブのステータスを比べてください。無効、キャッチオール、不明、除外、重複の結果を、1つの成功件数にまとめてはいけません。
最後に、Claudeでコネクタの接続を解除し、Argorantで取り消してください。古いトークンでアカウントのデータを読めなくなったことを確認します。取り消しはセットアップのテストの一部であり、後回しにする管理作業ではありません。
ターミナルで作業したい場合
同じワークフローは、間にエージェントを置かなくても使えます。ArgorantのCLIはnpmで公開されており（`npx argorant` でインストール不要で実行できます）、検索、件数確認、表示、エクスポートをスクリプトに組み込めるコマンドとして提供しています。同じアカウントと同じクレジット残高で認証されるため、cronジョブでも、CIのステップでも、シェルからの一度きりの取得でも、すべて1か所から利用されます。
CLIは、エージェントのワークフローの実用的なデバッグ手段でもあります。フィルターをエージェントの指示に組み込む前に、それが何に一致するかを正確に確かめたいとき、コマンド1つで事実を確認できます。
ダッシュボードを行き来するより優れている理由
構造的な利点は、試行錯誤が時間的にもクレジット的にもほぼ無料になることです。従来のツールでは、条件を見直すたびにページを再読み込みし、ミスをするたびにエクスポートが無駄になります。エージェントのループなら、見直しは一文で済み、ミスはお金が動く前のプレビューの段階で見つかります。
リスト作成が、エージェントが行うほかのすべての作業と組み合わせられるということでもあります。Claudeはリストを取得し、各企業の業界に触れた最初のメールの文面を下書きし、そのファイルをシーケンサーに渡せます。1つの会話の中で、しかも202か国、630.7M件のコンタクトが、エージェントがすでに使いこなしているプロトコルの向こう側にあるのです。一度接続すれば、もうプルダウンをクリックする必要はありません。
