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

Размещается и поддерживается Apollo.io. Сервер работает удалённо: его не нужно собирать, размещать или запускать локально.
Транспорт: Streamable HTTP.
Конечная точка:

https://mcp.apollo.io/mcp

Аутентификация: выполняется через OAuth Apollo.io. Войдите в аккаунт Apollo.io и предоставьте доступ из MCP-клиента. После этого сервер будет работать с правами вашего аккаунта Apollo.io. Подробнее см. в разделе «Аутентификация и авторизация».

В этот репозиторий также входит дополнительный плагин Apollo для Claude Code и Cowork. Он дополняет тот же сервер MCP готовыми сценариями (/apollo:*).

Основные возможности

Возможности ниже подтверждены инструментами сервера и сценариями, включёнными в этот репозиторий:

Поиск людей: поиск в базе 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 Registry, но пока не доступен для поиска в курируемом GitHub MCP Registry или галерее MCP в VS Code. До его появления добавьте сервер вручную, используя приведённую ниже конфигурацию.

Вариант 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.
Откройте Copilot Chat в режиме Agent.
Убедитесь, что инструменты 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"
    }
  }
}

Затем выполните следующие действия:

Откройте настройки 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

Затем выполните команду /mcp в Claude Code, выберите 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 (CLI). Выполните приведённые ниже инструкции для настольных клиентов.

Cowork (установка одним нажатием)

Установите плагин одним нажатием:

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

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

Claude Desktop

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

Откройте Settings и подключите коннектор Apollo.io (Apollo отображается как удалённый сервер MCP).
Пройдите аутентификацию Apollo.io в браузере.
Разрешите запрошенный доступ.
Убедитесь, что инструменты 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 использует OAuth Apollo.io. В этом разделе описано только подтверждённое поведение.

Вход. При подключении сервера клиент открывает окно входа и авторизации 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, те же сценарии доступны в виде 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

Проверяйте данные перед выполнением действий. Перед важными действиями — обогащением данных, которое расходует кредиты, и добавлением контактов в последовательность, которое может запустить исходящую рассылку, — проверьте целевые контакты и параметры операции.

Доступные инструменты и возможности

Удалённый сервер предоставляет инструменты Apollo; перечисленные ниже инструменты подтверждены в этом репозитории и используются в комплектных сценариях. Полный и актуальный набор инструментов предоставляет удалённый сервер; он может меняться независимо от этого документа.

Сценарии (плагин Claude Code / Cowork)

Полезные сценарии, объединяющие несколько инструментов Apollo в последовательные рабочие процессы:

Сценарий	Назначение
`/apollo:enrich-lead`	Укажите имя, URL LinkedIn или адрес электронной почты, чтобы получить полную карточку контакта с информацией о компании и следующими шагами.
`/apollo:prospect`	Опишите идеальный профиль клиента обычным языком и получите ранжированный список обогащённых данных лиц, принимающих решения.
`/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.

Безопасность и ответственное использование

Проверяйте результаты поиска потенциальных клиентов, прежде чем использовать или экспортировать их.
Соблюдайте применимые законы о конфиденциальности, маркетинге, борьбе со спамом и защите данных в вашей юрисдикции и юрисдикции получателей.
Проверяйте список получателей перед добавлением контактов в последовательность для связи. В зависимости от настроек последовательности и отправки, добавление контактов может автоматически запустить исходящую рассылку. Перед подтверждением обязательно проверьте название последовательности, учётную запись отправителя и количество добавляемых контактов.
Учитывайте расход кредитов 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.
При выполнении действия появляется сообщение «Permission denied»	Возможно, у вашей учётной записи Apollo.io нет необходимых разрешений для этого действия.
Недостаточно кредитов	Для обогащения данных и некоторых других действий требуются кредиты Apollo; проверьте, есть ли кредиты в рабочей области.
Клиент не поддерживает Streamable HTTP	Используйте клиент с поддержкой транспорта Streamable HTTP или общую конфигурацию из раздела Общая конфигурация клиента MCP.
В конфигурации некорректный JSON	Проверьте `mcp.json` или конфигурацию клиента с помощью валидатора JSON: завершающая запятая или пропущенная закрывающая скобка не позволит загрузить сервер.
Корпоративный прокси-сервер или брандмауэр блокирует конечную точку	Убедитесь, что `https://mcp.apollo.io` доступен через вашу сеть или список разрешённых адресов прокси-сервера.

Официальный реестр MCP

Этот сервер опубликован и активен в официальном реестре Model Context Protocol.

Поле	Значение
Имя в реестре	`io.github.apolloio/apollo-mcp`
Версия	`0.1.1`
Транспорт	Streamable HTTP
Конечная точка	`https://mcp.apollo.io/mcp`

Публикация в официальном реестре Model Context Protocol не связана с курируемым реестром GitHub MCP и каталогом MCP в VS Code. Активный статус в официальном реестре не означает, что сервер автоматически станет доступен для поиска в этих курируемых каталогах.

Разработка и участие в проекте

В этом репозитории находятся конфигурация клиента 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`	CI-процесс, который публикует `server.json` в реестре MCP.

Проверка `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 с аутентификацией через GitHub OIDC.
Перед публикацией синхронизируйте версии в server.json и манифестах плагинов, чтобы репозиторий и реестр содержали актуальные данные.
Выпуски формируются при изменении server.json в main — для каждой версии репозиторий не создаёт GitHub Releases и не добавляет теги версий.

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

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

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

Поддержка

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

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

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