Official Apollo.io MCP
官方无需AI助手,即可找到买家并预订更多会议
你可以用 Official Apollo Io MCP 做什么?
- 寻找目标人群 — 让您的助手使用
apollo_mixed_people_api_search查找决策者,并可按职位、资历、地点和公司属性等条件进行筛选。 - 丰富联系人与公司信息 — 使用
apollo_people_match或apollo_organizations_enrich,通过 LinkedIn URL 或电子邮件地址获取最新的职位、公司信息和经过验证的企业邮箱。 - 将线索加入序列 — 让您的助手通过
apollo_emailer_campaigns_add_contact_ids查找并批量添加联系人到外联序列,并在加入前提供预览。 - 查询销售分析 — 使用
apollo_analytics_sync_report请求获取邮件、电话、会议或序列表现的格式化明细,例如“显示本季度各代表的电话接通率”。 - 管理外联序列 — 使用
apollo_emailer_campaigns_remove_or_stop_contact_ids移除或停止活跃序列中的联系人,以控制进行中的外联活动。
托管 MCP 服务器
npx add-mcp 'https://mcp.apollo.io/mcp'可安装到 Claude Code、Codex、Cursor 等客户端
文档
Apollo.io MCP 服务器
官方的 Apollo.io 模型上下文协议服务器,用于潜在客户开发、线索丰富、销售情报和外联工作流。
提供商: 由 Apollo.io 构建和维护的官方第一方服务器。
将 Apollo.io 的潜在客户开发、丰富和外联功能直接带入您喜爱的 MCP 兼容 AI 应用程序——GitHub Copilot、Visual Studio Code、Cursor、Claude Code、Claude Desktop 和 Claude Cowork。
- Apollo.io: https://www.apollo.io/
- 模型上下文协议: https://modelcontextprotocol.io/
- 许可证: MIT
目录
- 概述
- 核心功能
- 前提条件
- 在 Visual Studio Code 和 GitHub Copilot 中安装
- 在 Cursor 中安装
- 在 Claude Code 中安装
- 在 Claude Desktop 或 Claude Cowork 中安装
- 通用 MCP 客户端配置
- 身份验证与授权
- 使用示例
- 可用工具与功能
- 模型推荐
- 安全与负责任使用
- 隐私与数据处理
- 故障排除
- 官方 MCP 注册表
- 开发与贡献
- 版本与发布
- 安全性
- 支持
- 致谢
- 许可证
概述
Apollo.io MCP 服务器通过模型上下文协议公开 Apollo.io 的市场推广数据和流程,使兼容 MCP 的 AI 应用程序能够使用自然语言进行人员和公司潜在客户开发、联系人丰富、销售分析查询以及将线索加载到外联序列中。
-
由 Apollo.io 托管和维护。 服务器远程运行——无需本地构建、托管或运行任何内容。
-
传输方式: Streamable HTTP。
-
端点:
https://mcp.apollo.io/mcp -
身份验证: 通过 Apollo.io OAuth 处理。您使用 Apollo.io 账户登录并从 MCP 客户端授权访问;服务器随后以您的 Apollo.io 权限进行操作。请参阅身份验证与授权。
此仓库还附带一个可选的 Claude Code 和 Cowork 的 Apollo 插件,该插件在同一个 MCP 服务器之上捆绑了现成的工作流技能(/apollo:* 命令)。
核心功能
以下功能已通过此仓库中的服务器工具和技能得到确认:
- 人员潜在客户开发 — 按职位、资历、地点和公司属性搜索 Apollo 的人员数据库。
- 公司潜在客户开发 — 按行业、规模、地点和关键词搜索组织。
- 联系人和账户丰富 — 单独或批量匹配和丰富人员与组织。
- 外联序列工作流 — 查找序列,并在序列中添加或移除/停止联系人。
- 销售分析 — 查询电子邮件、电话、会议、任务、机会、序列和对话智能指标,并返回格式化的细分数据。
- 联系人管理 — 在丰富和序列加载工作流中创建 Apollo 联系人。
远程服务器可能公开超出捆绑技能所使用范围的其他工具。以上列表反映了此仓库中已确认的内容。请参阅可用工具与功能。
前提条件
-
一个 Apollo.io 账户。 在 https://www.apollo.io/ 登录。
-
Apollo.io 权限和积分。 操作以您账户的权限运行,某些操作会消耗 Apollo 积分(例如丰富功能)。请参阅安全与负责任使用。有关套餐、积分和权限详情,请参阅 Apollo 文档。
-
一个支持 Streamable HTTP 传输的 MCP 兼容客户端,例如:
- Visual Studio Code 中的 GitHub Copilot
- Cursor
- Claude Code
- Claude Desktop / Claude Cowork
- 其他 MCP 客户端(请参阅通用 MCP 客户端配置)
-
无需本地运行时。 服务器是远程的,由 Apollo.io 托管——您无需 Node.js、Docker 或本地安装即可使用。(可选的 Claude Code / Cowork 插件通过客户端的插件系统在本地安装工作流技能,但 MCP 服务器本身仍然是远程的。)
在 Visual Studio Code 和 GitHub Copilot 中安装
Apollo.io MCP 服务器已发布在官方模型上下文协议注册表中,但尚不可在精选的 GitHub MCP 注册表或 VS Code MCP 画廊中发现。在此之前,请使用以下配置手动添加。
选项 A — 工作区配置文件
在工作区中创建 .vscode/mcp.json 文件:
{
"servers": {
"apollo": {
"type": "http",
"url": "https://mcp.apollo.io/mcp"
}
}
}
选项 B — 命令面板
- 打开命令面板(
Cmd/Ctrl + Shift + P)。 - 运行 MCP: Add Server。
- 在提示时选择 HTTP(Streamable HTTP)服务器类型。
- 输入 URL
https://mcp.apollo.io/mcp并将服务器命名为apollo。
预期的身份验证和首次运行
- 使用上述任一选项添加 MCP 服务器。
- 启动或启用
apollo服务器。 - 在打开的浏览器窗口中完成 Apollo.io 身份验证。
- 批准对您的 Apollo.io 工作区请求的访问权限。
- 在 Agent 模式下打开 Copilot Chat。
- 确认 Apollo 工具已列出并可供代理使用。
有关当前术语和行为,请参阅 VS Code 关于 MCP 服务器的文档:https://code.visualstudio.com/docs/copilot/chat/mcp-servers。
在 Cursor 中安装
将远程 Streamable HTTP 端点添加到您的 Cursor MCP 配置中(例如,~/.cursor/mcp.json 或项目级别的 .cursor/mcp.json):
{
"mcpServers": {
"apollo": {
"type": "http",
"url": "https://mcp.apollo.io/mcp"
}
}
}
然后:
- 打开 Cursor 设置并确认
apollo服务器已列在 MCP 下。 - 在提示时使用您的 Apollo.io 账户进行身份验证。
- 批准请求的访问权限,然后从代理使用 Apollo 工具。
此仓库还包含一个 Cursor 插件清单(
.cursor-plugin/plugin.json),它引用了相同的远程端点(.mcp.json),因此无需运行本地包。
在 Claude Code 中安装
您可以通过以下两种方式之一连接服务器。
选项 A — 直接添加远程 MCP 服务器
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
然后在 Claude Code 中运行 /mcp,选择 apollo 并进行身份验证。
选项 B — 安装 Apollo 插件(添加 /apollo:* 工作流技能)
-
添加此插件的市场:
/plugin marketplace add apolloio/apollo-mcp-plugin -
安装插件:
/plugin install apollo@apollo-plugin-marketplace -
重启 Claude Code,以便 MCP 服务器正确启动。
该插件会自动配置 Apollo MCP 服务器——无需手动配置文件。安装后,使用 /mcp 进行身份验证并运行 /apollo:* 命令(请参阅可用工具与功能)。
在 Claude Desktop 或 Claude Cowork 中安装
Claude Desktop 和 Claude Cowork 与 Claude Code(CLI)是分开的。请使用以下步骤操作基于桌面的客户端。
Cowork(一键安装)
单击即可一步安装:
然后重启 Cowork,以便 MCP 服务器正确启动。
Claude Desktop
从您的 Claude 设置中添加 Apollo 连接器,然后进行身份验证:
- 打开 设置 并连接 Apollo.io 连接器(Apollo 显示为远程 MCP 服务器)。
- 在浏览器中完成 Apollo.io 身份验证。
- 批准请求的访问权限。
- 在新聊天中确认 Apollo 工具可用。
确切的菜单标签和导航因 Claude Desktop 版本而异。请参阅 Anthropic 的文档了解添加远程 MCP 连接器的当前步骤。
通用 MCP 客户端配置
对于任何其他支持 Streamable HTTP 的 MCP 兼容客户端:
{
"name": "apollo",
"type": "streamable-http",
"url": "https://mcp.apollo.io/mcp"
}
确切的属性名称因客户端而异。某些客户端使用
type: "http"(如上述 VS Code 和 Cursor 示例),某些使用type: "streamable-http"。请查阅您客户端的 MCP 文档以了解精确的模式。
身份验证与授权
Apollo MCP 服务器使用 Apollo.io OAuth。此处仅记录已确认的行为。
- 登录流程。 当您连接服务器时,您的客户端会打开一个 Apollo.io 登录和授权窗口。在您批准访问后,您的客户端可以代表您调用 Apollo 工具。
- 工作区和权限。 服务器以已认证用户的 Apollo.io 权限进行操作。您只能访问您的 Apollo.io 账户被允许访问的数据并执行允许的操作。
- 重新连接。 在 Claude Code 中,您可以重新运行
/mcp,选择 apollo 并重新进行身份验证。在其他客户端中,从客户端的 MCP 或连接器设置中重新触发身份验证。 - 撤销访问权限。 从您的 MCP 客户端中移除或断开
apollo服务器,以停止其代表您操作。要在账户级别管理授权,请使用您的 Apollo.io 账户设置。
OAuth 授权服务器元数据可在
https://mcp.apollo.io/.well-known/oauth-authorization-server发现。除此之外,本 README 不声明特定的 OAuth 规范或配置文件。
使用示例
服务器连接后可以尝试的自然语言提示:
Find software engineering leaders at B2B SaaS companies in Germany with 200–1,000 employees.
Enrich these business contacts and return their current title, company, and verified business email when available.
Show email and call performance by rep for this quarter, sorted by calls made.
Add the selected contacts to my Apollo sequence "Q1 Enterprise Outbound" — show a preview before enrolling.
如果您安装了 Claude Code / Cowork 插件,相同的工作流可作为斜杠命令使用:
/apollo:prospect VP of Engineering at Series B+ SaaS companies in the US, 200-1000 employees/apollo:enrich-lead https://www.linkedin.com/in/example/apollo:sequence-load add 20 VP Sales at SaaS companies to my "Q1 Outbound" sequence/apollo:analytics Show me team call connect rate this quarter by rep
在操作前审查。 对于有重大影响的操作——丰富(消耗积分)和将联系人添加到序列(可能涉及外联)——请在确认操作前审查确切的目标和参数。
可用工具与功能
远程服务器提供底层的 Apollo 工具;以下列出的工具是在此仓库中通过捆绑的工作流技能确认的。完整、权威的工具集由远程服务器提供,并可能独立于此文档演进。
工作流技能(Claude Code / Cowork 插件)
将多个 Apollo 工具链接成完整工作流的高价值技能:
| 技能 | 功能 |
|---|---|
/apollo:enrich-lead | 输入姓名、LinkedIn URL 或电子邮件,获取包含公司背景和后续行动的完整联系人卡片。 |
/apollo:prospect | 用通俗英语描述您的理想客户画像(ICP),获取排名靠前的丰富决策者表格。 |
/apollo:sequence-load | 查找线索、丰富线索、去重,并在注册前预览后批量添加到 Apollo 序列。 |
/apollo:analytics | 提出任何销售绩效问题,从真实的 Apollo 分析数据中获取格式化表格。 |
技能引用的底层 Apollo 工具
| 工具 | 描述 | 数据影响 | 外联/外部操作 |
|---|---|---|---|
apollo_mixed_people_api_search | 按职位、资历、地点和公司筛选条件搜索 Apollo 人员数据库。 | 读取 | 否 |
apollo_mixed_companies_search | 按行业、规模、地点和关键词搜索 Apollo 组织数据库。 | 读取 | 否 |
apollo_people_match | 根据可用标识符匹配并丰富单个人员。 | 读取/丰富 | 否 |
apollo_people_bulk_match | 在一次调用中匹配并丰富多个人员。 | 读取/丰富 | 否 |
apollo_organizations_enrich | 丰富单个组织。 | 读取/丰富 | 否 |
apollo_organizations_bulk_enrich | 在一次调用中丰富多个组织。 | 读取/丰富 | 否 |
apollo_contacts_create | 在 Apollo 工作区中创建联系人。 | 更改 Apollo 数据 | 否 |
apollo_emailer_campaigns_search | 按名称查找外联序列。 | 读取 | 否 |
apollo_emailer_campaigns_add_contact_ids | 将联系人添加到外联序列。 | 更改 Apollo 数据 | 是——根据序列设置,可能会启动外发操作。 |
apollo_emailer_campaigns_remove_or_stop_contact_ids | 移除或停止外联序列中的联系人。 | 更改 Apollo 数据 | 影响进行中的外联 |
apollo_email_accounts_index | 列出已连接的电子邮件/发送账户。 | 读取 | 否 |
apollo_analytics_sync_report | 获取销售分析指标和细分数据。 | 读取 | 否 |
某些操作(如丰富)会消耗 Apollo 积分。有关每个工具的积分成本以及权威的最新工具参考,请参阅 Apollo 文档。
模型建议
对于可以选择模型的客户端(例如,通过 /model 使用 Claude Code):
- Opus(最佳质量) — 最强的推理能力和最可靠的多步骤工具编排。最适合潜在客户开发工作流、模糊匹配、多步骤链式操作和高风险任务。权衡:延迟更高、使用成本更高。
- Sonnet(更快) — 适合快速查询、轻量级丰富和快速迭代。权衡:在复杂多步骤工作流中可能需要更多指导。
安全与负责任使用
- 在使用或导出潜在客户开发结果之前,先进行审查。
- 遵守您所在司法管辖区以及收件人所在司法管辖区的适用隐私、营销、反垃圾邮件和数据保护法律。
- 在将任何人添加到外联序列之前,确认收件人。根据您的序列和发送配置,注册可能会自动启动外发操作。在确认之前,务必核实序列名称、发送账户和注册量。
- 注意 Apollo 积分消耗。 某些操作(如丰富)会消耗 Apollo 积分,批量操作会随数量增加而扩大消耗。本仓库的技能旨在消耗积分的操作前发出警告并请求确认。有关积分成本,请参阅 Apollo 文档。
- 未经核实确切范围,避免批量或破坏性操作。
- 尊重 Apollo 账户权限和您所在组织的政策。
本节内容为指南,不构成法律建议。
隐私与数据处理
- 请求将发送至 Apollo 托管的 MCP 端点(
https://mcp.apollo.io/mcp)。 - 服务器在您已认证的账户和权限下与 Apollo 数据交互。
- 避免在提示词中发送不必要的敏感信息。
有关 Apollo.io 官方的隐私和安全资源:
- 隐私政策: https://www.apollo.io/privacy-policy
- 隐私中心: https://www.apollo.io/company/privacy-center
- 安全: https://www.apollo.io/product/security
- 信任中心: https://trust.apollo.io/
故障排查
| 症状 | 需要检查的内容 |
|---|---|
| 认证窗口未打开 | 确保允许弹出窗口;从客户端的 MCP/连接器设置中重新触发认证。 |
| 认证会话已过期 | 重新认证(在 Claude Code 中,运行 /mcp → apollo → 认证)。 |
| 服务器无法启动 | 添加/安装后重启客户端;确认端点 URL 确为 https://mcp.apollo.io/mcp。 |
| 工具未显示 | 确认服务器已启用并完成认证,并且(对于 Copilot)聊天处于 Agent 模式。 |
| 操作提示"权限被拒绝" | 您的 Apollo.io 账户可能缺少执行该操作所需的权限。 |
| 积分不可用 | 丰富和某些操作需要 Apollo 积分;确认您的工作区有可用积分。 |
| 客户端不支持 Streamable HTTP | 使用支持 Streamable HTTP 传输的客户端,或使用 通用 MCP 客户端配置 中的通用配置。 |
| 配置中的 JSON 无效 | 使用 JSON 检查工具验证您的 mcp.json / 客户端配置——尾随逗号或缺少大括号都会导致服务器无法加载。 |
| 企业代理或防火墙阻止端点 | 确保 https://mcp.apollo.io 可通过您的网络/代理白名单访问。 |
官方 MCP 注册表
此服务器已发布并在官方 Model Context Protocol 注册表 中处于活跃状态。
| 字段 | 值 |
|---|---|
| 注册表名称 | io.github.apolloio/apollo-mcp |
| 版本 | 0.1.1 |
| 传输方式 | Streamable HTTP |
| 端点 | https://mcp.apollo.io/mcp |
在官方 Model Context Protocol 注册表中发布与精选 GitHub MCP 注册表和 VS Code MCP 画廊是分开的。在官方注册表中处于活跃状态并不会自动使服务器在这些精选目录中可被发现。
开发与贡献
本仓库包含 Apollo MCP 客户端配置、Claude/Cursor 插件清单、工作流技能和注册表元数据。MCP 服务器本身由 Apollo.io 托管。
仓库结构:
| 路径 | 用途 |
|---|---|
.mcp.json | 远程 MCP 服务器定义(apollo → https://mcp.apollo.io/mcp)。 |
server.json | 官方 MCP 注册表元数据(名称、版本、传输方式、端点)。 |
.claude-plugin/ | Claude Code / Cowork 插件和市场清单。 |
.cursor-plugin/ | Cursor 插件清单。 |
glama.json | Glama MCP 目录元数据。 |
skills/ | 工作流技能:prospect、enrich-lead、sequence-load、analytics。 |
.github/workflows/publish-mcp.yml | 将 server.json 发布到 MCP 注册表的 CI。 |
验证 server.json
server.json 遵循文件顶部引用的 MCP 服务器模式。发布由 CI 工作流(见下文)自动完成,该工作流会下载官方 mcp-publisher 并运行 mcp-publisher publish。
没有独立的 validate 命令。要在推送前在本地检查 server.json,请使用官方 CLI 运行试发布:
mcp-publisher publish --dry-run
欢迎通过拉取请求贡献。请保持 server.json、.claude-plugin/plugin.json 和 .cursor-plugin/plugin.json 中的版本元数据一致。
版本与发布
- 服务器版本在
server.json(version: 0.1.1)中声明,并在插件清单(.claude-plugin/plugin.json、.cursor-plugin/plugin.json)中同步。 - 每次向
main推送更改server.json时,publish-mcp.yml工作流会将新版本发布到官方 Model Context Protocol 注册表(通过 GitHub OIDC 进行认证)。 - 在发布前保持
server.json和插件清单中的版本一致,以便仓库和注册表保持同步。 - 发布由
server.json在main上的更改驱动——本仓库不会按版本发布 GitHub Release 或版本标签。
安全
请不要通过公开的 GitHub issue 报告安全漏洞。
请通过 Apollo 信任中心 私下报告疑似漏洞。完整的披露流程和范围请参阅 SECURITY.md。
支持
| 需求 | 前往地点 |
|---|---|
| Apollo 产品支持(数据、积分、账户、计费) | Apollo 知识库 或 联系 Apollo 支持 |
| Apollo 产品文档 | docs.apollo.io |
| MCP 集成错误(本仓库) | 在 apolloio/apollo-mcp-plugin 上打开 GitHub issue |
| 功能请求 | 在 apolloio/apollo-mcp-plugin 上打开 GitHub issue |
| 安全漏洞 | 请勿打开公开 issue——请参阅 安全 |
致谢
许可证
MIT——详情请参阅 LICENSE。版权所有(c)2025 Apollo.io。