Official Apollo.io MCP

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

Apollo.io MCP Server

Официальный сервер Apollo.io Model Context Protocol для поиска потенциальных клиентов, обогащения лидов, аналитики продаж и рабочих процессов аутрича.

Провайдер: Официальный сервер первой стороны, созданный и поддерживаемый Apollo.io.

Интегрируйте поиск потенциальных клиентов, обогащение и аутрич Apollo.io непосредственно в ваше любимое MCP-совместимое ИИ-приложение — 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 предоставляет доступ к данным и рабочим процессам go-to-market Apollo.io через Model Context Protocol, чтобы MCP-совместимые ИИ-приложения могли искать потенциальных клиентов и компании, обогащать контакты, запрашивать аналитику продаж и загружать лидов в последовательности аутрича с помощью естественного языка.

• Размещается и поддерживается Apollo.io. Сервер работает удаленно — вам не нужно ничего собирать, размещать или запускать локально.

• Транспорт: Streamable HTTP.

• Конечная точка:

  https://mcp.apollo.io/mcp
  

• Аутентификация: Обрабатывается через Apollo.io OAuth. Вы входите в свою учетную запись Apollo.io и авторизуете доступ из вашего MCP-клиента; сервер затем действует с вашими разрешениями Apollo.io. См. Аутентификация и авторизация.

Этот репозиторий также включает опциональный плагин Apollo для Claude Code и Cowork, который добавляет готовые навыки рабочих процессов (команды /apollo:*) поверх того же MCP-сервера.

---

Ключевые возможности

Следующие возможности подтверждены инструментами сервера и навыками в этом репозитории:

• Поиск людей — поиск по базе людей Apollo по должности, уровню старшинства, местоположению и атрибутам компании.
• Поиск компаний — поиск организаций по отрасли, размеру, местоположению и ключевым словам.
• Обогащение контактов и аккаунтов — сопоставление и обогащение людей и организаций, по отдельности или пакетно.
• Рабочие процессы последовательностей аутрича — поиск последовательностей, добавление и удаление/остановка контактов в последовательности.
• Аналитика продаж — запрос метрик по электронной почте, звонкам, встречам, задачам, возможностям, последовательностям и аналитике разговоров с возвратом форматированных сводок.
• Управление контактами — создание контактов Apollo в рамках рабочих процессов обогащения и загрузки в последовательности.

Удаленный сервер может предоставлять дополнительные инструменты помимо тех, что используются встроенными навыками. Список выше отражает то, что подтверждено в этом репозитории. См. Доступные инструменты и возможности.

---

Предварительные требования

• Учетная запись Apollo.io. Войдите на https://www.apollo.io/.

• Разрешения и кредиты Apollo.io. Действия выполняются с разрешениями вашей учетной записи, и некоторые действия расходуют кредиты Apollo (например, обогащение). См. Безопасность и ответственное использование. Подробнее о тарифах, кредитах и разрешениях см. в документации Apollo.

• MCP-совместимый клиент, поддерживающий транспорт Streamable HTTP, например:

  • GitHub Copilot в Visual Studio Code
  • 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 или галерее MCP VS Code. До этого момента добавьте его вручную с помощью конфигурации ниже.

Вариант 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 перечислены и доступны агенту.

Актуальную терминологию и поведение см. в документации VS Code по MCP-серверам: https://code.visualstudio.com/docs/copilot/chat/mcp-servers.

---

Установка в Cursor

