Official Apollo.io MCP

npx add-mcp 'https://mcp.apollo.io/mcp'

Apollo.io MCP 서버

영업 발굴(prospecting), 리드 인리치먼트, 영업 인텔리전스, 아웃리치 워크플로우를 위한 공식 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 서버는 Apollo.io의 GTM(Go-to-Market) 데이터와 워크플로우를 Model Context Protocol을 통해 노출하므로, MCP 호환 AI 애플리케이션이 자연어로 개인과 회사를 발굴하고, 연락처를 인리치하고, 영업 분석을 조회하고, 리드를 아웃리치 시퀀스에 로드할 수 있습니다.

• Apollo.io가 호스팅하고 유지 관리합니다. 서버는 원격으로 실행되며, 로컬에서 빌드하거나 호스팅하거나 실행할 필요가 없습니다.

• 전송 방식: Streamable HTTP.

• 엔드포인트:

  https://mcp.apollo.io/mcp
  

• 인증: Apollo.io OAuth를 통해 처리됩니다. Apollo.io 계정으로 로그인하고 MCP 클라이언트에서 액세스를 승인하면, 서버는 사용자의 Apollo.io 권한으로 작동합니다. 인증 및 권한 부여를 참조하세요.

이 저장소에는 동일한 MCP 서버 위에 바로 사용 가능한 워크플로우 스킬(/apollo:* 명령)을 번들로 제공하는 선택적 Apollo 플러그인(Claude Code 및 Cowork용)도 포함되어 있습니다.

---

주요 기능

이 저장소의 서버 도구와 스킬을 통해 확인된 기능은 다음과 같습니다:

• 개인 발굴 — 직함, 직급, 지역, 회사 속성으로 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 — 명령 팔레트

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. Copilot Chat을 Agent 모드로 엽니다.
6. Apollo 도구가 에이전트에 나열되고 사용 가능한지 확인합니다.

현재 용어 및 동작에 대한 자세한 내용은 MCP 서버에 대한 VS Code 문서를 참조하세요: 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 설정을 열고 apollo 서버가 MCP 아래에 나열되어 있는지 확인합니다.
2. 프롬프트가 표시되면 Apollo.io 계정으로 인증합니다.
3. 요청된 액세스를 승인한 후 에이전트에서 Apollo 도구를 사용합니다.

이 저장소에는 동일한 원격 엔드포인트(.mcp.json)를 참조하는 Cursor 플러그인 매니페스트(.cursor-plugin/plugin.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. MCP 서버가 올바르게 시작되도록 Claude Code를 다시 시작합니다.

플러그인은 Apollo MCP 서버를 자동으로 구성하므로 수동 구성 파일이 필요하지 않습니다. 설치 후 /mcp으로 인증하고 /apollo:* 명령을 실행하세요 (사용 가능한 도구 및 기능 참조).

---

Claude Desktop 또는 Claude Cowork에 설치

Claude Desktop과 Claude Cowork는 Claude Code(CLI)와 별개입니다. 데스크톱 기반 클라이언트에는 아래 단계를 사용하세요.

Cowork(원클릭)

한 번의 클릭으로 설치하세요:

Cowork에 설치

그런 다음 MCP 서버가 올바르게 시작되도록 Cowork를 다시 시작하세요.

Claude Desktop

Claude 설정에서 Apollo 커넥터를 추가한 후 인증하세요:

1. 설정을 열고 Apollo.io 커넥터를 연결합니다(Apollo가 원격 MCP 서버로 표시됩니다).
2. 브라우저에서 Apollo.io 인증을 완료합니다.
3. 요청된 액세스를 승인합니다.
4. 새 채팅에서 Apollo 도구를 사용할 수 있는지 확인합니다.

정확한 메뉴 레이블과 탐색 경로는 Claude Desktop 버전에 따라 다릅니다. 원격 MCP 커넥터를 추가하는 현재 단계는 Anthropic 문서를 참조하세요.

---

일반 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 전송을 지원하는 클라이언트를 사용하거나 Generic MCP Client Configuration의 일반 구성을 사용하세요.
구성의 잘못된 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 서버 스키마를 따릅니다. 게시는 공식 mcp-publisher을 다운로드하고 mcp-publisher publish을 실행하는 CI 워크플로(아래 참조)에 의해 자동화됩니다.

독립형 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)에 미러링됩니다.
• server.json을 변경하는 main에 대한 모든 푸시에서 publish-mcp.yml 워크플로가 새 버전을 공식 Model Context Protocol Registry에 게시합니다(GitHub OIDC로 인증).
• 게시 전에 server.json의 버전과 플러그인 매니페스트를 일치시켜 저장소와 레지스트리가 동기화되도록 유지하세요.
• 릴리스는 main의 server.json 변경에 의해 진행됩니다. 저장소는 버전별 GitHub 릴리스나 버전 태그를 만들지 않습니다.

---

보안

공개 GitHub 이슈를 통해 보안 취약점을 보고하지 마세요.

의심되는 취약점은 **Apollo Trust Center**를 통해 비공개로 보고하세요. 전체 공개 프로세스와 범위는 SECURITY.md을 참조하세요.

---

지원

필요 사항	문의처
Apollo 제품 지원(데이터, 크레딧, 계정, 결제)	Apollo Knowledge Base 또는 Apollo 지원팀에 문의
Apollo 제품 문서	docs.apollo.io
MCP 통합 버그(이 저장소)	apolloio/apollo-mcp-plugin에 GitHub 이슈 열기
기능 요청	apolloio/apollo-mcp-plugin에 GitHub 이슈 열기
보안 취약점	공개 이슈를 열지 마세요 — 보안 참조

---

크레딧

• MCP 서버 — Apollo.io
• 플러그인 사양 — Anthropic

---

라이선스

MIT — 자세한 내용은 LICENSE를 참조하세요. Copyright (c) 2025 Apollo.io.