使用说明
Apollo.io MCP服务器
官方的Apollo.io模型上下文协议服务器,用于潜在客户开发、潜在客户丰富、销售情报和外联工作流程。
供应商: 由以下人员构建和维护的官方第一方服务器 阿波罗.io.
将Apollo.io的勘探、丰富和推广直接引入您最喜欢的MCP兼容AI应用程序——GitHub Copilot、Visual Studio Code、Cursor、Claude Code、Claude Desktop和Claude Cowork。
- 阿波罗.io: https://www.apollo.io/
- 模型上下文协议: https://modelcontextprotocol.io/
- 许可证: 麻省理工学院
目录
- 概述
- 关键能力
- 先决条件
- 在Visual Studio Code和GitHub Copilot中安装
- 在游标中安装
- 在Claude代码中安装
- 在Claude Desktop或Claude Cowork中安装
- 通用MCP客户端配置
- 认证与授权
- 使用示例
- 可用工具和功能
- 模型建议
- 安全和负责任的使用
- 隐私和数据处理
- 故障排除
- MCP官方登记处
- 发展与贡献
- 版本控制和发布
- 安全
- 支持
- 鸣谢
- 许可证
概述
Apollo.io MCP服务器通过 模型上下文协议,因此兼容MCP的人工智能应用程序可以为个人和公司寻找潜在客户,丰富联系人,查询销售分析,并使用自然语言将潜在客户加载到外展序列中。
-
由Apollo.io托管和维护。 服务器远程运行,无需在本地构建、托管或运行任何内容。
-
运输: 流式HTTP。
-
端点:
https://mcp.apollo.io/mcp -
身份验证: 通过Apollo.io OAuth处理。您使用您的Apollo.io帐户登录,并授权您的MCP客户端访问;然后,服务器使用您的Apollo.io权限进行操作。看 认证与授权.
此存储库还为Claude Code和Cowork提供了一个可选的Apollo插件,该插件捆绑了现成的工作流技能(/apollo:* 命令)位于同一MCP服务器之上。
关键能力
此存储库中的服务器工具和技能证实了以下功能:
- 人员勘探 --按职位、资历、地点和公司属性搜索阿波罗的人员数据库。
- 公司勘探 --按行业、规模、位置和关键字搜索组织。
- 联系人和账户丰富 --个人或集体地匹配和丰富个人和组织。
- 外展序列工作流程 --查找序列,并在序列中添加或删除/停止联系人。
- 业务销售分析 --查询电子邮件、电话、会议、任务、机会、序列和对话智能指标,并返回格式化的细分。
- 联系人管理 --创建Apollo联系人,作为丰富和序列加载工作流程的一部分。
远程服务器可能会暴露除捆绑技能之外的其他工具。上面的列表反映了此存储库中已确认的内容。看 可用工具和功能.
先决条件
-
一个Apollo.io帐户。 登录地址: https://www.apollo.io/.
-
Apollo.io权限和信用。 操作使用您帐户的权限运行,有些操作会消耗Apollo积分(例如,丰富)。看 安全和负责任的使用。有关计划、信用和权限的详细信息,请参阅 阿波罗文件.
-
MCP兼容客户端 支持流式HTTP传输,例如:
- Visual Studio代码中的GitHub副本
- 光标
- Claude 代码
- 克劳德桌面/克劳德协作
- 其他MCP客户端(参见 通用MCP客户端配置)
-
不需要本地运行时。 服务器是远程的,由Apollo.io托管——你可以 不 需要Node.js、Docker或本地安装才能使用它。(可选的Claude Code/Cowork插件通过客户端的插件系统在本地安装工作流技能,但MCP服务器本身仍然是远程的。)
在Visual Studio Code和GitHub Copilot中安装
Apollo.io MCP服务器在官方的模型上下文协议注册表中发布,但它是 在策划的GitHub MCP注册表或VS代码MCP库中尚未发现。在此之前,请使用以下配置手动添加。
选项A——工作区配置文件
创建一个 .vscode/mcp.json 工作区中的文件:
{
"servers": {
"apollo": {
"type": "http",
"url": "https://mcp.apollo.io/mcp"
}
}
}
选项B--命令选项板
- 打开命令选项板(
Cmd/Ctrl + Shift + P). - 跑 MCP:添加服务器.
- 出现提示时,选择HTTP(流式HTTP)服务器类型。
- 输入URL
https://mcp.apollo.io/mcp并命名服务器apollo.
预期的身份验证和首次运行
- 使用上面的任一选项添加MCP服务器。
- 启动或启用
apollo服务器。 - 在打开的浏览器窗口中完成Apollo.io身份验证。
- 批准您对Apollo.io工作区的访问请求。
- 打开Copilot聊天 代理人 模式。
- 确认阿波罗工具已列出并可供代理使用。
有关当前的术语和行为,请参阅MCP服务器上的VS Code文档: https://code.visualstudio.com/docs/copilot/chat/mcp-servers.
在游标中安装
将远程Streamable HTTP端点添加到您的Cursor MCP配置中(例如, ~/.cursor/mcp.json,或项目级别 .cursor/mcp.json):
{
"mcpServers": {
"apollo": {
"type": "http",
"url": "https://mcp.apollo.io/mcp"
}
}
}
然后:
- 打开光标设置并确认
apollo服务器列在MCP下。 - 出现提示时,使用您的Apollo.io帐户进行身份验证。
- 批准请求的访问权限,然后使用代理中的Apollo工具。
此存储库还包括一个Cursor插件清单(
.cursor-plugin/plugin.json)引用相同的远程端点(.mcp.json),因此不需要运行本地包。
在Claude代码中安装
您可以通过以下两种方式之一连接服务器。
选项A——直接添加远程MCP服务器
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
然后运行 /mcp 在Claude Code中,选择 阿波罗,并进行身份验证。
选项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,以便MCP服务器正确启动。
Claude 桌面版
从Claude设置中添加Apollo连接器,然后进行身份验证:
- 打开 设置 并连接Apollo.io连接器(Apollo显示为远程MCP服务器)。
- 在浏览器中完成Apollo.io身份验证。
- 批准请求的访问权限。
- 确认Apollo工具在新聊天中可用。
确切的菜单标签和导航因Claude Desktop版本而异。有关添加远程MCP连接器的当前步骤,请参阅Anthropic的文档。
通用MCP客户端配置
对于支持Streamable HTTP的任何其他MCP兼容客户端:
{
"name": "apollo",
"type": "streamable-http",
"url": "https://mcp.apollo.io/mcp"
}
具体的属性名称因客户端而异。一些客户使用
type: "http"(如上面的VS代码和游标示例)和一些使用type: "streamable-http"。有关确切的模式,请参阅客户的MCP文档。
认证与授权
Apollo MCP服务器使用 Apollo.io OAuth此处仅记录确认的行为。
- 登录流程。 当您连接服务器时,您的客户端会打开一个Apollo.io登录和授权窗口。在您批准访问后,您的客户端可以代表您调用Apollo工具。
- 工作区和权限。 服务器使用经过身份验证的用户的Apollo.io权限进行操作。您只能访问数据并执行您的Apollo.io帐户允许的操作。
- 重新连接。 在Claude Code中,您可以重新运行
/mcp,选择 阿波罗,并重新进行身份验证。在其他客户端中,从客户端的MCP或连接器设置重新触发身份验证。 - 撤销访问权限。 移除或断开
apollo从您的MCP客户端访问服务器,以阻止它代表您行事。要在帐户级别管理授权,请使用您的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 |
输入姓名、领英网址或电子邮件,即可获得一张包含公司背景和下一步行动的完整联系卡。 |
/apollo:prospect |
用简单的英语描述你的ICP,并获得一个丰富的决策者排名表。 |
/apollo:sequence-load |
查找潜在客户,丰富他们,重复数据删除,并在注册前将他们批量添加到阿波罗序列中并进行预览。 |
/apollo:analytics |
询问任何销售绩效问题,并从真实的阿波罗分析数据中获取格式化表格。 |
技能参考的阿波罗工具
| 工具 | 描述 | 数据效果 | 外联/外部行动 |
|---|---|---|---|
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_emailer_campaigns_search |
按名称查找外展序列。 | 阅读 | 否 |
apollo_emailer_campaigns_add_contact_ids |
将联系人添加到外展序列中。 | 更改阿波罗数据 | 是--根据序列设置,可能会开始出站。 |
apollo_emailer_campaigns_remove_or_stop_contact_ids |
按外展顺序删除或停止联系人。 | 更改阿波罗数据 | 影响主动外展 |
apollo_email_accounts_index |
列出已连接的电子邮件/发送帐户。 | 阅读 | 否 |
apollo_analytics_sync_report |
检索销售分析指标和细分。 | 阅读 | 否 |
一些行动(如铀浓缩)会消耗阿波罗积分。有关每个工具的信用成本和权威的最新工具参考,请参阅 阿波罗文件.
模型建议
对于可以选择模型的客户(例如,Claude Code通过 /model):
- Opus(最佳质量) --最强大的推理能力和最可靠的多步骤工具编排。最适合勘探工作流程、模糊匹配、多步骤链接和高风险任务。权衡:更高的延迟和使用成本。
- 十四行诗(更快) --有利于快速查找、轻量级丰富和快速迭代。权衡:可能需要更多关于复杂多步骤工作流程的指导。
安全和负责任的使用
- 审查勘探结果 在使用或导出它们之前。
- 遵守适用的隐私、营销、反垃圾邮件和数据保护法律 在您的管辖范围内和您的收件人。
- 确认收件人 在将任何人添加到外展序列之前。根据您的顺序和发送配置,注册可能会自动开始出站。在确认之前,始终验证序列名称、发送帐户和注册量。
- 注意阿波罗信贷消费。 一些行动(如浓缩)会消耗阿波罗积分,批量行动会随着数量的增加而扩大。此存储库的技能旨在在信用消费操作之前发出警告并请求确认。有关信贷成本,请参阅 阿波罗文件.
- 避免大规模或破坏性行为 而没有首先审查其确切范围。
- 尊重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 → 阿波罗 → 认证)。 |
| 服务器未启动 | 添加/安装后重新启动客户端;确认端点URL是否准确 https://mcp.apollo.io/mcp. |
| 工具未出现 | 确认服务器已启用并经过身份验证,并且(对于Copilot)聊天处于 代理人 模式。 |
| 某个操作的“权限被拒绝” | 您的Apollo.io帐户可能缺少该操作所需的权限。 |
| 积分不可用 | 浓缩和一些行动需要阿波罗积分;确认您的工作区有可用的积分。 |
| 客户端不支持Streamable HTTP | 请使用支持Streamable HTTP传输或中的通用配置的客户端 通用MCP客户端配置. |
| 配置中的JSON无效 | 验证您的 mcp.json /带有JSON linter的客户端配置——尾随逗号或缺少大括号将阻止服务器加载。 |
| 公司代理或防火墙阻止端点 | 确保 https://mcp.apollo.io 可以通过您的网络/代理分配列表访问。 |
MCP官方登记处
此服务器已发布 活跃的 在官方 模型上下文协议注册表.
| 字段 | 值 |
|---|---|
| 注册表名称 | io.github.apolloio/apollo-mcp |
| 版本 | 0.1.1 |
| 传输 | 流式HTTP |
| 端点 | https://mcp.apollo.io/mcp |
在官方模型上下文协议注册表中的发布与 策划GitHub MCP注册表 以及VS代码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/ |
游标插件清单。 |
glama.json |
Glama MCP目录元数据。 |
skills/ |
工作流程技能: prospect, enrich-lead, sequence-load, analytics. |
.github/workflows/publish-mcp.yml |
CI发布 server.json 到MCP注册表。 |
验证 server.json
server.json 遵循文件顶部引用的MCP服务器模式。发布由CI工作流自动完成(见下文),该工作流下载官方 mcp-publisher 并奔跑 mcp-publisher publish.
没有独立的 validate 命令。检查 server.json 在本地推送之前,使用官方CLI运行模拟发布:
mcp-publisher publish --dry-run
欢迎通过pull请求进行贡献。请保持版本元数据的一致性 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,thepublish-mcp.yml工作流将新版本发布到 官方模型上下文协议注册表 (通过GitHub OIDC进行身份验证)。 - 将版本保留在
server.json插件清单在发布前对齐,因此存储库和注册表保持同步。 - 发布由以下因素驱动
server.json上的变化main--存储库不会删除每个版本的GitHub版本或版本标签。
安全
请做 不 通过公共GitHub问题报告安全漏洞。
通过以下方式私下报告可疑漏洞 阿波罗信托中心。参见 SECURITY.md 了解完整的披露过程和范围。
支持
| 需要 | 去哪里 |
|---|---|
| Apollo产品支持(数据、信用、账户、账单) | 阿波罗知识库 或 联系阿波罗支持 |
| 阿波罗产品文档 | docs.apollo.io |
| MCP集成错误(此存储库) | 在GitHub上打开问题 apolloio/apollo mcp插件 |
| 功能请求 | 在上打开GitHub问题 apolloio/apollo mcp插件 |
| 安全漏洞 | 不要公开问题——请参阅 安全 |
鸣谢
许可证
麻省理工学院——见 许可证 了解详情。版权所有(c)2025 Apollo.io。
