mcp-apollo

mcp-apollo

Apollo.io 向けのオープンソースかつセルフホスト可能な MCP サーバーです。AI エージェントが Apollo の B2B 営業インテリジェンスデータベースに直接アクセスできます。

ご自身の Cloudflare アカウントに 5 分以内でデプロイできます。インフラストラクチャはご自身で所有し、コストもご自身で管理できます。共有ホスティングやベンダーロックインはありません。

AgenTeam が開発・保守しています。MIT ライセンスです。

---

仕組み

Your Cloudflare Workers account
  └── mcp-apollo Worker  (your deploy, your infra)
        └── MCP client sends requests with your Apollo API key
              └── Worker proxies to Apollo.io API
                    └── Returns enriched data to your agent

• ご自身で Worker をご自身の Cloudflare アカウントにデプロイします（無料プランでほとんどのユースケースに対応できます）
• ご自身の Apollo.io API キーを毎回のリクエストで渡します。Worker がキーを保存することはありません
• 共有インフラストラクチャはありません。各ユーザーが、それぞれ分離されたインスタンスを実行します

---

クイックデプロイ（5 分）

前提条件

• Node.js 18+
• Cloudflare アカウント（無料プランで十分です）
• Apollo.io API キー

手順

# 1. Clone the repo
git clone https://github.com/AgenTeam-AI-2026/mcp-apollo
cd mcp-apollo

# 2. Install dependencies
npm install

# 3. Log in to your Cloudflare account
npx wrangler login

# 4. Deploy
npx wrangler deploy

サーバーが次の URL で稼働しています：

https://mcp-apollo.<your-subdomain>.workers.dev

これが個人用 MCP サーバーの URL です。以下の接続設定で使用してください。

---

MCP クライアントを接続する

YOUR_WORKER_URL をデプロイした URL に、YOUR_APOLLO_KEY を Apollo.io API キーに置き換えてください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します：

{
  "mcpServers": {
    "apollo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR_WORKER_URL/mcp"],
      "env": {
        "APOLLO_API_KEY": "YOUR_APOLLO_KEY"
      }
    }
  }
}

保存した後、Claude Desktop を再起動してください。

Claude Code

claude mcp add apollo \
  --transport http \
  --url https://YOUR_WORKER_URL/mcp \
  --header "Authorization: Bearer YOUR_APOLLO_KEY"

Cursor

.cursor/mcp.json に記述します：

