gongio-mcp

1. 管理者として Gong にログインします
2. Company Settings → Ecosystem → APIに移動します
3. Create API Keyをクリックします
4. Access Key と Secret の両方を保存します（Secret は一度しか表示されません）

オプション1：npx（インストール不要）

npx gongio-mcp

オプション2：npm でグローバルインストール

npm install -g gongio-mcp
gongio-mcp

オプション3：ソースからインストール

git clone https://github.com/JustinBeckwith/gongio-mcp.git
cd gongio-mcp
npm install
npm run build
node dist/index.js

オプション4：Docker（ローカルでビルド）

git clone https://github.com/JustinBeckwith/gongio-mcp.git
cd gongio-mcp
docker build -t gongio-mcp .
docker run --rm -i \
  -e GONG_ACCESS_KEY=your-access-key \
  -e GONG_ACCESS_KEY_SECRET=your-secret-key \
  gongio-mcp

Gong の認証情報を環境変数として設定します。

export GONG_ACCESS_KEY="your-access-key"
export GONG_ACCESS_KEY_SECRET="your-secret-key"

または、インラインで渡します。

GONG_ACCESS_KEY=your-key GONG_ACCESS_KEY_SECRET=your-secret npx gongio-mcp

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

npx を使用する場合：

{
  "mcpServers": {
    "gong": {
      "command": "npx",
      "args": ["gongio-mcp"],
      "env": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_ACCESS_KEY_SECRET": "your-secret-key"
      }
    }
  }
}

Docker を使用する場合：

{
  "mcpServers": {
    "gong": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
               "-e", "GONG_ACCESS_KEY",
               "-e", "GONG_ACCESS_KEY_SECRET",
               "gongio-mcp"],
      "env": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_ACCESS_KEY_SECRET": "your-secret-key"
      }
    }
  }
}

Claude Code

npx を使用する場合：

claude mcp add gong -e GONG_ACCESS_KEY=your-key -e GONG_ACCESS_KEY_SECRET=your-secret -- npx gongio-mcp

Docker を使用する場合（docker build -t gongio-mcp . の実行後）：

claude mcp add gong -e GONG_ACCESS_KEY=your-key -e GONG_ACCESS_KEY_SECRET=your-secret -- docker run --rm -i -e GONG_ACCESS_KEY -e GONG_ACCESS_KEY_SECRET gongio-mcp

任意の日付範囲やワークスペースで絞り込んで通話を一覧表示します。最小限の通話メタデータ（ID、タイトル、日付、時間）を返します。

パラメーター：

1 件の通話の URL、タイミング、方向、スコープ、システムなどのメタデータを取得します。通話メタデータのみが必要な場合は、get_call_summary より高速です。

パラメーター：

簡単な概要、要点、トピック、アクション項目、詳細なアウトラインを含む、AI が生成した要約を取得します。通話内容を把握するには、この方法を推奨します。正確な引用が必要な場合にのみ get_call_transcript を使用してください。

パラメーター：

発言者情報付きの生のトランスクリプトを取得します。コンテキストの過剰な使用を防ぐため、トランスクリプトはページ分割されます（デフォルトは 10KB）。ページ間を移動するには、maxLength と offset を使用します。

パラメーター：

参加者の検索、顧客名の検索、詳細なコンテンツの選択など、高度なフィルターを使って通話を検索します。すべての結果を自動的にページネーションし、デフォルトで参加者情報、簡単な要約、トピックを返します。

パラメーター：

日付とワークスペース

ホスト／参加者

コンテンツと顧客

メタデータ

レスポンス形式

include のオプション：

デフォルト（常に返されます）：参加者、簡単な要約、トピック — 1 通話あたり約 3KB。

フィルターの動作に関する注意事項：

• フィルターは AND ロジックで組み合わされます。primaryUserIds と participantUserIds は連携します。primary はサーバー側で絞り込み、participant は後処理でフィルタリングします。
• customerName は、CRM のアカウント Name フィールド、外部参加者のメールドメイン、通話タイトルのいずれかに一致します（大文字と小文字を区別しない部分一致）。
• trackers の名前は ワークスペース固有 です。まず get_trackers を呼び出して、設定内容を確認してください。一致条件は大文字と小文字を区別しない部分一致です（そのため、"competitor" は "Competitors" と "Competitor Mentions" の両方に一致します）。
• trackers フィルターを設定すると、該当するトラッカーの内容が自動的に含まれ、出力には指定したトラッカーのみが表示されます。フィルターを指定しない場合は、カウントが 0 より大きいトラッカーのみが表示されます。
• 結果が空の場合、エラーではなく "No calls found" が返されます。

大きな結果のフォールバック処理については、レスポンスサイズとコンテキスト制限を参照してください。

