Generect

Generect MCP サーバー

AI エージェント向けの B2B リードおよび企業データです。
検索とオーディエンス規模の算出は無料です。料金が発生するのは、保存するメールアドレス、電話番号、詳細プロフィールのみです。

概要

Claude、ChatGPT、Cursor、または独自のエージェントから Generect の B2B データベースにアクセスできます。ICP に基づく人物や企業、メールアドレス、電話番号、詳細プロフィールを利用できます。

• 調査は無料です。 オーディエンス数の算出は無料です。また、アカウントごとの日次行数上限までは、簡易データ（人物、役職、所在地、勤務先企業）を使ったデータベース検索も無料です。
• 保存するデータ分だけお支払いください。 メールアドレスは有効なものが見つかった場合のみ、電話番号は見つかった場合のみ、詳細プロフィールは見つかったレコードごとに課金されます。
• 予想外の請求はありません。 各ツールは料金が発生するかどうかを事前に示し、すべての応答には実際の請求額を記載した cost ブロックが含まれます。設定した支出上限を超える呼び出しには、明示的な確認が必要です。課金される可能性のあるツールは読み取り専用としてマークされないため、Claude などのホストは実行前に確認を求めます（信頼できるツールでは「常に許可」を選択してください）。件数の算出、残高確認、ヘルスチェックでは確認を求めません。
• 安心してお試しいただけます。 テストキーを使うと、現実的な架空データが実際と同じ速度で返され、料金は発生しません。
• チャット内で操作できます。 Claude、ChatGPT などの MCP Apps 対応ホストでは、操作可能なカード形式で結果が返されます。価格を表示するオーディエンスカード、人物を選んでメールアドレスを検索できるリードテーブル、企業カード、プロフィールカード、残高を利用できます。

接続

app.generect.com/settings/api で API キーを取得してください。OAuth に対応したクライアントでは、API キーなしでサインインできます。

リモートサーバー（推奨）

https://mcp.generect.com/mcp は OAuth 2.1 に対応したストリーミング可能な HTTP を使用するため、ほとんどのクライアントでは URL を設定するだけで接続できます。MCP プロトコルのリビジョン 2026-07-28（ステートレスで、server/discover によって検出）と、2025 年のリビジョン（2025-11-25、2025-06-18）を並行して提供するため、現在のクライアントであれば設定なしで接続できます。

Claude Code

claude mcp add --transport http generect https://mcp.generect.com/mcp

Claude.ai および Claude Desktop： 「設定」、「コネクタ」、「カスタムコネクタを追加」の順に選択し、https://mcp.generect.com/mcp を貼り付けます。

Cursor（.cursor/mcp.json）およびその他の JSON 設定対応クライアント：

{
  "mcpServers": {
    "generect": {
      "url": "https://mcp.generect.com/mcp"
    }
  }
}

初回接続時に、ブラウザーで Generect の同意ページが開きます。すでにサインインしているアカウントで承認すると、クライアント専用のトークンが発行されます。

クライアントが OAuth に対応していない場合： たとえば mcp-remote を使って、ヘッダーにキーを渡します。

