Official Apollo.io MCP
officielTrouvez des acheteurs et réservez plus de réunions sans votre assistant IA.
Que pouvez-vous faire avec Official Apollo Io MCP ?
- Prospect pour des personnes — Demandez à votre assistant de trouver des décideurs à l’aide de
apollo_mixed_people_api_searchavec des filtres comme le titre, l’ancienneté, la localisation et les attributs de l’entreprise. - Enrichir les contacts et les entreprises — Utilisez
apollo_people_matchouapollo_organizations_enrichpour obtenir les titres actuels, les entreprises et les e-mails professionnels vérifiés à partir d’URL LinkedIn ou d’adresses e-mail. - Charger des prospects dans des séquences — Demandez à votre assistant de trouver et d’ajouter en masse des contacts à une séquence de prospection via
apollo_emailer_campaigns_add_contact_ids, avec un aperçu avant l’inscription. - Interroger les analyses de vente — Demandez des répartitions formatées des performances des e-mails, des appels, des réunions ou des séquences à l’aide de
apollo_analytics_sync_report, comme « Afficher le taux de connexion des appels par commercial ce trimestre. » - Gérer les séquences de prospection — Supprimez ou arrêtez des contacts dans des séquences actives avec
apollo_emailer_campaigns_remove_or_stop_contact_idspour contrôler la prospection en cours.
Serveur MCP hébergé
npx add-mcp 'https://mcp.apollo.io/mcp'S’installe dans Claude Code, Codex, Cursor et plus
Documentation
Serveur MCP Apollo.io
Le serveur officiel Model Context Protocol d'Apollo.io pour la prospection, l'enrichissement de leads, l'intelligence commerciale et les flux de travail de sensibilisation.
Fournisseur : Serveur officiel propriétaire, construit et maintenu par Apollo.io.
Intégrez la prospection, l'enrichissement et la sensibilisation d'Apollo.io directement dans votre application IA compatible MCP préférée — GitHub Copilot, Visual Studio Code, Cursor, Claude Code, Claude Desktop et Claude Cowork.
- Apollo.io : https://www.apollo.io/
- Model Context Protocol : https://modelcontextprotocol.io/
- Licence : MIT
Table des matières
- Vue d'ensemble
- Capacités clés
- Prérequis
- Installation dans Visual Studio Code et GitHub Copilot
- Installation dans Cursor
- Installation dans Claude Code
- Installation dans Claude Desktop ou Claude Cowork
- Configuration générique du client MCP
- Authentification et autorisation
- Exemples d'utilisation
- Outils et capacités disponibles
- Recommandations de modèles
- Sécurité et utilisation responsable
- Confidentialité et traitement des données
- Dépannage
- Registre MCP officiel
- Développement et contribution
- Versioning et versions
- Sécurité
- Support
- Crédits
- Licence
Vue d'ensemble
Le serveur MCP Apollo.io expose les données et flux de travail go-to-market d'Apollo.io via le Model Context Protocol, afin que les applications IA compatibles MCP puissent prospecter des personnes et des entreprises, enrichir des contacts, interroger des analyses commerciales et charger des leads dans des séquences de sensibilisation en langage naturel.
-
Hébergé et maintenu par Apollo.io. Le serveur s'exécute à distance — rien à construire, héberger ou exécuter localement.
-
Transport : HTTP streamable.
-
Point de terminaison :
https://mcp.apollo.io/mcp -
Authentification : Gérée via OAuth Apollo.io. Vous vous connectez avec votre compte Apollo.io et autorisez l'accès depuis votre client MCP ; le serveur agit ensuite avec vos permissions Apollo.io. Voir Authentification et autorisation.
Ce dépôt inclut également un plugin Apollo optionnel pour Claude Code et Cowork qui regroupe des compétences de flux de travail prêtes à l'emploi (commandes /apollo:*) par-dessus le même serveur MCP.
Capacités clés
Les capacités suivantes sont confirmées par les outils et compétences du serveur dans ce dépôt :
- Prospection de personnes — recherchez la base de données de personnes d'Apollo par titre, ancienneté, localisation et attributs d'entreprise.
- Prospection d'entreprises — recherchez des organisations par secteur, taille, localisation et mots-clés.
- Enrichissement de contacts et de comptes — faites correspondre et enrichissez des personnes et des organisations, individuellement ou en masse.
- Flux de travail de séquences de sensibilisation — trouvez des séquences, et ajoutez ou retirez/arrêtez des contacts dans une séquence.
- Analyses commerciales — interrogez les métriques d'e-mails, d'appels, de réunions, de tâches, d'opportunités, de séquences et d'intelligence de conversation, et obtenez des ventilations formatées.
- Gestion des contacts — créez des contacts Apollo dans le cadre des flux de travail d'enrichissement et de chargement de séquences.
Le serveur distant peut exposer des outils supplémentaires au-delà de ceux exercés par les compétences incluses. La liste ci-dessus reflète ce qui est confirmé dans ce dépôt. Voir Outils et capacités disponibles.
Prérequis
-
Un compte Apollo.io. Connectez-vous sur https://www.apollo.io/.
-
Permissions et crédits Apollo.io. Les actions s'exécutent avec les permissions de votre compte, et certaines actions consomment des crédits Apollo (par exemple, l'enrichissement). Voir Sécurité et utilisation responsable. Pour les détails sur les forfaits, crédits et permissions, consultez la documentation Apollo.
-
Un client compatible MCP prenant en charge le transport HTTP streamable, tel que :
- GitHub Copilot dans Visual Studio Code
- Cursor
- Claude Code
- Claude Desktop / Claude Cowork
- Autres clients MCP (voir Configuration générique du client MCP)
-
Aucun environnement d'exécution local requis. Le serveur est distant et hébergé par Apollo.io — vous n'avez pas besoin de Node.js, Docker ou d'une installation locale pour l'utiliser. (Le plugin optionnel Claude Code / Cowork installe des compétences de flux de travail localement via le système de plugins de votre client, mais le serveur MCP lui-même reste distant.)
Installation dans Visual Studio Code et GitHub Copilot
Le serveur MCP Apollo.io est publié dans le registre officiel Model Context Protocol, mais il n'est pas encore découvrable dans le registre MCP GitHub organisé ni dans la galerie MCP de VS Code. En attendant, ajoutez-le manuellement avec la configuration ci-dessous.
Option A — fichier de configuration d'espace de travail
Créez un fichier .vscode/mcp.json dans votre espace de travail :
{
"servers": {
"apollo": {
"type": "http",
"url": "https://mcp.apollo.io/mcp"
}
}
}
Option B — palette de commandes
- Ouvrez la palette de commandes (
Cmd/Ctrl + Shift + P). - Exécutez MCP : Ajouter un serveur.
- Choisissez le type de serveur HTTP (HTTP streamable) lorsque vous y êtes invité.
- Saisissez l'URL
https://mcp.apollo.io/mcpet nommez le serveurapollo.
Authentification et première exécution attendues
- Ajoutez le serveur MCP en utilisant l'une ou l'autre option ci-dessus.
- Démarrez ou activez le serveur
apollo. - Terminez l'authentification Apollo.io dans la fenêtre du navigateur qui s'ouvre.
- Approuvez l'accès demandé pour votre espace de travail Apollo.io.
- Ouvrez Copilot Chat en mode Agent.
- Confirmez que les outils Apollo sont répertoriés et disponibles pour l'agent.
Pour la terminologie et le comportement actuels, consultez la documentation VS Code sur les serveurs MCP : https://code.visualstudio.com/docs/copilot/chat/mcp-servers.
Installation dans Cursor
Ajoutez le point de terminaison HTTP streamable distant à votre configuration MCP Cursor (par exemple, ~/.cursor/mcp.json, ou le fichier .cursor/mcp.json au niveau du projet) :
{
"mcpServers": {
"apollo": {
"type": "http",
"url": "https://mcp.apollo.io/mcp"
}
}
}
Ensuite :
- Ouvrez les paramètres de Cursor et confirmez que le serveur
apolloest répertorié sous MCP. - Authentifiez-vous avec votre compte Apollo.io lorsque vous y êtes invité.
- Approuvez l'accès demandé, puis utilisez les outils Apollo depuis l'agent.
Ce dépôt inclut également un manifeste de plugin Cursor (
.cursor-plugin/plugin.json) qui référence le même point de terminaison distant (.mcp.json), donc aucun package local n'a besoin de s'exécuter.
Installation dans Claude Code
Vous pouvez connecter le serveur de deux manières.
Option A — ajouter le serveur MCP distant directement
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
Exécutez ensuite /mcp dans Claude Code, sélectionnez apollo et authentifiez-vous.
Option B — installer le plugin Apollo (ajoute les compétences de flux de travail /apollo:*)
-
Ajoutez la place de marché de ce plugin :
/plugin marketplace add apolloio/apollo-mcp-plugin -
Installez le plugin :
/plugin install apollo@apollo-plugin-marketplace -
Redémarrez Claude Code pour que le serveur MCP démarre correctement.
Le plugin configure automatiquement le serveur MCP Apollo — aucun fichier de configuration manuel requis. Après l'installation, authentifiez-vous avec /mcp et exécutez les commandes /apollo:* (voir Outils et capacités disponibles).
Installation dans Claude Desktop ou Claude Cowork
Claude Desktop et Claude Cowork sont distincts de Claude Code (l'interface en ligne de commande). Utilisez les étapes ci-dessous pour les clients de bureau.
Cowork (en un clic)
Cliquez pour installer en une seule étape :
Redémarrez ensuite Cowork pour que le serveur MCP démarre correctement.
Claude Desktop
Ajoutez le connecteur Apollo depuis vos paramètres Claude, puis authentifiez-vous :
- Ouvrez Paramètres et connectez le connecteur Apollo.io (Apollo apparaît comme un serveur MCP distant).
- Terminez l'authentification Apollo.io dans votre navigateur.
- Approuvez l'accès demandé.
- Confirmez que les outils Apollo sont disponibles dans une nouvelle conversation.
Les libellés de menu et la navigation exacts varient selon la version de Claude Desktop. Consultez la documentation d'Anthropic pour connaître les étapes actuelles d'ajout d'un connecteur MCP distant.
Configuration générique du client MCP
Pour tout autre client compatible MCP prenant en charge HTTP streamable :
{
"name": "apollo",
"type": "streamable-http",
"url": "https://mcp.apollo.io/mcp"
}
Les noms de propriétés exacts varient selon les clients. Certains clients utilisent
type: "http"(comme dans les exemples VS Code et Cursor ci-dessus) et d'autres utilisenttype: "streamable-http". Consultez la documentation MCP de votre client pour le schéma précis.
Authentification et autorisation
Le serveur MCP Apollo utilise OAuth Apollo.io. Seul le comportement confirmé est documenté ici.
- Flux de connexion. Lorsque vous connectez le serveur, votre client ouvre une fenêtre de connexion et d'autorisation Apollo.io. Après avoir approuvé l'accès, votre client peut appeler les outils Apollo en votre nom.
- Espace de travail et permissions. Le serveur agit avec les permissions Apollo.io de l'utilisateur authentifié. Vous ne pouvez accéder qu'aux données et effectuer que les actions autorisées par votre compte Apollo.io.
- Reconnexion. Dans Claude Code, vous pouvez réexécuter
/mcp, sélectionner apollo et vous réauthentifier. Dans d'autres clients, redéclenchez l'authentification depuis les paramètres MCP ou de connecteur du client. - Révocation de l'accès. Supprimez ou déconnectez le serveur
apollode votre client MCP pour l'empêcher d'agir en votre nom. Pour gérer les autorisations au niveau du compte, utilisez les paramètres de votre compte Apollo.io.
Les métadonnées du serveur d'autorisation OAuth sont découvrables sur
https://mcp.apollo.io/.well-known/oauth-authorization-server. Au-delà de cela, ce README n'affirme aucune spécification ou profil OAuth spécifique.
Exemples d'utilisation
Invites en langage naturel que vous pouvez essayer une fois le serveur connecté :
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.
Si vous avez installé le plugin Claude Code / Cowork, les mêmes flux de travail sont disponibles sous forme de commandes 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
Vérifiez avant d'agir. Pour les actions importantes — enrichissement (consommation de crédits) et ajout de contacts à une séquence (potentiellement sortante) — vérifiez les cibles et paramètres exacts avant de confirmer l'opération.
Outils et capacités disponibles
Le serveur distant fournit les outils Apollo sous-jacents ; les outils répertoriés ci-dessous sont ceux confirmés dans ce dépôt via les compétences de flux de travail incluses. L'ensemble complet et faisant autorité des outils est fourni par le serveur distant et peut évoluer indépendamment de ce document.
Compétences de flux de travail (plugin Claude Code / Cowork)
Compétences à forte valeur ajoutée qui enchaînent plusieurs outils Apollo en flux de travail complets :
| Compétence | Ce qu'elle fait |
|---|---|
/apollo:enrich-lead | Saisissez un nom, une URL LinkedIn ou un e-mail et obtenez une fiche contact complète avec le contexte de l'entreprise et les actions suivantes. |
/apollo:prospect | Décrivez votre ICP en anglais simple et obtenez un tableau classé de décideurs enrichis. |
/apollo:sequence-load | Trouvez des leads, enrichissez-les, dédupliquez-les et ajoutez-les en masse à une séquence Apollo avec un aperçu avant l'inscription. |
/apollo:analytics | Posez n'importe quelle question sur les performances commerciales et obtenez des tableaux formatés à partir de données analytiques Apollo réelles. |
Outils Apollo sous-jacents référencés par les compétences
| Outil | Description | Effet sur les données | Action externe / de prospection |
|---|---|---|---|
apollo_mixed_people_api_search | Recherche dans la base de données de personnes d'Apollo par titre, niveau hiérarchique, localisation et filtres d'entreprise. | Lecture | Non |
apollo_mixed_companies_search | Recherche dans la base de données d'organisations d'Apollo par secteur, taille, localisation et mots-clés. | Lecture | Non |
apollo_people_match | Correspondance et enrichissement d'une seule personne à partir des identifiants disponibles. | Lecture / enrichissement | Non |
apollo_people_bulk_match | Correspondance et enrichissement de plusieurs personnes en un seul appel. | Lecture / enrichissement | Non |
apollo_organizations_enrich | Enrichissement d'une seule organisation. | Lecture / enrichissement | Non |
apollo_organizations_bulk_enrich | Enrichissement de plusieurs organisations en un seul appel. | Lecture / enrichissement | Non |
apollo_contacts_create | Création d'un contact dans l'espace de travail Apollo. | Modifie les données Apollo | Non |
apollo_emailer_campaigns_search | Recherche de séquences de prospection par nom. | Lecture | Non |
apollo_emailer_campaigns_add_contact_ids | Ajout de contacts à une séquence de prospection. | Modifie les données Apollo | Oui — peut lancer des actions sortantes selon les paramètres de la séquence. |
apollo_emailer_campaigns_remove_or_stop_contact_ids | Retrait ou arrêt de contacts dans une séquence de prospection. | Modifie les données Apollo | Affecte la prospection active |
apollo_email_accounts_index | Liste des comptes d'envoi / e-mail connectés. | Lecture | Non |
apollo_analytics_sync_report | Récupération des indicateurs et ventilations d'analytique commerciale. | Lecture | Non |
Certaines actions (comme l'enrichissement) consomment des crédits Apollo. Pour les coûts en crédits par outil et la référence d'outils faisant autorité et à jour, consultez la documentation Apollo.
Recommandations de modèles
Pour les clients où vous pouvez choisir un modèle (par exemple, Claude Code via /model) :
- Opus (meilleure qualité) — raisonnement le plus fort et orchestration multi-outils la plus fiable. Idéal pour les flux de prospection, les correspondances ambiguës, l'enchaînement multi-étapes et les tâches à fort enjeu. Compromis : latence et coût d'utilisation plus élevés.
- Sonnet (plus rapide) — adapté aux recherches rapides, à l'enrichissement léger et à l'itération rapide. Compromis : peut nécessiter plus de guidage sur les flux multi-étapes complexes.
Sécurité et utilisation responsable
- Examinez les résultats de prospection avant de les utiliser ou de les exporter.
- Respectez les lois applicables en matière de confidentialité, de marketing, d'anti-spam et de protection des données dans votre juridiction et celle de vos destinataires.
- Confirmez les destinataires avant d'ajouter quiconque à une séquence de prospection. Selon votre séquence et votre configuration d'envoi, l'inscription peut lancer automatiquement des actions sortantes. Vérifiez toujours le nom de la séquence, le compte d'envoi et le volume d'inscription avant de confirmer.
- Soyez conscient de la consommation de crédits Apollo. Certaines actions (comme l'enrichissement) consomment des crédits Apollo, et les actions groupées augmentent avec le volume. Les compétences de ce dépôt sont conçues pour avertir et demander confirmation avant les actions consommant des crédits. Pour les coûts en crédits, consultez la documentation Apollo.
- Évitez les actions groupées ou destructrices sans avoir d'abord examiné leur portée exacte.
- Respectez les autorisations du compte Apollo et les politiques de votre organisation.
Cette section est un guide, pas un avis juridique.
Confidentialité et traitement des données
- Les requêtes sont envoyées au point de terminaison MCP hébergé par Apollo (
https://mcp.apollo.io/mcp). - Le serveur interagit avec les données Apollo sous votre compte authentifié et vos autorisations.
- Évitez d'envoyer des informations sensibles inutiles dans les invites.
Pour les ressources officielles de confidentialité et de sécurité d'Apollo.io :
- Politique de confidentialité : https://www.apollo.io/privacy-policy
- Centre de confidentialité : https://www.apollo.io/company/privacy-center
- Sécurité : https://www.apollo.io/product/security
- Centre de confiance : https://trust.apollo.io/
Dépannage
| Symptôme | Élément à vérifier |
|---|---|
| La fenêtre d'authentification ne s'ouvre pas | Vérifiez que les fenêtres contextuelles sont autorisées ; relancez l'authentification depuis les paramètres MCP/connecteur de votre client. |
| Session d'authentification expirée | Réauthentifiez-vous (dans Claude Code, exécutez /mcp → apollo → authenticate). |
| Le serveur ne démarre pas | Redémarrez le client après l'ajout/l'installation ; confirmez que l'URL du point de terminaison est exactement https://mcp.apollo.io/mcp. |
| Les outils n'apparaissent pas | Confirmez que le serveur est activé et authentifié, et (pour Copilot) que le chat est en mode Agent. |
| « Permission refusée » sur une action | Votre compte Apollo.io peut ne pas disposer de l'autorisation requise pour cette action. |
| Crédits indisponibles | L'enrichissement et certaines actions nécessitent des crédits Apollo ; confirmez que votre espace de travail dispose de crédits disponibles. |
| Le client ne prend pas en charge Streamable HTTP | Utilisez un client prenant en charge le transport Streamable HTTP, ou la configuration générique dans Generic MCP Client Configuration. |
| JSON invalide dans la configuration | Validez votre configuration mcp.json / client avec un linter JSON — une virgule finale ou une accolade manquante empêchera le chargement du serveur. |
| Le proxy d'entreprise ou le pare-feu bloque le point de terminaison | Assurez-vous que https://mcp.apollo.io est accessible via la liste blanche de votre réseau/proxy. |
Registre MCP officiel
Ce serveur est publié et actif dans le Model Context Protocol Registry officiel.
| Champ | Valeur |
|---|---|
| Nom du registre | io.github.apolloio/apollo-mcp |
| Version | 0.1.1 |
| Transport | Streamable HTTP |
| Point de terminaison | https://mcp.apollo.io/mcp |
La publication dans le Model Context Protocol Registry officiel est distincte du registre MCP GitHub organisé et de la galerie MCP de VS Code. Le fait d'être actif dans le registre officiel ne rend pas automatiquement le serveur découvrable dans ces catalogues organisés.
Développement et contribution
Ce dépôt contient la configuration client MCP d'Apollo, les manifestes de plugins Claude/Cursor, les compétences de flux de travail et les métadonnées du registre. Le serveur MCP lui-même est hébergé par Apollo.io.
Structure du dépôt :
| Chemin | Objectif |
|---|---|
.mcp.json | Définition du serveur MCP distant (apollo → https://mcp.apollo.io/mcp). |
server.json | Métadonnées du registre MCP officiel (nom, version, transport, point de terminaison). |
.claude-plugin/ | Manifestes de plugin et de marketplace Claude Code / Cowork. |
.cursor-plugin/ | Manifeste de plugin Cursor. |
glama.json | Métadonnées du répertoire MCP Glama. |
skills/ | Compétences de flux de travail : prospect, enrich-lead, sequence-load, analytics. |
.github/workflows/publish-mcp.yml | CI qui publie server.json dans le registre MCP. |
Validation de server.json
server.json suit le schéma de serveur MCP référencé en haut du fichier. La publication est automatisée par le flux CI (voir ci-dessous), qui télécharge le mcp-publisher officiel et exécute mcp-publisher publish.
Il n'existe pas de commande validate autonome. Pour vérifier server.json localement avant de pousser, exécutez une publication d'essai (dry-run) avec la CLI officielle :
mcp-publisher publish --dry-run
Les contributions sont les bienvenues via des demandes de tirage (pull requests). Veuillez maintenir la cohérence des métadonnées de version entre server.json, .claude-plugin/plugin.json et .cursor-plugin/plugin.json.
Versions et publications
- La version du serveur est déclarée dans
server.json(version: 0.1.1) et reflétée dans les manifestes de plugins (.claude-plugin/plugin.json,.cursor-plugin/plugin.json). - À chaque poussée vers
mainqui modifieserver.json, le fluxpublish-mcp.ymlpublie la nouvelle version dans le Model Context Protocol Registry officiel (authentification via GitHub OIDC). - Gardez la version dans
server.jsonet les manifestes de plugins alignés avant de publier, afin que le dépôt et le registre restent synchronisés. - Les publications sont pilotées par les modifications de
server.jsonsurmain— le dépôt ne crée pas de versions GitHub Releases ni d'étiquettes de version par version.
Sécurité
Veuillez ne pas signaler les vulnérabilités de sécurité via les problèmes GitHub publics.
Signalez les vulnérabilités suspectées de manière privée via le Apollo Trust Center. Consultez SECURITY.md pour le processus de divulgation complet et le périmètre.
Support
| Besoin | Où aller |
|---|---|
| Support produit Apollo (données, crédits, compte, facturation) | Apollo Knowledge Base ou contactez le support Apollo |
| Documentation produit Apollo | docs.apollo.io |
| Bugs d'intégration MCP (ce dépôt) | Ouvrez un problème GitHub sur apolloio/apollo-mcp-plugin |
| Demandes de fonctionnalités | Ouvrez un problème GitHub sur apolloio/apollo-mcp-plugin |
| Vulnérabilités de sécurité | N'ouvrez pas de problème public — voir Sécurité |
Crédits
Licence
MIT — voir LICENSE pour les détails. Copyright (c) 2025 Apollo.io.