Добавьте удаленную конечную точку Streamable HTTP в конфигурацию MCP вашего Cursor (например, ~/.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 из агента.

Этот репозиторий также включает манифест плагина Cursor (.cursor-plugin/plugin.json), который ссылается на ту же удаленную конечную точку (.mcp.json), поэтому локальный пакет запускать не нужно.

---

Установка в Claude Code

Вы можете подключить сервер одним из двух способов.

Вариант A — добавьте удаленный MCP-сервер напрямую

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

Затем выполните /mcp внутри Claude Code, выберите apollo и пройдите аутентификацию.

Вариант B — установите плагин Apollo (добавляет навыки рабочих процессов /apollo:*)

1. Добавьте маркетплейс этого плагина:

   /plugin marketplace add apolloio/apollo-mcp-plugin
   

2. Установите плагин:

   /plugin install apollo@apollo-plugin-marketplace
   

3. Перезапустите Claude Code, чтобы MCP-сервер запустился корректно.

Плагин автоматически настраивает Apollo MCP-сервер — ручные файлы конфигурации не нужны. После установки пройдите аутентификацию с помощью /mcp и выполняйте команды /apollo:* (см. Доступные инструменты и возможности).

---

Установка в Claude Desktop или Claude Cowork

Claude Desktop и Claude Cowork — отдельные от Claude Code (CLI) продукты. Используйте шаги ниже для настольных клиентов.

Cowork (в один клик)

Установите в один шаг:

Установить в Cowork

Затем перезапустите Cowork, чтобы MCP-сервер запустился корректно.

Claude Desktop

Добавьте коннектор Apollo из настроек Claude, затем пройдите аутентификацию:

1. Откройте Настройки и подключите коннектор Apollo.io (Apollo отображается как удаленный MCP-сервер).
2. Завершите аутентификацию Apollo.io в вашем браузере.
3. Одобрите запрошенный доступ.
4. Убедитесь, что инструменты Apollo доступны в новом чате.

Точные названия пунктов меню и навигация зависят от версии Claude Desktop. Актуальные шаги по добавлению удаленного MCP-коннектора см. в документации Anthropic.

---

Конфигурация универсального MCP-клиента

Для любого другого MCP-совместимого клиента, поддерживающего Streamable HTTP:

{
  "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 или коннектора клиента.
• Отзыв доступа. Удалите или отключите сервер 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	Введите имя, URL LinkedIn или email и получите полную карточку контакта с контекстом компании и следующими действиями.
/apollo:prospect	Опишите ваш ICP простым языком и получите ранжированную таблицу обогащенных лиц, принимающих решения.
/apollo:sequence-load	Найдите лидов, обогатите их, удалите дубликаты и массово добавьте в последовательность Apollo с предпросмотром перед зачислением.
/apollo:analytics	Задайте любой вопрос о показателях продаж и получите форматированные таблицы из реальных данных аналитики Apollo.

Базовые инструменты Apollo, на которые ссылаются навыки

Инструмент	Описание	Влияние на данные	Внешние действия / рассылки
apollo_mixed_people_api_search	Поиск по базе людей Apollo по должности, уровню seniority, местоположению и фильтрам по компаниям.	Чтение	Нет
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	Список подключенных email/отправляющих аккаунтов.	Чтение	Нет
apollo_analytics_sync_report	Получение метрик и разбивок по продажам.	Чтение	Нет

Некоторые действия (например, обогащение) расходуют кредиты Apollo. Сведения о стоимости кредитов для каждого инструмента и актуальный справочник по инструментам см. в документации Apollo.

---

Рекомендации по моделям

Для клиентов, где можно выбрать модель (например, Claude Code через /model):

• 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 в конфигурации	Проверьте ваш mcp.json / конфигурацию клиента с помощью 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 и галереи MCP в VS Code. Активность в официальном реестре не делает сервер автоматически обнаруживаемым в этих курируемых каталогах.

---

Разработка и вклад

Этот репозиторий содержит конфигурацию клиента Apollo MCP, манифесты плагинов Claude/Cursor, навыки рабочих процессов и метаданные реестра. Сам MCP-сервер размещается Apollo.io.

Структура репозитория:

Путь	Назначение
.mcp.json	Определение удаленного MCP-сервера (apollo → https://mcp.apollo.io/mcp).
server.json	Метаданные официального MCP Registry (название, версия, транспорт, конечная точка).
.claude-plugin/	Манифесты плагина и маркетплейса Claude Code / Cowork.
.cursor-plugin/	Манифест плагина Cursor.
glama.json	Метаданные каталога MCP Glama.
skills/	Навыки рабочих процессов: prospect, enrich-lead, sequence-load, analytics.
.github/workflows/publish-mcp.yml	CI, публикующий server.json в MCP Registry.

Проверка 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).
• При каждом push в main, изменяющем server.json, рабочий процесс publish-mcp.yml публикует новую версию в официальный Model Context Protocol Registry (аутентификация через GitHub OIDC).
• Поддерживайте согласованность версии в server.json и манифестах плагинов перед публикацией, чтобы репозиторий и реестр оставались синхронизированными.
• Релизы запускаются изменениями server.json в main — репозиторий не создает GitHub Releases или теги версий для каждой версии.

---

Безопасность

Пожалуйста, не сообщайте об уязвимостях безопасности через публичные issues на GitHub.

Сообщайте о предполагаемых уязвимостях конфиденциально через Apollo Trust Center. Полный процесс раскрытия и область действия см. в SECURITY.md.

---

Поддержка

Потребность	Куда обратиться
Поддержка продукта Apollo (данные, кредиты, аккаунт, выставление счетов)	Apollo Knowledge Base или свяжитесь со службой поддержки Apollo
Документация продукта Apollo	docs.apollo.io
Ошибки интеграции MCP (этот репозиторий)	Откройте issue на GitHub в apolloio/apollo-mcp-plugin
Запросы функций	Откройте issue на GitHub в apolloio/apollo-mcp-plugin
Уязвимости безопасности	Не открывайте публичный issue — см. Security

---

Благодарности

• MCP-сервер от Apollo.io
• Спецификация плагина от Anthropic

---

Лицензия

MIT — см. LICENSE для подробностей. Copyright (c) 2025 Apollo.io.