Official Apollo.io MCP

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

Servidor MCP Apollo.io

O servidor oficial do Model Context Protocol da Apollo.io para prospecção, enriquecimento de leads, inteligência de vendas e fluxos de trabalho de outreach.

Provedor: Servidor oficial de primeira parte, construído e mantido pela Apollo.io.

Leve a prospecção, o enriquecimento e o outreach da Apollo.io diretamente para seu aplicativo de IA compatível com MCP favorito — GitHub Copilot, Visual Studio Code, Cursor, Claude Code, Claude Desktop e Claude Cowork.

• Apollo.io: https://www.apollo.io/
• Model Context Protocol: https://modelcontextprotocol.io/
• Licença: MIT

---

Sumário

• Visão geral
• Principais recursos
• Pré-requisitos
• Instalação no Visual Studio Code e GitHub Copilot
• Instalação no Cursor
• Instalação no Claude Code
• Instalação no Claude Desktop ou Claude Cowork
• Configuração genérica de cliente MCP
• Autenticação e autorização
• Exemplos de uso
• Ferramentas e recursos disponíveis
• Recomendações de modelos
• Segurança e uso responsável
• Privacidade e tratamento de dados
• Solução de problemas
• Registro oficial de MCP
• Desenvolvimento e contribuição
• Versionamento e lançamentos
• Segurança
• Suporte
• Créditos
• Licença

---

Visão geral

O servidor MCP da Apollo.io expõe os dados e fluxos de trabalho de go-to-market da Apollo.io por meio do Model Context Protocol, para que aplicativos de IA compatíveis com MCP possam prospectar pessoas e empresas, enriquecer contatos, consultar análises de vendas e carregar leads em sequências de outreach usando linguagem natural.

• Hospedado e mantido pela Apollo.io. O servidor é executado remotamente — não há nada para compilar, hospedar ou executar localmente.

• Transporte: HTTP Streamable.

• Endpoint:

  https://mcp.apollo.io/mcp
  

• Autenticação: Tratada por meio do OAuth da Apollo.io. Você faz login com sua conta Apollo.io e autoriza o acesso pelo seu cliente MCP; o servidor então age com suas permissões da Apollo.io. Consulte Autenticação e autorização.

Este repositório também inclui um plugin opcional da Apollo para Claude Code e Cowork que agrupa habilidades de fluxo de trabalho prontas (comandos /apollo:*) sobre o mesmo servidor MCP.

---

Principais recursos

Os seguintes recursos são confirmados pelas ferramentas e habilidades do servidor neste repositório:

• Prospecção de pessoas — pesquise o banco de dados de pessoas da Apollo por cargo, senioridade, localização e atributos de empresa.
• Prospecção de empresas — pesquise organizações por setor, porte, localização e palavras-chave.
• Enriquecimento de contatos e contas — corresponda e enriqueça pessoas e organizações, individualmente ou em lote.
• Fluxos de trabalho de sequências de outreach — encontre sequências e adicione ou remova/interrompa contatos em uma sequência.
• Análises de vendas — consulte métricas de e-mail, chamadas, reuniões, tarefas, oportunidades, sequências e inteligência de conversas e retorne detalhamentos formatados.
• Gestão de contatos — crie contatos na Apollo como parte dos fluxos de trabalho de enriquecimento e carregamento em sequências.

O servidor remoto pode expor ferramentas adicionais além daquelas exercitadas pelas habilidades incluídas. A lista acima reflete o que é confirmado neste repositório. Consulte Ferramentas e recursos disponíveis.

---

Pré-requisitos

• Uma conta Apollo.io. Faça login em https://www.apollo.io/.

• Permissões e créditos da Apollo.io. As ações são executadas com as permissões da sua conta, e algumas ações consomem créditos da Apollo (por exemplo, enriquecimento). Consulte Segurança e uso responsável. Para detalhes sobre planos, créditos e permissões, consulte a documentação da Apollo.

• Um cliente compatível com MCP que suporte o transporte HTTP Streamable, como:

  • GitHub Copilot no Visual Studio Code
  • Cursor
  • Claude Code
  • Claude Desktop / Claude Cowork
  • Outros clientes MCP (consulte Configuração genérica de cliente MCP)