{
  "mcpServers": {
    "generect": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.generect.com/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

ローカルサーバー（stdio）

{
  "mcpServers": {
    "generect": {
      "command": "npx",
      "args": ["-y", "generect-ultimate-mcp@latest"],
      "env": {
        "GENERECT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Node 20 以降が必要です。オプションとして、GENERECT_API_BASE（デフォルトは https://api.generect.com）と GENERECT_TIMEOUT_MS を設定できます。macOS の Claude Desktop で spawn npx ENOENT が表示される場合は、command に npx の絶対パスを設定してください。

テストモード

上記いずれかの設定で、app.generect.com/settings/api の test_… キーを使用してください。すべてのツールが架空のデータを返し、実際の呼び出しで発生する料金を表示しますが、課金はされません。結果には test_mode: true が含まれるため、エージェントが実在の人物と誤認することはありません。詳しくはテストモードをご覧ください。

インタラクティブな結果（MCP Apps）

MCP Apps 拡張機能に対応しているホスト（ウェブ、デスクトップ、モバイルの Claude、ChatGPT、VS Code、Goose など）では、これらのツールが会話内にインタラクティブなビューとして表示されます。それ以外のクライアントでは、従来どおり同じテキストと構造化された結果が表示されます。

ツール	表示内容
count_leads, count_companies	対象の人数、設定したフィルター、現在の料金で次のステップにかかる費用、最初の25件を表示するボタン
search_leads, preview_leads	上位の人物をインライン表示します。全員をテーブルとして開き、絞り込み、選択して、その場で仕事用メールアドレスを検索できます。費用が発生する前に上限を確認し、見つからなかった場合は無料です。見つかったメールアドレスは Claude に返され、利用できるようになります
search_companies	企業カードとテーブルを表示します。ワンクリックで、それらの企業の意思決定者を検索できます
enrich_lead, get_lead_by_url, enrich_company	職歴のタイムラインとメールアドレス検索ボタンを備えたプロフィールカード
get_balance	残高、今月の利用額、操作ごとの料金
generate_email	見つかったメールアドレスとその費用

ビューはホストのテーマ（ライトとダーク）、フォント、レイアウトに従い、スマートフォンでも動作します。テストキーを使った結果には、架空のデータであることが表示されます。

ツール

無料

ツール	機能
count_leads	ICP に一致する人物の数と、設定した料金で次のステップにかかる費用を確認できます。ここから始めてください。
count_companies	企業について同じ情報を確認できます。
search_leads	ICP に一致する人物を検索します。デフォルトの簡易行では無料です（データベースモード、1日あたりの上限あり）。
search_companies	ICP に一致する企業を検索します。デフォルトの簡易行では無料です（データベースモード、1日あたりの上限あり）。
get_balance	残高、実際の操作ごとの料金、任意で操作別またはトークン別の利用額を確認できます。
get_bulk_job	一括処理ジョブの状態を確認します（処理料金は送信時に請求されます）。
list_webhooks, create_webhook, update_webhook, delete_webhook, test_webhook	一括処理ジョブの完了イベントを受信する Webhook エンドポイントを管理します。
health	無料エンドポイントに対して、稼働状態と認証情報を確認します。監視用途に安全に使えます。

有料

ツール	課金対象
search_leads, search_companies（detail: "full"、リアルタイムモード、無料枠を使い切った後）	返された行ごと
preview_leads	返された行ごと（count_only: true は無料）
resolve_profile	解決されたプロフィールごと。最も安価な有料呼び出しです。解決できないリンクは無料です
enrich_lead, get_lead_by_url	見つかったレコードごと
enrich_company	見つかったレコードごと
generate_email	見つかった有効なメールアドレスごと
validate_email	判定結果にかかわらず、送信されたメールアドレスごと
find_phone	見つかった電話番号ごと。最も高額な操作です
start_bulk_job	レコードごと。ジョブの送信時に確保されます

料金はアカウントのティアによって異なります。get_balance でご自身の料金を確認でき、すべての応答に実際の請求額が記載されます。

予算を守るフロー

count_leads (free)  →  search_leads, thin rows (free)  →  generate_email on the ids you keep (per valid email)
                                                        →  enrich_lead / find_phone only where needed

簡易行と全項目の行

search_leads と search_companies では detail を指定できます。

• 省略時（デフォルト）：無料枠が利用可能な間は簡易行を返します。無料枠が利用できなくなると（上限を使い切った場合、またはカスタム契約アカウントの場合）、検索は全項目の行に切り替わり、行ごとに課金されることが thin_unavailable で示されます。
• "thin"：無料の行のみを返します。課金やリアルタイムへの切り替えは行われず、上限を使い切ると 429 が返されます。
• "full"：レコード全体を返し、行ごとに課金されます。

簡易なリード行には、ID、名前、役職、職位レベル、所在地、企業（名前、ID、業界、国）が含まれます。簡易な企業行には、ID、名前、業界、従業員数の範囲、本社の都市と国、企業の種類、設立年が含まれます。どちらにも LinkedIn URL、ドメイン、連絡先、履歴は含まれません。generate_email はリード ID を直接受け取り、enrich_lead / enrich_company は全項目のレコードを返します。

データベースとリアルタイム検索

検索とエンリッチメントは、Generect データベース（1 秒未満で処理され、件数は無料）または LinkedIn のリアルタイム検索（5～60 秒で処理され、件数は有料、すべてのフィルターに対応）に対して実行されます。ツールでは mode を指定します。

• auto（デフォルト）は最初にデータベースを試し、指定したフィルターがデータベースでサポートされていないと API が返した場合にのみ、リアルタイム検索に切り替えます。切り替えは報告され、支出上限を超える場合は拒否されます。
• database はリアルタイム検索に切り替えません。サポートされていないフィルターは、追加料金ではなくエラーになります。
• realtime は直接リアルタイム検索を実行します。リアルタイムの件数取得には料金がかかるため、count_* は明示的に要求された場合にのみ実行します。

フィルターの値

company_industries と seniorities は未知の値を黙って受け入れ、結果を 0 件として返します。そのため、「この対象者は存在しない」と受け取られてしまいます。そこでサーバーは、値を送信する前に検証します。未知の業種、従業員数の区分、企業タイプは、最も近い有効な値を示してローカルで拒否され、大文字・小文字の誤りは修正されます。allow_unlisted_values: true を指定すると、この検証を無効にできます。

使用可能な値の一覧は、リソースとして公開されています。

generect://vocabulary/industries
generect://vocabulary/seniorities
generect://vocabulary/functions         (realtime only)
generect://vocabulary/company-types
generect://vocabulary/headcounts
generect://vocabulary/follower-ranges   (realtime only)
generect://account/pricing              your per-operation prices
generect://account/balance              balance and month-to-date usage

プロンプト

ワークフローのプロンプトは、対応するクライアントでスラッシュコマンドとして表示されます。size_an_audience、build_prospect_list、enrich_my_list、spend_report の各プロンプトは、無料の手順から開始します。

支出上限

行数の上限で制限されるのは結果であり、支出額ではありません。最悪の場合に MCP_MAX_SPEND_PER_CALL（デフォルトは $5）を超える呼び出しは、正確な金額を示して拒否されます。その金額以上の confirm_spend_usd を設定して、再度実行する必要があります。start_bulk_job は送信前に検証されます。これは、バルクジョブの費用全額が開始時に確保されるためです。

エージェントスキル

ツールを使うと、エージェントは Generect を呼び出せます。スキルでは、上記の手順を説明します。

npx skills add generect/generect_mcp --skill generect-lead-workflows

skills/README.md を参照してください。

詳細

• ドキュメント
• サーバーの運用とセルフホスト：ログ記録、OAuth エンドポイント、セキュリティ設定、デプロイ、Docker
• リリースプロセス
• 問題の報告

ライセンス

MIT