Coresignal MCP v2 是 Coresignal 官方的 Model Context Protocol 服务器，目标是把新鲜的 B2B 数据——895M+ 员工、70M+ 公司和 468M+ 职位发布记录——直接带入 AI 助手。用户可在 Claude、Cursor、Codex、VS Code 或任何兼容 MCP 的客户端中使用自然语言搜索、拉取完整记录、为联系人补充已验证邮箱，并将大型结果集导出为可下载文件。
【主要能力】
- 自然语言搜索：以日常语言检索员工、公司或职位记录，例如“Senior Python developers at fintech companies in French”。每次调用固定消耗 20 credits，返回 total_count（精确匹配数量）、最多 20 条预览行（limit=0 仅返回计数），每行展示匹配到的字段，作为该结果出现的证据；同时返回 cache_id（1 小时有效句柄），可传给 entity_fetch 直接收集匹配记录，无需重跑搜索，解析 cache_id 本身免费，记录 ID 保留在服务端。
- 字段发现：entity_fields 支持按含义免费、即时查找字段名，例如“salary”找到薪酬字段，“current job title and seniority”找到 active_experience_title、experience.position_title 等，无需将 300+ 字段词表载入上下文。
- 记录收集：entity_fetch 可从搜索结果中挑选最多 20 个 ID，或通过 cache_id 每次调用收集最多 1,000 条记录；按找到的记录计费，员工/公司 20 credits，职位 1 credit。
- 邮箱补充：employee_enrich 为最多 1,000 个员工 ID 提供已验证、可投递的商业邮箱，每个找到的邮箱 10 credits，未找到的 ID 免费；EEA/UK 联系人因 GDPR 不可获取。
- 文件下载：大型结果不会直接倾泻到对话中，而是服务端存为文件并返回 1 小时有效的签名 HTTPS 下载链接，以节省 LLM 输入 token。
- artifact_read：通过已认证的 MCP 会话逐页读回已交付文件，免费（记录在获取时已计费），适用于无法打开链接或访问文件系统的聊天客户端。
【使用方式】 需要 Coresignal 账号、有效订阅（credits）以及在控制台配置的团队 API 密钥；登录后 MCP 服务器会自动解析团队密钥，无需在配置文件中粘贴。首次连接时客户端会打开浏览器窗口登录 Coresignal 控制台。
- Claude Desktop：通过 Connectors 原生支持远程 MCP 服务器。打开 Settings → Connectors → Add custom connector，名称填 Coresignal，URL 填 https://mcp.coresignal.com/mcp/v2，点击 Add 后 Connect，浏览器打开登录。重要：Claude Desktop 会拦截未知域名的下载，如需下载结果文件，请在设置中把 mcp.coresignal.com 加入 Domain allowlist（Team/Enterprise 由管理员管理）；否则下载链接会被阻止，但仍可用免费的 artifact_read 在对话中读回数据。
- Claude Code：在会话中运行 /mcp，选择 coresignal，完成浏览器登录；需要重新认证时再次运行 /mcp。
- Cursor：添加到 ~/.cursor/mcp.json；Cursor 检测到需要认证后会显示 Needs login 提示，点击完成浏览器登录。
- VS Code：运行命令面板中的 MCP: Add Server，选择 HTTP 并输入 URL，或添加到 .vscode/mcp.json；首次使用会提示授权并在浏览器处理 OAuth。
- Cline：添加到 ~/.cline/data/settings/cline_mcp_settings.json；打开 Cline MCP 界面，从菜单选择 Authorize OAuth 并选择 coresignal，浏览器处理 OAuth。
【下载与文件读取】 大型结果（以及任何 delivery="url" 的调用）会存为文件并返回 1 小时有效的签名下载链接。代理访问数据有三种方式：其一，自行下载文件——在有 shell 的客户端中通常用 curl 保存到磁盘，再用 grep/jq/pandas 本地分析；其二，在对话中读回——在没有 shell 和文件系统的客户端中调用 artifact_read(artifact_name, offset, limit) 分页读取，免费且通用，不会淹没对话；其三，手动下载——若代理不被允许获取链接（域名未加入白名单、沙箱无网络），可点击链接保存文件并告知代理位置。建议优先使用下载：artifact_read 在 Coresignal credits 上免费，但在 LLM token 上不免——每次分页都会进入对话并在后续轮次按输入 token 重新计费，且每页被裁剪到固定 token 预算（一份完整员工记录约 8k token），读取大文件可能需要数百次调用并耗尽上下文窗口；而下载文件几乎不消耗 token，助手可用 grep/jq 在本地过滤数千行。因此建议提前打通下载（域名白名单、沙箱网络访问），仅对无法下载的客户端或快速查看少量记录保留 artifact_read。如果下载被阻止，数据已存储且已付费，用 artifact_read 读取即可，切勿为“恢复”文件而重跑获取，否则会二次计费。
【计费与定价】 每次响应包含 credits_consumed（实际计费额度），例如发送 1,000 个 ID 却按 950 条记录计费，可据此判断未找到的 ID 数量。服务器不会静默消费：获取前会先与用户确认字段范围，无法交付的获取会在消耗 credits 前失败。Credits 来自团队的 Coresignal 订阅，可在控制台管理密钥和账单。新用户可使用 7 天免费试用，含 2,000 credits，相当于 100 次搜索，或 100 条员工/公司记录，或混合使用；具体方案对比见官方计划对比页面。
【适用场景与限制】 适用于在 AI 助手或 AI 工作流中进行 B2B 线索构建、公司深度调研、职位与人才检索、联系人邮箱补全及大规模数据导出。示例提示包括：查找过去两年融资、员工 50–200 人的北欧 B2B SaaS 公司；搜索 500+ 员工的美国公司数据负责人并将 20 份完整档案连同已验证邮箱获取到文件；拉取 flo.health 的完整记录（融资轮次、员工增长、当前职位空缺）。 限制与注意事项：需 Coresignal 订阅和 credits；EEA/UK 联系人邮箱不可获取（GDPR）；下载功能依赖域名白名单或网络访问；artifact_read 虽不消耗 Coresignal credits，但会消耗 LLM token，不宜用于读取大文件。