Apollo.io

Apollo.io MCP 服务

Apollo.io 官方 Model Context Protocol 服务，用于客户挖掘、潜在客户信息补充、销售情报和外联工作流。

提供方： 由 Apollo.io 构建并维护的官方一方服务。

将 Apollo.io 的客户挖掘、信息补充和外联功能直接集成到你喜爱的 MCP 兼容 AI 应用中 — GitHub Copilot、Visual Studio Code、Cursor、Claude Code、Claude Desktop 和 Claude Cowork。

• Apollo.io： https://www.apollo.io/
• Model Context Protocol： https://modelcontextprotocol.io/
• 许可证： MIT

---

目录

• 概述
• 主要功能
• 前提条件
• 在 Visual Studio Code 和 GitHub Copilot 中安装
• 在 Cursor 中安装
• 在 Claude Code 中安装
• 在 Claude Desktop 或 Claude Cowork 中安装
• 通用 MCP 客户端配置
• 身份验证与授权
• 使用示例
• 可用工具和功能
• 模型建议
• 安全与负责任的使用
• 隐私与数据处理
• 故障排除
• 官方 MCP Registry
• 开发与贡献
• 版本管理与发布
• 安全
• 支持
• 致谢
• 许可证

---

概述

Apollo.io MCP 服务通过 Model Context Protocol 提供 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 插件，其中包含现成的工作流技能（/apollo:* 命令），并基于同一 MCP 服务运行。

---

主要功能

以下功能已由本仓库中的服务工具和技能确认：

• 人员潜客挖掘 — 按职位、资历、所在地和公司属性搜索 Apollo 人员数据库。
• 公司潜客挖掘 — 按行业、规模、所在地和关键词搜索组织。
• 联系人和账户信息补全 — 匹配并补全个人和组织的信息，支持单条或批量处理。
• 外联序列工作流 — 查找序列，并在序列中添加或移除／停止联系人。
• 销售分析 — 查询电子邮件、通话、会议、任务、商机、序列和对话智能指标，并返回格式化的明细。
• 联系人管理 — 在信息补全和序列加载工作流中创建 Apollo 联系人。

远程服务可能会提供捆绑技能未使用的其他工具。上述列表列出了本仓库中已确认的功能。请参阅可用工具和功能。

---

前提条件

• Apollo.io 账户。 请登录 https://www.apollo.io/。

• Apollo.io 权限和点数。 操作将使用您账户的权限，某些操作会消耗 Apollo 点数（例如，信息补全）。请参阅安全与负责任的使用。有关套餐、点数和权限的详细信息，请参阅 Apollo 文档。

• 兼容 MCP 的客户端，支持 Streamable HTTP 传输，例如：

  • 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 服务已发布在官方 Model Context Protocol Registry 中，但尚无法在精选的 GitHub MCP Registry 或 VS Code MCP 扩展库中发现。在此之前，请使用以下配置手动添加。

选项 A — 工作区配置文件

在工作区中创建 .vscode/mcp.json 文件：

{
  "servers": {
    "apollo": {
      "type": "http",
      "url": "https://mcp.apollo.io/mcp"
    }
  }
}

选项 B — 命令面板

1. 打开命令面板（Cmd/Ctrl + Shift + P）。
2. 运行 MCP: Add Server。
3. 根据提示选择 HTTP（Streamable HTTP）服务类型。
4. 输入 URL https://mcp.apollo.io/mcp，并将服务命名为 apollo。

预期的身份验证和首次运行

1. 使用上述任一选项添加 MCP 服务。
2. 启动或启用 apollo 服务。
3. 在打开的浏览器窗口中完成 Apollo.io 身份验证。
4. 批准为您的 Apollo.io 工作区请求的访问权限。
5. 在 Agent 模式下打开 Copilot Chat。
6. 确认 Apollo 工具已列出并可供 Agent 使用。

有关当前术语和行为，请参阅 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"
    }
  }
}

然后：

1. 打开 Cursor 设置，确认 MCP 下列出了 apollo 服务。
2. 根据提示使用您的 Apollo.io 账户进行身份验证。
3. 批准请求的访问权限，然后通过 Agent 使用 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:* 工作流技能）

1. 添加此插件的市场：

   /plugin marketplace add apolloio/apollo-mcp-plugin
   