• Nenhum runtime local necessário. O servidor é remoto e hospedado pela Apollo.io — você não precisa de Node.js, Docker ou instalação local para usá-lo. (O plugin opcional para Claude Code / Cowork instala habilidades de fluxo de trabalho localmente por meio do sistema de plugins do seu cliente, mas o servidor MCP em si permanece remoto.)

---

Instalação no Visual Studio Code e GitHub Copilot

O servidor MCP da Apollo.io está publicado no registro oficial do Model Context Protocol, mas ainda não é detectável no registro GitHub MCP curado ou na galeria MCP do VS Code. Até lá, adicione-o manualmente com a configuração abaixo.

Opção A — arquivo de configuração do workspace

Crie um arquivo .vscode/mcp.json no seu workspace:

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

Opção B — paleta de comandos

1. Abra a Paleta de Comandos (Cmd/Ctrl + Shift + P).
2. Execute MCP: Add Server.
3. Escolha o tipo de servidor HTTP (Streamable HTTP) quando solicitado.
4. Insira a URL https://mcp.apollo.io/mcp e nomeie o servidor como apollo.

Autenticação esperada e primeira execução

1. Adicione o servidor MCP usando qualquer uma das opções acima.
2. Inicie ou habilite o servidor apollo.
3. Conclua a autenticação da Apollo.io na janela do navegador que abrir.
4. Aprove o acesso solicitado para seu workspace da Apollo.io.
5. Abra o Copilot Chat no modo Agent.
6. Confirme que as ferramentas da Apollo estão listadas e disponíveis para o agente.

Para a terminologia e o comportamento atuais, consulte a documentação do VS Code sobre servidores MCP: https://code.visualstudio.com/docs/copilot/chat/mcp-servers.

---

Instalação no Cursor

Adicione o endpoint HTTP Streamable remoto à sua configuração MCP do Cursor (por exemplo, ~/.cursor/mcp.json, ou o .cursor/mcp.json no nível do projeto):

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

Em seguida:

1. Abra as configurações do Cursor e confirme que o servidor apollo está listado em MCP.
2. Autentique-se com sua conta Apollo.io quando solicitado.
3. Aprove o acesso solicitado e use as ferramentas da Apollo pelo agente.

Este repositório também inclui um manifesto de plugin para Cursor (.cursor-plugin/plugin.json) que referencia o mesmo endpoint remoto (.mcp.json), portanto nenhum pacote local precisa ser executado.

---

Instalação no Claude Code

Você pode conectar o servidor de duas maneiras.

Opção A — adicionar o servidor MCP remoto diretamente

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

Em seguida, execute /mcp dentro do Claude Code, selecione apollo e autentique-se.

Opção B — instalar o plugin da Apollo (adiciona habilidades de fluxo de trabalho /apollo:*)

1. Adicione o marketplace deste plugin:

   /plugin marketplace add apolloio/apollo-mcp-plugin
   

2. Instale o plugin:

   /plugin install apollo@apollo-plugin-marketplace
   

3. Reinicie o Claude Code para que o servidor MCP inicie corretamente.

O plugin configura automaticamente o servidor MCP da Apollo — sem arquivos de configuração manuais. Após a instalação, autentique-se com /mcp e execute comandos /apollo:* (consulte Ferramentas e recursos disponíveis).

---

Instalação no Claude Desktop ou Claude Cowork

Claude Desktop e Claude Cowork são separados do Claude Code (a CLI). Use as etapas abaixo para os clientes baseados em desktop.

Cowork (um clique)

Clique para instalar em uma única etapa:

Instalar no Cowork

Em seguida, reinicie o Cowork para que o servidor MCP inicie corretamente.

Claude Desktop

Adicione o conector da Apollo nas configurações do Claude e autentique-se:

1. Abra Configurações e conecte o conector da Apollo.io (a Apollo aparece como um servidor MCP remoto).
2. Conclua a autenticação da Apollo.io no seu navegador.
3. Aprove o acesso solicitado.
4. Confirme que as ferramentas da Apollo estão disponíveis em uma nova conversa.

Os rótulos exatos dos menus e a navegação variam conforme a versão do Claude Desktop. Consulte a documentação da Anthropic para as etapas atuais de adição de um conector MCP remoto.

