Apollo.io MCP サーバー
シームレスな Apollo.io API 統合を実現する強力な Model Context Protocol (MCP) サーバー実装により、AI アシスタントが Apollo.io データと対話できるようになります。
概要
この MCP サーバーは、Apollo.io API と対話するための包括的なツール セットを提供し、AI アシスタントが次のことを実行できるようにします。
個人と組織のためのデータを充実させる
人物や組織を検索する
特定の組織の求人情報を探す
AIアシスタントインターフェースを離れずにApollo.ioの操作を実行
Related MCP server: MCP Toolkit
この MCP サーバーを使用する理由
シームレスなAI統合：AIアシスタントをApollo.ioデータに直接接続
簡素化された API 操作: 自然言語コマンドを通じて一般的な Apollo.io タスクを実行します。
リアルタイムデータアクセス：Apollo.ioから最新情報を入手
安全な認証: Apollo.ioの安全なAPIトークン認証を使用します
拡張可能な設計: 必要に応じて Apollo.io API 機能を簡単に追加できます
インストール
構成
サーバーにはApollo.io APIアクセストークンが必要です。以下の方法で取得できます。
Apollo.ioアカウントにアクセスする
設定 > API へ移動
APIキーの生成
トークンは次の 2 つの方法で提供できます。
環境変数として:
APOLLO_IO_API_KEY=your-api-keyコマンドライン引数として:
npm start -- --api-key=your-api-key
開発の場合は、プロジェクト ルートに.envファイルを作成して環境変数を保存します。
使用法
サーバーの起動
SSEサーバーでの認証の実装
SSEサーバーは認証にmcp-proxy-authパッケージを使用します。認証を実装するには、以下の手順に従います。
パッケージをインストールします。
npm install mcp-proxy-authAUTH_SERVER_URL環境変数を、API キー検証エンドポイントを指すように設定します。export AUTH_SERVER_URL=https://your-auth-server.com/verify認証付きで SSE サーバーを実行します。
npx mcp-proxy-auth node dist/index.jsSSE URL は次の場所で入手できます。
localhost:8080/sse?apiKey=apikey認証用の実際の API キーに
apikey置き換えます。
mcp-proxy-authパッケージは、次の機能を果たすプロキシとして機能します。
SSEサーバーへのリクエストをインターセプトします
認証サーバーに対してAPIキーを検証します
認証されたリクエストのみが SSE エンドポイントに到達できるようにします
AIアシスタントとの統合
このMCPサーバーは、モデルコンテキストプロトコル（MCP）をサポートするAIアシスタントと連携するように設計されています。サーバーが起動すると、互換性のあるAIアシスタントがApollo.ioのデータとやり取りするために使用できるツールセットが公開されます。
利用可能なツール
サーバーは、次の強力な Apollo.io 統合ツールを公開します。
人々の豊かさ
人物エンリッチメントエンドポイントを使用して、1 人の人物のデータをエンリッチします。
パラメータ:
first_name(文字列、オプション): 人の名last_name(文字列、オプション): 人の姓email(文字列、オプション): 個人のメールアドレスdomain（文字列、オプション）: 会社のドメインorganization_name(文字列、オプション): 組織名
例：
{ "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com" }
組織の強化
組織エンリッチメントエンドポイントを使用して、1 社のデータをエンリッチメントします。
パラメータ:
domain（文字列、オプション）: 会社のドメインname(文字列、オプション): 会社名
例：
{ "domain": "apollo.io" }
人探し
人を検索するには、人検索エンドポイントを使用します。
パラメータ:
q_organization_domains_list(配列、オプション): 検索対象となる組織ドメインのリストperson_titles(配列、オプション): 検索する役職のリストperson_seniorities(配列、オプション): 検索する役職レベルのリスト
例：
{ "person_titles": ["Marketing Manager"], "person_seniorities": ["vp"], "q_organization_domains_list": ["apollo.io"] }
組織検索
組織検索エンドポイントを使用して組織を検索する
パラメータ:
q_organization_domains_list(配列、オプション): 検索する組織ドメインのリストorganization_locations(配列、オプション): 検索する組織の場所のリスト
例：
{ "organization_locations": ["Japan", "Ireland"] }
組織の求人情報
組織の求人情報エンドポイントを使用して、特定の組織の求人情報を検索します。
パラメータ:
organization_id(文字列、必須): Apollo.io 組織 ID
例：
{ "organization_id": "5e60b6381c85b4008c83" }
サーバーの拡張
サーバーは簡単に拡張できるように設計されています。Apollo.io APIの新しい機能を追加するには、以下の手順に従ってください。
src/apollo-client.tsのApolloClientクラスに新しいメソッドを追加します。src/index.tsのsetupToolHandlersメソッドに新しいツールを登録します。npm run buildでプロジェクトをリビルドします。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
キーワード
Apollo.io、モデルコンテキストプロトコル、MCP、AIアシスタント、TypeScript、API統合、Apollo.io API、人材エンリッチメント、組織エンリッチメント、人材検索、組織検索、求人情報、AIツール