{
  "mcpServers": {
    "apollo": {
      "url": "https://YOUR_WORKER_URL/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APOLLO_KEY"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に記述します：

{
  "mcpServers": {
    "apollo": {
      "serverUrl": "https://YOUR_WORKER_URL/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APOLLO_KEY"
      }
    }
  }
}

---

Apollo.io API キーを取得する

1. apollo.io にログインします
2. Settings → Integrations → API に移動します
3. Create API Key をクリックします
4. キーをコピーし、上記の MCP クライアント設定に貼り付けます

---

ツール

apollo_search_people

Apollo のデータベースから、条件に一致する人物を検索します。

パラメーター	型	説明
person_titles	string[]	職位。例：["VP Engineering", "CTO"]
person_seniorities	string[]	"vp"、"c_suite"、"director"、"manager"、"senior"
organization_domains	string[]	会社のドメイン。例：["stripe.com"]
person_locations	string[]	所在地。例：["New York", "San Francisco"]
organization_num_employees_ranges	string[]	従業員数の範囲。例：["51,200", "201,500"]
page	number	ページ番号（デフォルト：1）
per_page	number	1 ページあたりの結果数。最大 25 件（デフォルト：10）

---

apollo_enrich_person

特定の人物の詳細なエンリッチ済みプロフィールを取得します。

パラメーター	型	説明
email	string	最も信頼性の高い識別子
linkedin_url	string	LinkedIn のプロフィール URL
first_name + last_name + organization_name	string	氏名と会社の組み合わせ

少なくとも 1 つの識別子が必要です。

---

apollo_search_companies

条件に一致する会社を検索します。

パラメーター	型	説明
q_organization_keyword_tags	string[]	キーワード／業種。例：["SaaS", "fintech"]
organization_locations	string[]	本社所在地
organization_num_employees_ranges	string[]	従業員数の範囲
organization_funding_stages	string[]	"Seed"、"Series A"、"Series B" など
page	number	ページ（デフォルト：1）
per_page	number	最大 25 件（デフォルト：10）

---

apollo_enrich_company

ドメインまたは会社名から、会社の詳細なプロフィールを取得します。

パラメーター	型	説明
domain	string	例："stripe.com" — 推奨
name	string	会社名 — 代替

返される情報：説明、従業員数、設立年、総資金調達額、資金調達段階、技術スタック、キーワード。

---

apollo_get_job_postings

企業の募集中の求人情報を取得します。購買・採用意欲を示す有力なシグナルです。

パラメーター	型	説明
organization_id	string	apollo_enrich_company で取得した Apollo の組織 ID
job_titles	string[]	任意のフィルターです。例：["engineer", "sales"]

---

apollo_find_email

Apollo の個人 ID を指定して、その人物の検証済みメールアドレスを取得します。

パラメーター	型	説明
person_id	string	apollo_search_people で取得した Apollo の個人 ID

---

Apollo.io のレート制限

プラン	リクエスト数 / 時間
Free	50
Basic	200
Professional	1,000
Organization	カスタム

サーバーはすべてのレスポンスにレート制限のメタデータ（rate_limits.remaining、rate_limits.resetAt）を含めます。429 エラー時には内容がわかるメッセージを返し、エラーを黙って無視することはありません。

---

Cloudflare Workers の無料枠

指標	無料枠の上限
リクエスト数	100,000 / 日
CPU 時間	10ms / リクエスト

1 日あたり 100,000 件のリクエストは、ほとんどの個人や小規模チームのデプロイに十分です。上限を超える場合は、Workers Paid プラン（1,000 万件のリクエストで月額 $5）にアップグレードしてください。

---

ローカル開発

npm install
npm run dev
# Server runs at http://localhost:8787

---

テストの実行

npm test                                        # unit + RALPH-loop tests
APOLLO_API_KEY=your_key npx vitest run test/e2e # E2E against live Apollo API

---

フォークでの CI/CD

このリポジトリには GitHub Actions のワークフローが含まれています。

• ci.yml — プッシュのたびに型チェック、ビルドチェック、テストを実行します
• deploy.yml — main へのマージ時に Cloudflare Workers にデプロイします
• e2e.yml — 稼働中の Apollo API に対する E2E テストを毎晩実行します

自動デプロイを有効にするには、フォークの GitHub → Settings → Secrets → Actions に次のシークレットを追加してください。

シークレット	取得先
CLOUDFLARE_API_TOKEN	Cloudflare Dashboard → My Profile → API Tokens → Create Token（「Edit Cloudflare Workers」テンプレートを使用）
CLOUDFLARE_ACCOUNT_ID	Cloudflare Dashboard → Workers & Pages → 右側のサイドバー

毎晩の E2E テストを有効にするには、APOLLO_API_KEY もシークレットとして追加し、リポジトリ変数 APOLLO_E2E_ENABLED を true に設定してください。

---

セキュリティ

• Apollo API キーは、各リクエストの Authorization ヘッダーに Bearer トークンとして渡されます
• Worker が API キーを保存、ログ記録、永続化することは決してありません
• 各リクエストはステートレスです。キーは、そのリクエストに対する Apollo API 呼び出しにのみ使用されます
• デプロイ全体を自分で管理できます。データがサードパーティーのインフラストラクチャに触れることはありません

---

AgenTeam が開発

AgenTeam は、B2B 営業と GTM 運用向けの AI エージェントチームを構築しています。mcp-apollo は、現代の営業チームが頼るツールにエージェントが直接アクセスできるよう、私たちが公開している複数のオープンソース MCP サーバーの 1 つです。

---

ライセンス

MIT © AgenTeam-AI-2026