Official Apollo.io MCP

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

Apollo.io MCP Server

Server Model Context Protocol resmi Apollo.io untuk alur kerja prospecting, enrichment prospek, intelijen penjualan, dan outreach.

Penyedia: Server resmi pihak pertama yang dibangun dan dikelola oleh Apollo.io.

Bawa prospecting, enrichment, dan outreach Apollo.io langsung ke aplikasi AI favorit Anda yang kompatibel dengan MCP — GitHub Copilot, Visual Studio Code, Cursor, Claude Code, Claude Desktop, dan Claude Cowork.

• Apollo.io: https://www.apollo.io/
• Model Context Protocol: https://modelcontextprotocol.io/
• Lisensi: MIT

---

Daftar Isi

• Ringkasan
• Kapabilitas Utama
• Prasyarat
• Instalasi di Visual Studio Code dan GitHub Copilot
• Instalasi di Cursor
• Instalasi di Claude Code
• Instalasi di Claude Desktop atau Claude Cowork
• Konfigurasi Klien MCP Generik
• Autentikasi dan Otorisasi
• Contoh Penggunaan
• Alat dan Kapabilitas yang Tersedia
• Rekomendasi Model
• Keamanan dan Penggunaan yang Bertanggung Jawab
• Privasi dan Penanganan Data
• Pemecahan Masalah
• Registry MCP Resmi
• Pengembangan dan Kontribusi
• Versi dan Rilis
• Keamanan
• Dukungan
• Kredit
• Lisensi

---

Ringkasan

Server MCP Apollo.io mengekspos data dan alur kerja go-to-market Apollo.io melalui Model Context Protocol, sehingga aplikasi AI yang kompatibel dengan MCP dapat melakukan prospecting orang dan perusahaan, enrichment kontak, menanyakan analitik penjualan, dan memuat prospek ke dalam urutan outreach menggunakan bahasa alami.

• Dihosting dan dikelola oleh Apollo.io. Server berjalan secara remote — tidak ada yang perlu dibangun, dihosting, atau dijalankan secara lokal.

• Transport: Streamable HTTP.

• Endpoint:

  https://mcp.apollo.io/mcp
  

• Autentikasi: Ditangani melalui OAuth Apollo.io. Anda masuk dengan akun Apollo.io dan mengotorisasi akses dari klien MCP Anda; server kemudian bertindak dengan izin Apollo.io Anda. Lihat Autentikasi dan Otorisasi.

Repositori ini juga menyertakan plugin Apollo opsional untuk Claude Code dan Cowork yang menggabungkan skill alur kerja siap pakai (perintah /apollo:*) di atas server MCP yang sama.

---

Kapabilitas Utama

Kapabilitas berikut dikonfirmasi oleh alat dan skill server di repositori ini:

• Prospecting orang — cari database orang Apollo berdasarkan jabatan, senioritas, lokasi, dan atribut perusahaan.
• Prospecting perusahaan — cari organisasi berdasarkan industri, ukuran, lokasi, dan kata kunci.
• Enrichment kontak dan akun — cocokkan dan perkaya orang serta organisasi, secara individual atau massal.
• Alur kerja urutan outreach — temukan urutan, serta tambahkan atau hapus/hentikan kontak dalam urutan.
• Analitik penjualan — kueri metrik email, panggilan, rapat, tugas, peluang, urutan, dan intelijen percakapan, lalu kembalikan rincian terformat.
• Manajemen kontak — buat kontak Apollo sebagai bagian dari alur kerja enrichment dan pemuatan urutan.

Server remote dapat mengekspos alat tambahan di luar yang digunakan oleh skill yang disertakan. Daftar di atas mencerminkan apa yang dikonfirmasi di repositori ini. Lihat Alat dan Kapabilitas yang Tersedia.

---

Prasyarat

• Akun Apollo.io. Masuk di https://www.apollo.io/.

• Izin dan kredit Apollo.io. Tindakan berjalan dengan izin akun Anda, dan beberapa tindakan mengonsumsi kredit Apollo (misalnya, enrichment). Lihat Keamanan dan Penggunaan yang Bertanggung Jawab. Untuk detail paket, kredit, dan izin, lihat dokumentasi Apollo.

• Klien yang kompatibel dengan MCP yang mendukung transport Streamable HTTP, seperti:

  • GitHub Copilot di Visual Studio Code
  • Cursor
  • Claude Code
  • Claude Desktop / Claude Cowork
  • Klien MCP lainnya (lihat Konfigurasi Klien MCP Generik)

