Cold Leads

Cold Leads MCP サーバー

B2B アウトリーチ CRM の Cold Leads 用の Model Context Protocol サーバーです。ホストされたワークスペースのツールを、ローカルの MCP クライアント（Claude Desktop、Claude Code、Cursor、Windsurf、VS Code）に公開します。連絡先、インポート、同期済みの会話、テンプレート、キャンペーン、ウェブサイトからの情報取得、リード検索、検証を利用できます。API キーがなくても、サブスクリプションの承認をワークスペースの所有者に求めることができます。

npx -y @coldleads/mcp-server

キーなしで試す

ホスト型のデモサーバーでは、サンプルのワークスペース（.example ドメインを使った架空の連絡先）で同じツールを利用できます。メールは送信されず、クレジットも消費しません。

claude mcp add --transport http coldleads-demo https://coldleads.app/api/mcp/demo

次に、次のように依頼します：「この3件の連絡先を検証し、アウトリーチの下書きを作成してください。承認するまで何も送信しないでください。Jana Dvořák [email protected]、[email protected]、Piotr Kowalski [email protected]」。リモート（Streamable HTTP）MCP サーバーに対応するクライアントであれば、同じ URL を使用できます。このサーバーを基盤に構築されたエージェントの例：cold-leads-ai-sales-agent。

デモの制限：

制限	値
セッション	開始から24時間（延長不可）。そのセッションからのみ表示できます
連絡先	10件（サンプルの4件を含む）
テンプレート	独自のテンプレート1件（サンプルのテンプレートは別途利用可能。template_id で更新できます）
キャンペーンの下書き	1件
テキストの長さ	メモは100文字、テンプレート本文は500文字、メッセージは200文字
リクエスト	IP アドレスごとに1分あたり120件、新規セッションは1時間あたり20件
検証	デモの見込み客3件にはサンプルの結果を使用します。それ以外のアドレスでは、構文、使い捨てドメイン、役割のチェックのみを行います（MX やメールボックスのチェックはありません）
送信	常に送信されません。send_contact_message と launch_campaign は引き続き承認が必要で、その後 demo_not_sent を返します

ツール

ツール	機能	費用
verify_email	1 件のアドレスを検証します。構文、使い捨てドメイン、ロールアカウント、MX レコードに加え、Cold Leads が受信者のメールサーバーへの SMTP 接続を確立できる場合は、SMTP メールボックスとキャッチオールを確認します（接続できない場合は、reasons に smtp_unreachable が含まれ、catch_all は null になります）。valid、risky、invalid を返します。通常は数秒以内に応答します（クライアントは 8 秒後にタイムアウトします）。	1 クレジット
search_leads	Cold Leads の CRM に登録済みの連絡先を、会社のドメインと任意の役職キーワードで検索します。メールアドレス、氏名、会社、ステージ、タグ、検証状況、do_not_contact フラグを返します。Cold Leads はサードパーティのリードデータベースを保有していません。	無料
list_contacts、import_contacts、update_contact	連絡先の一覧表示、1 回の呼び出しにつき解析済みの連絡先行を最大 100 件までインポート、ワークスペース内の連絡先の更新を行います。インポート時は重複を除外し、グローバル DNC エントリをスキップします。メールは送信しません。CSV/XLSX の解析はアシスタントが行います。	無料
get_conversation、send_contact_message	メールボックスと同期された連絡先との会話を読み取るか、受信者と内容の明示的な承認を得た後にメールを 1 通送信します。配信停止、バウンス、DNC はブロックされます。	送信者／プロバイダーの制限による
list_templates、save_template	ワークスペースのテンプレートを確認、作成、更新します。内容の審査が適用されます。	無料
list_campaigns、create_campaign_draft、launch_campaign	キャンペーンの確認、下書きと対象者数の見積もりの作成を行い、人による確認と明示的な承認を得た後にのみ開始します。	プランと受信者数の制限による
get_lead_context、get_sales_next_actions、schedule_follow_up、get_agent_activity	1 件のリードに関して把握しているすべての情報（連絡可否、履歴、直近の返信分類、次のアクション）、返信待ちのキューと期限が来たフォローアップ、連絡先の次のアクションの設定（メールは送信しません）、API および MCP 呼び出しの監査ログを取得します。	無料
get_workspace_info、setup_website_lead_capture	機密情報を含まないワークスペース／メールボックスの状態を読み取るか、ウェブサイト向けの公開専用フォームキー／スニペットを生成します。ウェブサイトからの送信は問い合わせリードであり、コールドアウトリーチへの同意が自動的に得られたことにはなりません。	無料
provision_account_and_get_payment_link	キーを持たないエージェント向けに、人間の所有者の仮アカウントを作成し、Business プランの Stripe 決済リンクを返します。決定と支払いは人間が行います。	—
check_provisioning_status	所有者による支払い後、API キーを 1 回だけ（claim_token とともに）返します。サーバーは直ちにそのキーを使用し始めます。	—