---

Configuração genérica de cliente MCP

Para qualquer outro cliente compatível com MCP que suporte HTTP Streamable:

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

Os nomes exatos das propriedades variam entre clientes. Alguns clientes usam type: "http" (como nos exemplos do VS Code e do Cursor acima) e outros usam type: "streamable-http". Consulte a documentação de MCP do seu cliente para o esquema exato.

---

Autenticação e autorização

O servidor MCP da Apollo usa OAuth da Apollo.io. Apenas o comportamento confirmado está documentado aqui.

• Fluxo de login. Ao conectar o servidor, seu cliente abre uma janela de login e autorização da Apollo.io. Após aprovar o acesso, seu cliente pode chamar as ferramentas da Apollo em seu nome.
• Workspace e permissões. O servidor age com as permissões da Apollo.io do usuário autenticado. Você só pode acessar dados e executar ações permitidas pela sua conta Apollo.io.
• Reconexão. No Claude Code, você pode executar novamente /mcp, selecionar apollo e reautenticar. Em outros clientes, reative a autenticação pelas configurações de MCP ou de conector do cliente.
• Revogação de acesso. Remova ou desconecte o servidor apollo do seu cliente MCP para impedir que ele aja em seu nome. Para gerenciar autorizações no nível da conta, use as configurações da sua conta Apollo.io.

Os metadados do servidor de autorização OAuth podem ser descobertos em https://mcp.apollo.io/.well-known/oauth-authorization-server. Além disso, este README não afirma uma especificação ou perfil OAuth específico.

---

Exemplos de uso

Solicitações em linguagem natural que você pode testar depois que o servidor estiver conectado:

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.

Se você instalou o plugin para Claude Code / Cowork, os mesmos fluxos de trabalho estão disponíveis como comandos de barra:

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

Revise antes de agir. Para ações de consequência — enriquecimento (que consome créditos) e adição de contatos a uma sequência (potencialmente de saída) — revise os alvos e parâmetros exatos antes de confirmar a operação.

---

Ferramentas e recursos disponíveis

O servidor remoto fornece as ferramentas subjacentes da Apollo; as ferramentas listadas abaixo são aquelas confirmadas neste repositório por meio das habilidades de fluxo de trabalho incluídas. O conjunto completo e autoritativo de ferramentas é fornecido pelo servidor remoto e pode evoluir independentemente deste documento.

Habilidades de fluxo de trabalho (plugin Claude Code / Cowork)

Habilidades de alto valor que encadeiam várias ferramentas da Apollo em fluxos de trabalho completos:

Habilidade	O que faz
/apollo:enrich-lead	Informe um nome, URL do LinkedIn ou e-mail e receba um cartão de contato completo com contexto da empresa e próximas ações.
/apollo:prospect	Descreva seu ICP em inglês simples e receba uma tabela classificada de tomadores de decisão enriquecidos.
/apollo:sequence-load	Encontre leads, enriqueça-os, remova duplicatas e adicione-os em lote a uma sequência da Apollo com pré-visualização antes da inscrição.
/apollo:analytics	Faça qualquer pergunta sobre desempenho de vendas e receba tabelas formatadas com dados reais de análises da Apollo.

Ferramentas subjacentes da Apollo referenciadas pelas habilidades

Ferramenta	Descrição	Efeito nos dados	Ação de outreach / externa
apollo_mixed_people_api_search	Pesquisar o banco de dados de pessoas do Apollo por cargo, senioridade, localização e filtros de empresa.	Leituras	Não
apollo_mixed_companies_search	Pesquisar o banco de dados de organizações do Apollo por setor, tamanho, localização e palavras-chave.	Leituras	Não
apollo_people_match	Corresponder e enriquecer uma única pessoa a partir de identificadores disponíveis.	Leituras / enriquece	Não
apollo_people_bulk_match	Corresponder e enriquecer várias pessoas em uma única chamada.	Leituras / enriquece	Não
apollo_organizations_enrich	Enriquecer uma única organização.	Leituras / enriquece	Não
apollo_organizations_bulk_enrich	Enriquecer várias organizações em uma única chamada.	Leituras / enriquece	Não
apollo_contacts_create	Criar um contato no workspace do Apollo.	Altera dados do Apollo	Não
apollo_emailer_campaigns_search	Encontrar sequências de outreach por nome.	Leituras	Não
apollo_emailer_campaigns_add_contact_ids	Adicionar contatos a uma sequência de outreach.	Altera dados do Apollo	Sim — pode iniciar envio externo dependendo das configurações da sequência.
apollo_emailer_campaigns_remove_or_stop_contact_ids	Remover ou interromper contatos em uma sequência de outreach.	Altera dados do Apollo	Afeta o outreach ativo
apollo_email_accounts_index	Listar contas de e-mail/envio conectadas.	Leituras	Não
apollo_analytics_sync_report	Recuperar métricas e detalhamentos de análise de vendas.	Leituras	Não