• Tidak memerlukan runtime lokal. Server bersifat remote dan dihosting oleh Apollo.io — Anda tidak memerlukan Node.js, Docker, atau instalasi lokal untuk menggunakannya. (Plugin Claude Code / Cowork opsional menginstal skill alur kerja secara lokal melalui sistem plugin klien Anda, tetapi server MCP itu sendiri tetap remote.)

---

Instalasi di Visual Studio Code dan GitHub Copilot

Server MCP Apollo.io diterbitkan di Registry Model Context Protocol resmi, tetapi belum dapat ditemukan di Registry MCP GitHub yang dikurasi atau galeri MCP VS Code. Sampai saat itu, tambahkan secara manual dengan konfigurasi di bawah ini.

Opsi A — file konfigurasi workspace

Buat file .vscode/mcp.json di workspace Anda:

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

Opsi B — palet perintah

1. Buka Palet Perintah (Cmd/Ctrl + Shift + P).
2. Jalankan MCP: Add Server.
3. Pilih tipe server HTTP (Streamable HTTP) saat diminta.
4. Masukkan URL https://mcp.apollo.io/mcp dan beri nama server apollo.

Autentikasi dan proses pertama yang diharapkan

1. Tambahkan server MCP menggunakan salah satu opsi di atas.
2. Mulai atau aktifkan server apollo.
3. Selesaikan autentikasi Apollo.io di jendela browser yang terbuka.
4. Setujui akses yang diminta untuk workspace Apollo.io Anda.
5. Buka Copilot Chat dalam mode Agent.
6. Konfirmasi bahwa alat Apollo terdaftar dan tersedia untuk agen.

Untuk terminologi dan perilaku terkini, lihat dokumentasi VS Code tentang server MCP: https://code.visualstudio.com/docs/copilot/chat/mcp-servers.

---

Instalasi di Cursor

Tambahkan endpoint Streamable HTTP remote ke konfigurasi MCP Cursor Anda (misalnya, ~/.cursor/mcp.json, atau .cursor/mcp.json tingkat proyek):

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

Kemudian:

1. Buka pengaturan Cursor dan konfirmasi bahwa server apollo terdaftar di bawah MCP.
2. Autentikasi dengan akun Apollo.io Anda saat diminta.
3. Setujui akses yang diminta, lalu gunakan alat Apollo dari agen.

Repositori ini juga menyertakan manifes plugin Cursor (.cursor-plugin/plugin.json) yang mereferensikan endpoint remote yang sama (.mcp.json), sehingga tidak ada paket lokal yang perlu dijalankan.

---

Instalasi di Claude Code

Anda dapat menghubungkan server dengan salah satu dari dua cara.

Opsi A — tambahkan server MCP remote secara langsung

claude mcp add --transport http apollo https://mcp.apollo.io/mcp

Kemudian jalankan /mcp di dalam Claude Code, pilih apollo, dan autentikasi.

Opsi B — instal plugin Apollo (menambahkan skill alur kerja /apollo:*)

1. Tambahkan marketplace plugin ini:

   /plugin marketplace add apolloio/apollo-mcp-plugin
   

2. Instal plugin:

   /plugin install apollo@apollo-plugin-marketplace
   

3. Mulai ulang Claude Code agar server MCP berjalan dengan benar.

Plugin secara otomatis mengonfigurasi server MCP Apollo — tidak ada file konfigurasi manual. Setelah menginstal, autentikasi dengan /mcp dan jalankan perintah /apollo:* (lihat Alat dan Kapabilitas yang Tersedia).

---

Instalasi di Claude Desktop atau Claude Cowork

Claude Desktop dan Claude Cowork terpisah dari Claude Code (CLI). Gunakan langkah-langkah di bawah ini untuk klien berbasis desktop.

Cowork (satu klik)

Klik untuk menginstal dalam satu langkah:

Instal di Cowork

Kemudian mulai ulang Cowork agar server MCP berjalan dengan benar.

Claude Desktop

Tambahkan konektor Apollo dari pengaturan Claude Anda, lalu autentikasi:

1. Buka Settings dan hubungkan konektor Apollo.io (Apollo muncul sebagai server MCP remote).
2. Selesaikan autentikasi Apollo.io di browser Anda.
3. Setujui akses yang diminta.
4. Konfirmasi bahwa alat Apollo tersedia di chat baru.

Label menu dan navigasi yang tepat bervariasi tergantung versi Claude Desktop. Lihat dokumentasi Anthropic untuk langkah-langkah terkini menambahkan konektor MCP remote.

---

Konfigurasi Klien MCP Generik