2. 安装插件：

   /plugin install apollo@apollo-plugin-marketplace
   

3. 重启 Claude Code，以便 MCP 服务正确启动。

插件会自动配置 Apollo MCP 服务，无需手动配置文件。安装后，使用 /mcp 进行身份验证，然后运行 /apollo:* 命令（请参阅可用工具和功能）。

---

在 Claude Desktop 或 Claude Cowork 中安装

Claude Desktop 和 Claude Cowork 与 Claude Code（命令行）相互独立。请按照以下步骤操作桌面客户端。

Cowork（一键安装）

点击即可一步完成安装：

在 Cowork 中安装

然后重启 Cowork，以便 MCP 服务正确启动。

Claude Desktop

从 Claude 设置中添加 Apollo 连接器，然后进行身份验证：

1. 打开 设置 并连接 Apollo.io 连接器（Apollo 会显示为远程 MCP 服务）。
2. 在浏览器中完成 Apollo.io 身份验证。
3. 批准请求的访问权限。
4. 在新聊天中确认 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 账户设置。

可在 https://mcp.apollo.io/.well-known/oauth-authorization-server 发现 OAuth 授权服务器元数据。除此之外，本 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 → authenticate）。
服务未启动	添加或安装后重启客户端；确认端点 URL 完全准确，为 https://mcp.apollo.io/mcp。
工具未显示	确认服务已启用并通过身份验证；（对于 Copilot）确认聊天处于 Agent 模式。
执行操作时出现“Permission denied”	你的 Apollo.io 账户可能缺少执行该操作所需的权限。
无可用积分	数据补全和某些操作需要 Apollo 积分；确认你的工作区有可用积分。
客户端不支持 Streamable HTTP	使用支持 Streamable HTTP 传输的客户端，或使用通用 MCP 客户端配置中的通用配置。
配置中的 JSON 无效	使用 JSON 检查工具验证你的 mcp.json / 客户端配置——多余的逗号或缺少右花括号都会导致服务无法加载。
企业代理或防火墙阻止端点	确认可通过你的网络/代理允许列表访问 https://mcp.apollo.io。

---

官方 MCP 注册表

此服务已发布并在官方 Model Context Protocol Registry 中处于活跃状态。

字段	值
注册表名称	io.github.apolloio/apollo-mcp
版本	0.1.1
传输方式	Streamable HTTP
端点	https://mcp.apollo.io/mcp

在官方 Model Context Protocol Registry 中发布，与加入精选 GitHub MCP Registry和 VS Code MCP gallery 是相互独立的。在官方注册表中处于活跃状态，并不意味着该服务会自动出现在这些精选目录中。

---

开发与贡献

此代码库包含 Apollo MCP 客户端配置、Claude/Cursor 插件清单、工作流技能和注册表元数据。MCP 服务本身由 Apollo.io 托管。

代码库结构：

路径	用途
.mcp.json	远程 MCP 服务定义（apollo → https://mcp.apollo.io/mcp）。
server.json	官方 MCP Registry 元数据（名称、版本、传输方式、端点）。
.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 Registry 的 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 Registry（通过 GitHub OIDC 进行身份验证）。
• 发布前请确保 server.json 和插件清单中的版本一致，以便代码库与注册表保持同步。
• 发布由 main 上对 server.json 的更改触发——此代码库不会为每个版本创建 GitHub Releases 或版本标签。

---

安全

请勿通过公开的 GitHub issue 报告安全漏洞。

请通过 Apollo Trust Center 私下报告疑似漏洞。完整的披露流程和范围请参阅 SECURITY.md。

---

支持

需求	联系方式
Apollo 产品支持（数据、额度、账户、账单）	Apollo Knowledge Base 或 联系 Apollo Support
Apollo 产品文档	docs.apollo.io
MCP 集成问题（此代码库）	在 apolloio/apollo-mcp-plugin 上提交 GitHub issue
功能请求	在 apolloio/apollo-mcp-plugin 上提交 GitHub issue
安全漏洞	请勿提交公开 issue——请参阅安全

---

致谢

• Apollo.io 提供 MCP Server
• Anthropic 提供插件规范

---

许可证

MIT——详情请参阅 LICENSE。版权所有 (c) 2025 Apollo.io。