Algumas ações (como enriquecimento) consomem créditos do Apollo. Para custos de crédito por ferramenta e a referência de ferramentas autoritativa e atualizada, consulte a documentação do Apollo.

---

Recomendações de Modelo

Para clientes onde você pode escolher um modelo (por exemplo, Claude Code via /model):

• Opus (melhor qualidade) — raciocínio mais forte e a orquestração de ferramentas multi-etapas mais confiável. Melhor para fluxos de prospecção, correspondências ambíguas, encadeamento multi-etapas e tarefas de alto risco. Tradeoff: maior latência e custo de uso.
• Sonnet (mais rápido) — bom para consultas rápidas, enriquecimento leve e iteração rápida. Tradeoff: pode precisar de mais orientação em fluxos de trabalho complexos de várias etapas.

---

Segurança e Uso Responsável

• Revise os resultados de prospecção antes de usá-los ou exportá-los.
• Siga as leis aplicáveis de privacidade, marketing, anti-spam e proteção de dados em sua jurisdição e na dos destinatários.
• Confirme os destinatários antes de adicionar qualquer pessoa a uma sequência de outreach. Dependendo da sua sequência e configuração de envio, a inscrição pode iniciar o envio externo automaticamente. Sempre verifique o nome da sequência, a conta de envio e o volume de inscrição antes de confirmar.
• Esteja ciente do consumo de créditos do Apollo. Algumas ações (como enriquecimento) consomem créditos do Apollo, e ações em massa escalam com o volume. As habilidades deste repositório são projetadas para avisar e solicitar confirmação antes de ações que consomem créditos. Para custos de crédito, consulte a documentação do Apollo.
• Evite ações em massa ou destrutivas sem revisar primeiro seu escopo exato.
• Respeite as permissões da conta Apollo e as políticas da sua organização.

Esta seção é orientação, não aconselhamento jurídico.

---

Privacidade e Tratamento de Dados