Untuk klien lain yang kompatibel dengan MCP yang mendukung Streamable HTTP:

{
  "name": "apollo",
  "type": "streamable-http",
  "url": "https://mcp.apollo.io/mcp"
}

Nama properti yang tepat bervariasi antar klien. Beberapa klien menggunakan type: "http" (seperti pada contoh VS Code dan Cursor di atas) dan beberapa menggunakan type: "streamable-http". Konsultasikan dokumentasi MCP klien Anda untuk skema yang tepat.

---

Autentikasi dan Otorisasi

Server MCP Apollo menggunakan OAuth Apollo.io. Hanya perilaku yang dikonfirmasi yang didokumentasikan di sini.

• Alur masuk. Saat Anda menghubungkan server, klien Anda membuka jendela masuk dan otorisasi Apollo.io. Setelah Anda menyetujui akses, klien Anda dapat memanggil alat Apollo atas nama Anda.
• Workspace dan izin. Server bertindak dengan izin Apollo.io pengguna yang terautentikasi. Anda hanya dapat mengakses data dan melakukan tindakan yang diizinkan oleh akun Apollo.io Anda.
• Menghubungkan ulang. Di Claude Code Anda dapat menjalankan ulang /mcp, pilih apollo, dan autentikasi ulang. Di klien lain, picu ulang autentikasi dari pengaturan MCP atau konektor klien.
• Mencabut akses. Hapus atau putuskan server apollo dari klien MCP Anda untuk menghentikannya bertindak atas nama Anda. Untuk mengelola otorisasi di tingkat akun, gunakan pengaturan akun Apollo.io Anda.

Metadata server otorisasi OAuth dapat ditemukan di https://mcp.apollo.io/.well-known/oauth-authorization-server. Selain itu, README ini tidak menegaskan spesifikasi atau profil OAuth tertentu.

---

Contoh Penggunaan

Prompt bahasa alami yang dapat Anda coba setelah server terhubung:

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.

Jika Anda menginstal plugin Claude Code / Cowork, alur kerja yang sama tersedia sebagai perintah slash:

• /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

Tinjau sebelum bertindak. Untuk tindakan yang berdampak — enrichment (mengonsumsi kredit) dan menambahkan kontak ke urutan (berpotensi outbound) — tinjau target dan parameter yang tepat sebelum mengonfirmasi operasi.

---

Alat dan Kapabilitas yang Tersedia

Server remote menyediakan alat Apollo yang mendasarinya; alat yang tercantum di bawah ini adalah yang dikonfirmasi di repositori ini melalui skill alur kerja yang disertakan. Kumpulan alat lengkap dan otoritatif disediakan oleh server remote dan dapat berkembang secara independen dari dokumen ini.

Skill alur kerja (plugin Claude Code / Cowork)

Skill bernilai tinggi yang merangkai beberapa alat Apollo menjadi alur kerja lengkap:

Skill	Fungsinya
/apollo:enrich-lead	Masukkan nama, URL LinkedIn, atau email dan dapatkan kartu kontak lengkap dengan konteks perusahaan dan langkah berikutnya.
/apollo:prospect	Jelaskan ICP Anda dalam bahasa Inggris sederhana dan dapatkan tabel peringkat pengambil keputusan yang telah di-enrich.
/apollo:sequence-load	Temukan prospek, enrich, dedupe, dan tambahkan secara massal ke urutan Apollo dengan pratinjau sebelum pendaftaran.
/apollo:analytics	Ajukan pertanyaan kinerja penjualan apa pun dan dapatkan tabel terformat dari data analitik Apollo yang sebenarnya.

Alat Apollo yang mendasari yang direferensikan oleh skill

Alat	Deskripsi	Efek Data	Tindakan Outreach / Eksternal
apollo_mixed_people_api_search	Cari database orang Apollo berdasarkan jabatan, senioritas, lokasi, dan filter perusahaan.	Membaca	Tidak
apollo_mixed_companies_search	Cari database organisasi Apollo berdasarkan industri, ukuran, lokasi, dan kata kunci.	Membaca	Tidak
apollo_people_match	Mencocokkan dan memperkaya satu orang dari pengidentifikasi yang tersedia.	Membaca / memperkaya	Tidak
apollo_people_bulk_match	Mencocokkan dan memperkaya banyak orang dalam satu panggilan.	Membaca / memperkaya	Tidak
apollo_organizations_enrich	Memperkaya satu organisasi.	Membaca / memperkaya	Tidak
apollo_organizations_bulk_enrich	Memperkaya banyak organisasi dalam satu panggilan.	Membaca / memperkaya	Tidak
apollo_contacts_create	Membuat kontak di ruang kerja Apollo.	Mengubah data Apollo	Tidak
apollo_emailer_campaigns_search	Mencari urutan outreach berdasarkan nama.	Membaca	Tidak
apollo_emailer_campaigns_add_contact_ids	Menambahkan kontak ke urutan outreach.	Mengubah data Apollo	Ya — dapat memulai outbound tergantung pada pengaturan urutan.
apollo_emailer_campaigns_remove_or_stop_contact_ids	Menghapus atau menghentikan kontak dalam urutan outreach.	Mengubah data Apollo	Mempengaruhi outreach yang aktif
apollo_email_accounts_index	Menampilkan akun email/akun pengiriman yang terhubung.	Membaca	Tidak
apollo_analytics_sync_report	Mengambil metrik dan rincian analitik penjualan.	Membaca	Tidak

