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 Server
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 註冊表
- 開發與貢獻
- 版本與發行
- 安全性
- 支援
- 致謝
- 授權
總覽
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 外掛程式,在相同的 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 伺服器已發布於官方 Model Context Protocol 註冊表,但尚無法在策展的 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(命令列介面)。請使用以下步驟操作桌面版用戶端。
Cowork(一鍵安裝)
按一下即可一步完成安裝:
然後重新啟動 Cowork,讓 MCP 伺服器正確啟動。
Claude Desktop
從 Claude 設定中新增 Apollo 連接器,然後驗證:
- 開啟 Settings 並連接 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 → authenticate)。 |
| 伺服器無法啟動 | 在新增/安裝後重新啟動用戶端;確認端點 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 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 畫廊是分開的。在官方註冊表中啟用並不自動使伺服器在那些精選目錄中可被發現。
開發與貢獻
此儲存庫包含 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
歡迎透過 pull request 貢獻。請保持 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與外掛程式清單中的版本一致,使儲存庫與註冊表保持同步。 - 發布由
server.json在main上的變更驅動——儲存庫不會為每個版本建立 GitHub Releases 或版本標籤。
安全性
請不要透過公開的 GitHub issue 回報安全漏洞。
請透過 Apollo Trust Center 私下回報疑似漏洞。完整的揭露流程與範圍請參閱 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。