Gong通话数据查询服务

1. 以管理员身份登录龚
2. 首选 公司设置 → 生态系统 → API
3. 点击 创建API密钥
4. 保存访问密钥和密钥（密钥只显示一次）

选项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"
      }
    }
  }
}

克劳德代码

使用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、标题、日期、持续时间）。

参数：

获取一次调用的URL、时间、方向、范围、系统和其他元数据。比...更快 get_call_summary 当你只需要调用元数据时。

参数：

获取人工智能生成的摘要，包括简要概述、要点、主题、行动项和详细大纲。这是理解调用的推荐方法——使用 get_call_transcript 只有当你需要精确的报价时。

参数：

获取带有说话者归属的原始成绩单。转录被分页（默认10KB）以防止上下文溢出——使用 maxLength 和 offset 导航。

参数：

使用高级过滤器搜索通话，包括参与者查找、客户姓名搜索和丰富内容选择。默认情况下，自动分页所有结果并返回参与者信息、简短摘要和主题。

参数：

日期和工作空间

主持人/参与者

内容和客户

元数据

响应形状

include 选项：

默认值（始终返回）：参与者、简短摘要和主题——每次通话约3KB。

过滤器行为说明：

• 过滤器与 与 逻辑。 primaryUserIds + participantUserIds compose：primary缩小服务器端、参与者帖子过滤器的范围。
• customerName 匹配以下任一项：CRM帐户名称字段、外部参与者电子邮件域或呼叫标题（不区分大小写的子字符串）。
• trackers 名字是 特定工作空间 --呼叫 get_trackers 首先看看配置了什么。Match是不区分大小写的子字符串（因此 "competitor" 匹配两者 "Competitors" 和 "Competitor Mentions").
• 当 trackers 过滤器已设置，相关跟踪器内容将自动包含，输出仅显示您询问的跟踪器。如果没有过滤器，则只显示非零跟踪器。
• 返回空结果 "No calls found" 而不是错误。

看 响应大小和上下文限制 了解大结果回退的工作原理。

通过匹配外部参与者的电子邮件域来查找涉及特定帐户或公司的呼叫。Gong API本机不支持按帐户名进行过滤（a 已知间隙)--此工具获取日期范围内的调用，并在 parties[].emailAddress。自动为底层分页 /v2/calls/extensive 端点高达 maxCalls.

在以下情况下使用此功能：

• 潜在客户有多个电子邮件域(acme.com, acme.io，区域顶级域名），您需要所有这些域名
• 您需要加入外部富集数据（例如，来自BuiltWith/Clearbit/供应商堆栈图的“Klaviyo上的所有潜在客户”）——解析到上游的域列表并将其传递到此处
• 基于域的匹配比跨系统漂移的CRM帐户名更可靠

参数：

成本说明： 这是先提取后过滤。一个90天的窗口，没有其他缩小页面通常通过1-5个API调用。与…结合 primaryUserIds 长期限制成本。

通过ID或名称子字符串查找与特定CRM Opportunity链接的呼叫。需要Gong CRM集成（Salesforce/HubSpot）——没有CRM链接的呼叫将不匹配。

在以下情况下使用此功能：

• 你希望每次通话都有一个特定的交易-- opportunityIds: ["006xxxxx"] 是最精确的选择
• 机会名称是描述性的（例如。 "Acme Q4 Renewal")您希望在重命名/重复的机会之间进行模糊匹配

参数：

成本说明： 使用与以下相同的先提取后过滤模式 search_calls_by_account.CRM上下文查找不添加额外的API调用-它依赖于相同的 /v2/calls/extensive 请求与 context: "Extended".

在限定日期范围内跨通话记录句子进行自由文本关键字搜索。两个阶段：（1） /v2/calls/extensive 按日期+可选缩小通话范围 primaryUserIds / domains, (2) /v2/calls/transcript 获取缩小的集合的转录本，并返回与说话者归因和时间戳相匹配的句子级别。

对于经常出现的术语，更喜欢龚追踪者。 对于竞争对手名称、ESP/技术术语（Klaviyo、Braze、Iterable、Postscript、Attentive、Sendgrid、Customer.io等）以及您将反复搜索的其他术语，请在UI中将其设置为龚跟踪器（一次性，约30分钟，约20个术语）。然后使用 get_trackers + search_calls + get_call_summary 相反。跟踪器是服务器端的，成本大大降低，并且它们本身就具有表面计数和时间戳。使用 search_transcripts 对于临时的一次性。

成本保障： 大于30天的日期范围需要通过以下方式进一步缩小范围 primaryUserIds 或 domains6个月的无限制扫描将消耗API配额，并在架构级别被拒绝。

参数：

退货： 按呼叫分组的句子级别匹配，包括说话者姓名和隶属关系（如果可用）、匹配的关键字、时间戳（mm:ss）和句子片段。

列出所有关键字跟踪器定义，包括跟踪的短语、从属关系（其语音被跟踪）和过滤查询。解释中可见的跟踪器点击 get_call_summary 输出。

参数：

列出所有龚工作区及其ID和名称。在中使用这些ID作为筛选器 list_calls, search_calls, get_trackers以及其他工具。大多数公司都有1-3个工作区（例如，按地区或产品线）。

参数： 无

获取特定用户的个人资料，包括姓名、电子邮件、职务、电话和设置。可用于解析从呼叫数据返回的用户ID。

参数：

按ID或创建日期搜索和筛选用户。比更灵活 list_users 用于从呼叫数据中批量解析特定用户ID。

参数：

列出您工作区中的所有Gong用户。返回每个用户的姓名、电子邮件和标题。

参数：

列出工作区的所有公共Gong调用库文件夹。返回与一起使用的文件夹ID和名称 get_library_folder_calls。私人文件夹和存档文件夹不会返回。

参数：

获取保存在特定Gong库文件夹中的所有呼叫。返回剪辑的呼叫ID、标题、策展人注释和片段计时。呼叫ID可以直接传递给 get_call_summary 或 get_call_transcript.

参数：

返回Gong工作区中所有用户的markdown格式列表。可用于解析呼叫数据中的用户ID。

参数： 无