FindLeadEmails

FindLeadEmails MCP サーバー

AI アシスタントから、B2B の業務用メールアドレスを検索・検証できます。個別検索にも一括リストにも対応し、メールの到達可能性もチェックします。

このリポジトリには、ホスト型 FindLeadEmails MCP サーバーのセットアップドキュメントと設定が含まれています。インストールするコードはありません。サーバーはリモートです。

• URL： https://www.findleademails.com/api/mcp（Streamable HTTP）
• 認証： OAuth 2.1 に対応したクライアント（Claude、ChatGPT、Codex、VS Code、Cursor、Claude Code、Gemini CLI など）で OAuth 2.1 を使ってサインインします。ヘッダーを付けずに URL を追加し、ブラウザーで承認してください。または、Authorization: Bearer YOUR_API_KEY を送信します。ツールの一覧表示（initialize、tools/list）には、どちらも必要ありません。
• API キー（OAuth を使わない場合のみ）：サインインして https://www.findleademails.com/developers?utm_source=github で作成してください。キーは一度だけ表示されます。紛失した場合は、そこで再発行してください。絶対にコミットしないでください。

www ホストを使用してください。https://findleademails.com はリダイレクトされます。リダイレクト時に一部のクライアントは Authorization ヘッダーを削除します。

どちらのボタンでも、サーバー URL のみが追加されます。初めてツールを実行するときに、ブラウザーで OAuth サインインを承認してください。

ツール

ツール	機能	クレジット
find_email	first_name、last_name、company_domain（または LinkedIn の会社ページ URL）を使って、1 人分の業務用メールアドレスを検索・検証します。	メールボックスが検証済みの場合のみ 1
verify_email	すでにお持ちの email を 1 件確認します。	有効と確認された場合のみ 1
find_emails_bulk	1 回の同期呼び出しで複数件を検索・検証します（上限あり。上限を超えると batch_too_large を返します）。	検証済みの結果 1 件につき 1
create_job	大量のリストをバックグラウンド処理用にキューに登録し、ジョブ ID を返します。	1 行につき 1 を予約し、未使用分を返金
get_job_status	ジョブの進捗状況と、結果ごとのカウンターを返します。	無料
get_job_results	行ごとの結果を 1 ページ分返します（next_cursor が null になるまで cursor でページを取得してください）。処理中も利用できます。	無料

料金：見つからなかった場合、キャッチオール、予測結果、再検索は無料です。検証済みのメールアドレスに対してのみ料金が発生します。クレジットに有効期限はありません。https://www.findleademails.com/docs/mcp?utm_source=github#credits をご覧ください。

OAuth でサインイン

このサーバーは、PKCE（S256）、Client ID Metadata Documents、Dynamic Client Registration に対応した OAuth 2.1 をサポートしています。OAuth に対応したクライアントで、Authorization ヘッダーを付けずに URL を追加し、ブラウザーでアクセスを承認してください。API キーは不要です。

• Claude（claude.ai および Claude Desktop）：Settings → Connectors → Add custom connector を選択します。https://www.findleademails.com/api/mcp を貼り付け、「Sign in when needed」を選択し、「Use Claude's published identity」はそのままにします。

• ChatGPT および Codex： 上記の URL でサーバーを追加し、認証方法として OAuth を選択します。

• Claude Code：

  claude mcp add --transport http findleademails https://www.findleademails.com/api/mcp
  

  次に、Claude Code で /mcp を実行し、findleademails を選択して Authenticate を選びます。

• VS Code および Cursor： headers を付けずに URL のみを追加します（または上記のインストールボタンを使用します）。必要に応じて、クライアントがサインインページを開きます。

• Gemini CLI： 拡張機能をインストールした後、/mcp auth findleademails を実行します。

API キーを使いますか？以下のスニペットをご利用ください。

API キーを使ったセットアップ

すべてのスニペットで、YOUR_API_KEY をお持ちのキーに置き換えてください。

Cursor

OAuth を使用する場合は、上にある「Cursor に追加」ボタンを使用してください。API キーを使用する場合は、.cursor/mcp.json（プロジェクト用）または ~/.cursor/mcp.json（グローバル用）に手動で追加してください。同じファイルがこのリポジトリ内の .mcp.json にあります。

{
  "mcpServers": {
    "findleademails": {
      "url": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

キーをファイルに保存しないようにするには、"Bearer ${env:FINDLEADEMAILS_API_KEY}" を使用してください。

Claude Code

claude mcp add --transport http findleademails https://www.findleademails.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Claude Desktop には mcp-remote ブリッジ（Node.js 18+）が必要です。claude_desktop_config.json に次の内容を記述してください。

{
  "mcpServers": {
    "findleademails": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.findleademails.com/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

.vscode/mcp.json に記述します。VS Code がキーの入力を求め、安全に保存します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "findleademails-api-key",
      "description": "Paste your FindLeadEmails API key.",
      "password": true
    }
  ],
  "servers": {
    "findleademails": {
      "type": "http",
      "url": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:findleademails-api-key}"
      }
    }
  }
}

Windsurf

mcp_config.json（Cascade パネルのアクションメニューから開きます。macOS/Linux では ~/.config/devin/mcp_config.json、Windows では %APPDATA%\devin\mcp_config.json）：

{
  "mcpServers": {
    "findleademails": {
      "serverUrl": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cline

このリポジトリからこのサーバーをインストールするよう Cline に依頼してください（llms-install.md に従います）。または、cline_mcp_settings.json に追加してください。

{
  "mcpServers": {
    "findleademails": {
      "type": "streamableHttp",
      "url": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/findleademails/findleademails-mcp

CLI はインストール時に API キーの入力を求め、システムのキーチェーンに保存します。後から変更するには、gemini extensions config findleademails を実行してください。

Perplexity

Pro、Max、Enterprise：Connectors → カスタムリモートコネクターを追加し、ご利用のプランで提供されている認証オプションを選択してください。API キーを使用する場合：

URL: https://www.findleademails.com/api/mcp
Header: Authorization: Bearer YOUR_API_KEY

Grok

grok.com で、Connectors → New Connector → Custom の順に選択し、サーバー URL を入力して、認証を求められたら API キーを貼り付けてください。Business および Enterprise のワークスペースでは、まず管理者がカスタムコネクターを設定する必要があります。

Grok CLI：

grok mcp add --transport http findleademails https://www.findleademails.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

xAI API（キーは Bearer という語を付けずに authorization に指定します）：

{
  "type": "mcp",
  "server_url": "https://www.findleademails.com/api/mcp",
  "server_label": "findleademails",
  "authorization": "YOUR_API_KEY"
}

その他のクライアント

OAuth のみをサポートするクライアントでは、URL の指定だけで使用できます。リモート URL とヘッダーを指定できるクライアントでは、上記の Cursor 用 JSON を使用し、キー名をそのクライアントに合わせて変更してください。

試してみる

curl https://www.findleademails.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

キーまたは OAuth トークンなしでツールを呼び出すと、HTTP 401 invalid_token が返されます（OAuth クライアントをサインインに誘導する WWW-Authenticate ヘッダーが含まれます）。料金は発生しません。Accept: application/json, text/event-stream を指定しない POST は 406 を返します。

リンク

• ドキュメント：https://www.findleademails.com/docs/mcp?utm_source=github
• REST API ドキュメント：https://www.findleademails.com/docs?utm_source=github
• API キー：https://www.findleademails.com/developers?utm_source=github
• 料金：https://www.findleademails.com/pricing?utm_source=github
• お問い合わせ：[email protected]

ライセンス

MIT。LICENSE を参照してください。

— FindLeadEmails チーム