応答はテキストブロック内の簡潔な JSON です。メールボックスを確認できなかったアドレスの結果例（example.com はドキュメント用に予約されています）：

{"status":"success","email":"[email protected]","validity":"valid","catch_all":null,"score":75,"reasons":["smtp_unreachable"],"disposable":false,"role_account":false}

エラーは isError: true を含むツールの結果として返されます。例：{"status":"error","error":"rate_limited","message":"…","http_status":429,"retry_after_seconds":60}。

要件

• Settings → API keys から取得した Cold Leads のシークレット API キー（sk_…）。API は Business プランに含まれます（月 10,000 件分の検証および API クレジット。追加パックも利用可能）。
• Node.js 20 以降（CI テスト対象は 20 および 22）。
• まだキーをお持ちでない場合は、キーなしでサーバーを起動し、エージェントから provision_account_and_get_payment_link を呼び出してください。エージェントのオンボーディングをご覧ください。

セットアップ

Claude Desktop

claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "coldleads": {
      "command": "npx",
      "args": ["-y", "@coldleads/mcp-server"],
      "env": { "COLDLEADS_API_KEY": "sk_your_secret_key" }
    }
  }
}

Cursor / Windsurf

~/.cursor/mcp.json（Cursor）または ~/.codeium/windsurf/mcp_config.json（Windsurf）に、上記と同じ mcpServers ブロックを記述します。

Claude Code

claude mcp add coldleads --env COLDLEADS_API_KEY=sk_your_secret_key -- npx -y @coldleads/mcp-server

VS Code

.vscode/mcp.json：

{
  "servers": {
    "coldleads": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@coldleads/mcp-server"],
      "env": { "COLDLEADS_API_KEY": "sk_your_secret_key" }
    }
  }
}

ホスト型エンドポイント（インストール不要）

リモートサーバーに対応するクライアントは、シークレットキーを使って直接接続できます。

{
  "mcpServers": {
    "coldleads": {
      "url": "https://coldleads.app/api/mcp",
      "headers": { "Authorization": "Bearer sk_your_secret_key" }
    }
  }
}

stdio サーバーは https://coldleads.app/api/mcp からワークスペースのツールを検出し、呼び出しをホスト型 MCP サービスに転送します。そのため、ホスト型ツールとローカルツールでは、同じアカウント、ポリシー、送信時の安全対策が適用されます。また、キー不要のオンボーディングツールも含まれています。ChatGPT は OAuth 2.1 を使用してホスト型エンドポイントに接続します。ChatGPT で Developer mode を有効にしてエンドポイントを追加し、Cold Leads にサインインして、要求されたアクセスを確認してください。その他のリモート MCP クライアントでは、上記の API キーヘッダーを使用できます。

Docker

docker build -t coldleads-mcp-server .
docker run -i --rm -e COLDLEADS_API_KEY=sk_your_secret_key coldleads-mcp-server

設定

変数	デフォルト	用途
COLDLEADS_API_KEY	—	シークレット API キー（sk_…）。起動時の指定は任意です。キーがなくてもサーバーは起動し、ツールを一覧表示でき、エージェントのオンボーディングを実行できます。
COLDLEADS_API_BASE	https://coldleads.app	API のベース URL（Cold Leads の開発サーバーに対するローカル開発用）。

キーなしでのエージェントのオンボーディング

1. エージェントは、所有者のメールアドレスを使って provision_account_and_get_payment_link を呼び出します。
2. 返された checkout_url を人間に提示します。人間は安全な Stripe ページでプランと価格を確認し、支払うかどうかを決定します。API にはエージェントが支払いを行う方法はなく、エージェントにはリンクを開いたり、支払ったりしないよう指示されます。
3. エージェントは session_id と claim_token を使って、15～30 秒ごとに check_provisioning_status をポーリングします。
4. 支払い後、最初の呼び出しで api_key が一度だけ返され、このサーバーは直ちにそのキーに切り替わります。次回の起動に備えて、COLDLEADS_API_KEY として保存してください。
5. 所有者には Cold Leads のウェブアプリを開くためのメールが届き、そこでサブスクリプションの管理やキーのローテーションができます。

claim_token を含むリクエストだけがキーを取得できます。これを含まないステータス照会でキーが返されることはありません。

責任ある利用

• アドレスが認証済みであることは、同意を意味しません。各人に連絡するための適法な根拠が必要です。
• do_not_contact: true のリード（配信停止済み、バウンス済み、または連絡禁止リストに登録済み）には、決してメールを送信しないでください。
• 制限：キーあたり毎分 120 リクエスト。各認証には 1 クレジットかかります。

開発

npm ci
npm run build
npm test                      # schema, server and stdio child-process tests
COLDLEADS_API_KEY_FILE=path/to/key COLDLEADS_API_BASE=http://localhost:3000 node scripts/smoke.mjs   # live checks

ライセンス

MIT © 2026 Anton Tkachenko