Generect

Generect MCP 服务

为 AI Agent 提供 B2B 潜在客户和公司数据。
搜索和受众规模估算免费。您只需为保留的邮箱、电话和完整档案付费。

功能

让 Claude、ChatGPT、Cursor 或您自己的 Agent 访问 Generect B2B 数据库：根据 ICP 查找人员和公司，以及邮箱、电话和完整档案。

• 免费探索。 统计受众规模免费，搜索数据库并获取精简行数据（人员、职位、地点、所属公司）也免费，每个账号每天有行数配额。
• 只为保留的内容付费。 仅在找到有效邮箱时才收取邮箱费用，仅在找到电话时才收取电话费用，按找到的记录收取完整档案费用。
• 费用清晰透明。 每个工具都会提前说明是否收费，每次响应都包含一个 cost 区块，显示实际收取的金额；超过支出上限的调用需要明确确认。可能产生费用的工具不会标记为只读，因此 Claude 和其他宿主在运行这些工具前会先询问（对您信任的工具选择“始终允许”）；统计、余额和运行状况检查则无需询问。
• 可放心试用。 测试密钥会以真实速度返回逼真的虚构数据，且不收取任何费用。
• 在聊天中交互。 在 Claude、ChatGPT 和其他支持 MCP Apps 的宿主中，结果会以可交互的卡片形式返回：显示价格的受众卡片、可选择人员并查找其邮箱的潜在客户表格、公司和档案卡片，以及您的余额。

连接

在 app.generect.com/settings/api 获取 API 密钥。支持 OAuth 的客户端无需密钥即可登录。

远程服务（推荐）

https://mcp.generect.com/mcp 使用可流式 HTTP 和 OAuth 2.1，因此大多数客户端只需配置 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：**依次选择 Settings、Connectors、Add custom connector，然后粘贴 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，以免 Agent 将这些虚构人物误认为真实人物。请参阅测试模式。

交互式结果（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	查看符合 ICP 的公司数量。
search_leads	搜索符合 ICP 的人选。使用默认的精简行时免费（数据库模式，每日配额）。
search_companies	搜索符合 ICP 的公司。使用默认的精简行时免费（数据库模式，每日配额）。
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 数据库运行（亚秒级，免费计数），也可实时查询 LinkedIn（耗时 5 到 60 秒，计数收费，支持所有筛选条件）。工具接受 mode：

• auto（默认）先尝试数据库，只有 API 表示传入的筛选条件不受支持时才会升级到实时查询。系统会报告升级情况；如果超过支出上限，则会拒绝升级。
• database 不会升级：不受支持的筛选条件会报错，而不会增加费用。
• realtime 直接进行实时查询。实时计数需要付费，因此只有在明确要求时，count_* 才会执行实时查询。

筛选条件词汇表

company_industries 和 seniorities 会静默接受未知值并返回零条结果，这会让人误以为“此受众不存在”。因此，服务端会在发送请求前检查值：未知的行业、员工人数区间和公司类型会在本地被拒绝，并提供最接近的有效名称；大小写不正确的值会被自动更正。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 会在提交前进行检查，因为批量任务会预先锁定全部费用。

Agent 技能

工具让 Agent 能够调用 Generect；技能则会教它执行上述流程。

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

参见 skills/README.md。

更多信息

• 文档
• 服务的运行与自托管：日志记录、OAuth 端点、安全设置、部署、Docker
• 发布流程
• 问题反馈

许可证

MIT