• As solicitações são enviadas ao endpoint MCP hospedado pela Apollo (https://mcp.apollo.io/mcp).
• O servidor interage com os dados do Apollo sob sua conta autenticada e permissões.
• Evite enviar informações sensíveis desnecessárias em prompts.

Para os recursos oficiais de privacidade e segurança da Apollo.io:

• Política de Privacidade: https://www.apollo.io/privacy-policy
• Central de Privacidade: https://www.apollo.io/company/privacy-center
• Segurança: https://www.apollo.io/product/security
• Central de Confiança: https://trust.apollo.io/

---

Solução de Problemas

Sintoma	O que verificar
A janela de autenticação não abre	Garanta que pop-ups sejam permitidos; reative a autenticação nas configurações de MCP/conector do seu cliente.
Sessão de autenticação expirada	Reautentique (no Claude Code, execute /mcp → apollo → authenticate).
O servidor não está iniciando	Reinicie o cliente após adicionar/instalar; confirme que a URL do endpoint é exatamente https://mcp.apollo.io/mcp.
As ferramentas não aparecem	Confirme que o servidor está habilitado e autenticado e (para Copilot) que o chat está no modo Agent.
"Permissão negada" em uma ação	Sua conta Apollo.io pode não ter a permissão necessária para essa ação.
Créditos indisponíveis	Enriquecimento e algumas ações exigem créditos Apollo; confirme que seu workspace tem créditos disponíveis.
O cliente não suporta Streamable HTTP	Use um cliente que suporte o transporte Streamable HTTP, ou a configuração genérica em Configuração Genérica de Cliente MCP.
JSON inválido na configuração	Valide seu mcp.json / configuração do cliente com um linter JSON — uma vírgula final ou chave ausente impedirá o carregamento do servidor.
Proxy corporativo ou firewall bloqueia o endpoint	Garanta que https://mcp.apollo.io seja acessível através da sua lista de permissões de rede/proxy.

---

Registro Oficial MCP

Este servidor está publicado e ativo no Registro Oficial do Model Context Protocol.

Campo	Valor
Nome do registro	io.github.apolloio/apollo-mcp
Versão	0.1.1
Transporte	Streamable HTTP
Endpoint	https://mcp.apollo.io/mcp

A publicação no Registro Oficial do Model Context Protocol é separada do Registro MCP curado do GitHub e da galeria MCP do VS Code. Estar ativo no registro oficial não torna automaticamente o servidor detectável nesses catálogos curados.

---

Desenvolvimento e Contribuição

Este repositório contém a configuração do cliente MCP Apollo, os manifestos de plugin Claude/Cursor, as habilidades de fluxo de trabalho e os metadados do registro. O servidor MCP em si é hospedado pela Apollo.io.

Estrutura do repositório:

Caminho	Finalidade
.mcp.json	Definição do servidor MCP remoto (apollo → https://mcp.apollo.io/mcp).
server.json	Metadados do Registro Oficial MCP (nome, versão, transporte, endpoint).
.claude-plugin/	Manifestos de plugin e marketplace do Claude Code / Cowork.
.cursor-plugin/	Manifesto do plugin Cursor.
glama.json	Metadados do diretório MCP Glama.
skills/	Habilidades de fluxo de trabalho: prospect, enrich-lead, sequence-load, analytics.
.github/workflows/publish-mcp.yml	CI que publica server.json no Registro MCP.

Validando server.json

server.json segue o esquema do servidor MCP referenciado no topo do arquivo. A publicação é automatizada pelo fluxo de trabalho de CI (veja abaixo), que baixa o mcp-publisher oficial e executa mcp-publisher publish.

Não há comando validate autônomo. Para verificar server.json localmente antes de enviar, execute uma publicação de teste com a CLI oficial:

mcp-publisher publish --dry-run

Contribuições são bem-vindas via pull requests. Mantenha os metadados de versão consistentes entre server.json, .claude-plugin/plugin.json e .cursor-plugin/plugin.json.

---

Versionamento e Lançamentos

• A versão do servidor é declarada em server.json (version: 0.1.1) e espelhada nos manifestos de plugin (.claude-plugin/plugin.json, .cursor-plugin/plugin.json).
• Em cada push para main que altera server.json, o fluxo de trabalho publish-mcp.yml publica a nova versão no Registro Oficial do Model Context Protocol (autenticando via GitHub OIDC).
• Mantenha a versão em server.json e os manifestos de plugin alinhados antes de publicar, para que o repositório e o registro permaneçam sincronizados.
• Os lançamentos são conduzidos por alterações em server.json em main — o repositório não cria GitHub Releases ou tags de versão por versão.

---

Segurança

Por favor, não relate vulnerabilidades de segurança por meio de issues públicas do GitHub.

Relate suspeitas de vulnerabilidades de forma privada através do Apollo Trust Center. Consulte SECURITY.md para o processo completo de divulgação e escopo.

---

Suporte

Necessidade	Onde ir
Suporte ao produto Apollo (dados, créditos, conta, cobrança)	Base de Conhecimento Apollo ou contate o Suporte Apollo
Documentação do produto Apollo	docs.apollo.io
Bugs de integração MCP (este repositório)	Abra uma issue no GitHub em apolloio/apollo-mcp-plugin
Solicitações de recursos	Abra uma issue no GitHub em apolloio/apollo-mcp-plugin
Vulnerabilidades de segurança	Não abra uma issue pública — consulte Segurança

---

Créditos

• Servidor MCP por Apollo.io
• Especificação do plugin por Anthropic

---

Licença

MIT — consulte LICENSE para detalhes. Copyright (c) 2025 Apollo.io.