外部参加者のメールドメインを照合し、特定のアカウントまたは会社が関係する通話を検索します。Gong API はアカウント名によるフィルタリングをネイティブではサポートしていません（既知の制限）。このツールは指定期間の通話を取得し、parties[].emailAddress に基づいて後処理でフィルタリングします。基盤となる /v2/calls/extensive エンドポイントのページネーションは、maxCalls まで自動的に行われます。

次のような場合に使用してください：

• 見込み顧客が複数のメールドメイン（acme.com、acme.io、地域別 TLD など）を持ち、すべてを検索する必要がある場合
• 外部のエンリッチメントデータ（例：BuiltWith／Clearbit／ベンダースタックのグラフから「Klaviyo を利用しているすべての見込み顧客」）と結合する必要がある場合。上流でドメインの一覧を特定し、ここに渡してください
• システム間で表記が揺れる CRM のアカウント名よりも、ドメインベースの照合のほうが信頼性が高い場合

パラメーター：

CRM Opportunity の ID または名前の部分文字列を指定して、関連付けられた通話を検索します。Gong-CRM 連携（Salesforce / HubSpot）が必要です。CRM に紐付いていない通話は一致しません。

次のような場合に使用します：

• 特定の案件に関するすべての通話を取得したい場合 — opportunityIds: ["006xxxxx"] が最も正確な方法です
• Opportunity の名前が具体的な場合（例："Acme Q4 Renewal"）に、名前が変更された、または重複した Opportunity もあいまい検索したい場合

パラメーター：

コストに関する注意： search_calls_by_account と同じ、取得してから絞り込む方法を使用します。CRM コンテキストの照会に追加の API 呼び出しは発生しません。同じ /v2/calls/extensive リクエストで context: "Extended" を指定して処理します。

指定した日付範囲内の通話トランスクリプトの文章を対象に、フリーテキストキーワード検索を行います。2 段階で処理します：（1）/v2/calls/extensive で、日付と任意の primaryUserIds / domains に基づいて通話を絞り込み、（2）/v2/calls/transcript で絞り込んだ通話のトランスクリプトを取得し、話者の情報とタイムスタンプを含む文章単位の一致結果を返します。

繰り返し検索する用語には Gong Trackers を優先してください。 競合他社名、ESP／技術用語（Klaviyo、Braze、Iterable、Postscript、Attentive、Sendgrid、Customer.io など）、その他繰り返し検索する用語は、UI で Gong Trackers に設定してください（初回のみ。約 20 個の用語で約 30 分）。その後は get_trackers、search_calls、get_call_summary を使用してください。Trackers はサーバー側で処理されるため、コストを大幅に削減でき、件数とタイムスタンプも標準で取得できます。search_transcripts は一時的な検索に使用してください。

コスト上限： 30 日を超える日付範囲を指定するには、primaryUserIds または domains による追加の絞り込みが必要です。6 か月間を絞り込みなしで検索すると、API クォータを消費するため、スキーマレベルで拒否されます。

パラメーター：

返される内容： 通話ごとにグループ化された文単位の一致結果です。話者名と所属（利用可能な場合）、一致したキーワード、タイムスタンプ（mm:ss）、文の抜粋が含まれます。

追跡対象のフレーズ、所属（誰の発言を追跡するか）、フィルタークエリを含む、すべてのキーワードトラッカーの定義を一覧表示します。get_call_summary の出力に表示されるトラッカーのヒットについて説明します。

パラメーター：

Gong のすべてのワークスペースについて、ID と名前を一覧表示します。これらの ID は、list_calls、search_calls、get_trackers などのツールでフィルターとして使用できます。ほとんどの企業では、ワークスペースは1～3個です（地域や製品ラインごとなど）。

パラメーター： なし

名前、メールアドレス、役職、電話番号、設定を含む、特定のユーザーのプロフィールを取得します。通話データから返されたユーザー ID の特定に役立ちます。

パラメーター：

ID または作成日時でユーザーを検索、絞り込みます。通話データから取得した特定のユーザー ID を一括で特定する場合、list_users より柔軟に使用できます。

パラメーター：

ワークスペース内のすべての Gong ユーザーを一覧表示します。各ユーザーの名前、メールアドレス、役職を返します。

パラメーター：

ワークスペース内の Gong 公開通話ライブラリフォルダーをすべて一覧表示します。get_library_folder_calls で使用するフォルダー ID と名前を返します。非公開フォルダーとアーカイブ済みフォルダーは返されません。

パラメーター：

指定した Gong ライブラリフォルダーに保存されている通話をすべて取得します。通話 ID、タイトル、キュレーターのメモ、クリップの開始・終了時間を返します。通話 ID は get_call_summary または get_call_transcript に直接渡せます。

パラメーター：

Gong ワークスペース内の全ユーザーの Markdown 形式のリストを返します。通話データに含まれるユーザー ID の特定に便利です。

パラメーター： なし