Beberapa tindakan (seperti enrichment) mengonsumsi kredit Apollo. Untuk biaya kredit per alat dan referensi alat yang otoritatif dan terkini, lihat dokumentasi Apollo.

---

Rekomendasi Model

Untuk klien tempat Anda dapat memilih model (misalnya, Claude Code melalui /model):

• Opus (kualitas terbaik) — penalaran terkuat dan orkestrasi alat multi-langkah yang paling andal. Terbaik untuk alur kerja prospecting, pencocokan ambigu, rantai multi-langkah, dan tugas berisiko tinggi. Tradeoff: latensi dan biaya penggunaan lebih tinggi.
• Sonnet (lebih cepat) — baik untuk pencarian cepat, enrichment ringan, dan iterasi cepat. Tradeoff: mungkin memerlukan lebih banyak panduan pada alur kerja multi-langkah yang kompleks.

---

Keamanan dan Penggunaan yang Bertanggung Jawab

• Tinjau hasil prospecting sebelum menggunakannya atau mengekspornya.
• Patuhi hukum privasi, pemasaran, anti-spam, dan perlindungan data yang berlaku di yurisdiksi Anda dan yurisdiksi penerima Anda.
• Konfirmasikan penerima sebelum menambahkan siapa pun ke urutan outreach. Tergantung pada urutan dan konfigurasi pengiriman Anda, pendaftaran dapat memulai outbound secara otomatis. Selalu verifikasi nama urutan, akun pengiriman, dan volume pendaftaran sebelum mengonfirmasi.
• Waspadai konsumsi kredit Apollo. Beberapa tindakan (seperti enrichment) mengonsumsi kredit Apollo, dan tindakan massal berskala sesuai volume. Keterampilan repositori ini dirancang untuk memperingatkan dan meminta konfirmasi sebelum tindakan yang mengonsumsi kredit. Untuk biaya kredit, lihat dokumentasi Apollo.
• Hindari tindakan massal atau destruktif tanpa meninjau cakupan persisnya terlebih dahulu.
• Hormati izin akun Apollo dan kebijakan organisasi Anda.

Bagian ini adalah panduan, bukan nasihat hukum.

---

Privasi dan Penanganan Data

• Permintaan dikirim ke endpoint MCP yang dihosting Apollo (https://mcp.apollo.io/mcp).
• Server berinteraksi dengan data Apollo di bawah akun dan izin terautentikasi Anda.
• Hindari mengirim informasi sensitif yang tidak perlu dalam prompt.

Untuk sumber daya privasi dan keamanan resmi Apollo.io:

• Kebijakan Privasi: https://www.apollo.io/privacy-policy
• Pusat Privasi: https://www.apollo.io/company/privacy-center
• Keamanan: https://www.apollo.io/product/security
• Pusat Kepercayaan: https://trust.apollo.io/

---

Pemecahan Masalah

Gejala	Yang perlu diperiksa
Jendela autentikasi tidak terbuka	Pastikan pop-up diizinkan; picu ulang autentikasi dari pengaturan MCP/konektor klien Anda.
Sesi autentikasi kedaluwarsa	Autentikasi ulang (di Claude Code, jalankan /mcp → apollo → authenticate).
Server tidak berjalan	Mulai ulang klien setelah menambahkan/menginstal; pastikan URL endpoint persis https://mcp.apollo.io/mcp.
Alat tidak muncul	Pastikan server diaktifkan dan terautentikasi, dan (untuk Copilot) bahwa chat berada dalam mode Agent.
"Permission denied" pada suatu tindakan	Akun Apollo.io Anda mungkin tidak memiliki izin yang diperlukan untuk tindakan tersebut.
Kredit tidak tersedia	Enrichment dan beberapa tindakan memerlukan kredit Apollo; pastikan ruang kerja Anda memiliki kredit yang tersedia.
Klien tidak mendukung Streamable HTTP	Gunakan klien yang mendukung transport Streamable HTTP, atau konfigurasi generik di Konfigurasi Klien MCP Generik.
JSON tidak valid dalam konfigurasi	Validasi konfigurasi mcp.json / klien Anda dengan linter JSON — koma di akhir atau kurung kurawal yang hilang akan mencegah server dimuat.
Proxy perusahaan atau firewall memblokir endpoint	Pastikan https://mcp.apollo.io dapat dijangkau melalui daftar izin jaringan/proxy Anda.

---

Registry MCP Resmi

Server ini diterbitkan dan aktif di Model Context Protocol Registry resmi.

Bidang	Nilai
Nama registry	io.github.apolloio/apollo-mcp
Versi	0.1.1
Transport	Streamable HTTP
Endpoint	https://mcp.apollo.io/mcp

Publikasi di Model Context Protocol Registry resmi terpisah dari GitHub MCP Registry yang dikurasi dan galeri MCP VS Code. Aktif di registry resmi tidak secara otomatis membuat server dapat ditemukan di katalog kurasi tersebut.

---

Pengembangan dan Kontribusi

Repositori ini berisi konfigurasi klien MCP Apollo, manifes plugin Claude/Cursor, keterampilan alur kerja, dan metadata registry. Server MCP itu sendiri dihosting oleh Apollo.io.

Tata letak repositori:

Jalur	Tujuan
.mcp.json	Definisi server MCP jarak jauh (apollo → https://mcp.apollo.io/mcp).
server.json	Metadata Registry MCP resmi (nama, versi, transport, endpoint).
.claude-plugin/	Manifes plugin dan marketplace Claude Code / Cowork.
.cursor-plugin/	Manifes plugin Cursor.
glama.json	Metadata direktori MCP Glama.
skills/	Keterampilan alur kerja: prospect, enrich-lead, sequence-load, analytics.
.github/workflows/publish-mcp.yml	CI yang menerbitkan server.json ke Registry MCP.

Memvalidasi server.json

server.json mengikuti skema server MCP yang direferensikan di bagian atas file. Publikasi diotomatiskan oleh alur kerja CI (lihat di bawah), yang mengunduh mcp-publisher resmi dan menjalankan mcp-publisher publish.

Tidak ada perintah validate yang berdiri sendiri. Untuk memeriksa server.json secara lokal sebelum push, jalankan dry-run publish dengan CLI resmi:

mcp-publisher publish --dry-run

Kontribusi diterima melalui pull request. Harap jaga metadata versi tetap konsisten di seluruh server.json, .claude-plugin/plugin.json, dan .cursor-plugin/plugin.json.

---

Versioning dan Rilis

• Versi server dideklarasikan di server.json (version: 0.1.1) dan dicerminkan di manifes plugin (.claude-plugin/plugin.json, .cursor-plugin/plugin.json).
• Pada setiap push ke main yang mengubah server.json, alur kerja publish-mcp.yml menerbitkan versi baru ke Model Context Protocol Registry resmi (mengautentikasi melalui GitHub OIDC).
• Jaga versi di server.json dan manifes plugin tetap selaras sebelum menerbitkan, sehingga repositori dan registry tetap sinkron.
• Rilis didorong oleh perubahan server.json di main — repositori tidak membuat GitHub Releases atau tag versi per versi.

---

Keamanan

Mohon jangan laporkan kerentanan keamanan melalui isu GitHub publik.

Laporkan kerentanan yang diduga secara pribadi melalui Apollo Trust Center. Lihat SECURITY.md untuk proses pengungkapan penuh dan cakupannya.

---

Dukungan

Kebutuhan	Ke mana harus pergi
Dukungan produk Apollo (data, kredit, akun, penagihan)	Apollo Knowledge Base atau hubungi Dukungan Apollo
Dokumentasi produk Apollo	docs.apollo.io
Bug integrasi MCP (repositori ini)	Buka isu GitHub di apolloio/apollo-mcp-plugin
Permintaan fitur	Buka isu GitHub di apolloio/apollo-mcp-plugin
Kerentanan keamanan	Jangan buka isu publik — lihat Keamanan

---

Kredit

• MCP Server oleh Apollo.io
• Spesifikasi plugin oleh Anthropic

---

Lisensi

MIT — lihat LICENSE untuk detail. Hak cipta (c) 2025 Apollo.io.