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、标题、日期、时长）。

参数：

获取单次通话的 URL、时间、方向、范围、系统及其他元数据。只需要通话元数据时，此工具比 get_call_summary 更快。

参数：

获取 AI 生成的摘要，包括简要概述、要点、主题、行动项和详细大纲。这是了解通话内容的推荐方式——只有需要准确引述时才使用 get_call_transcript。

参数：

获取带有发言者归属信息的原始转录文本。转录文本采用分页方式（默认 10 KB），以防止上下文溢出——使用 maxLength 和 offset 浏览内容。

参数：

使用高级筛选条件搜索通话，包括参与者查询、客户名称搜索和丰富的内容选择。自动遍历所有结果，默认返回参与者信息、简要摘要和主题。

参数：

日期和工作区

主持人 / 参与者

内容和客户

元数据

响应结构

include 选项：

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

筛选行为说明：

• 筛选条件采用 AND 逻辑组合。primaryUserIds + participantUserIds 会共同生效：主用户筛选在服务端进行，参与者筛选在之后进行。
• customerName 会匹配以下任一项：CRM 账户的 Name 字段、外部参与者的邮箱域名，或通话标题（不区分大小写的子字符串匹配）。
• trackers 名称因工作区而异——先调用 get_trackers 查看已配置的追踪器。匹配采用不区分大小写的子字符串方式（因此，"competitor" 会同时匹配 "Competitors" 和 "Competitor Mentions"）。
• 设置 trackers 筛选条件后，相关追踪器内容会自动包含在结果中，且输出只显示你指定的追踪器。不设置筛选条件时，只显示计数非零的追踪器。
• 没有匹配结果时会返回 "No calls found"，而不是错误。

有关大结果的回退处理方式，请参阅响应大小和上下文限制。

通过匹配外部参与者的电子邮件域名，查找涉及特定账户或公司的通话。Gong API 原生不支持按账户名称筛选（这是一个已知的缺陷）——此工具会获取指定日期范围内的通话，然后按 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"] 是最精确的选项
• Opportunity 名称具有描述性（例如 "Acme Q4 Renewal"），且你想通过模糊匹配查找已重命名或重复的 Opportunity

参数：

成本说明： 使用与 search_calls_by_account 相同的先获取数据再筛选模式。CRM 上下文查询不会增加 API 调用——它会复用同一个 /v2/calls/extensive 请求，并设置 context: "Extended"。

在限定日期范围内，对通话转录文本中的句子进行自由文本关键词搜索。分两个阶段执行：(1) /v2/calls/extensive 按日期和可选的 primaryUserIds / domains 缩小通话范围；(2) /v2/calls/transcript 获取缩小范围内的转录文本，并返回包含发言者归属信息和时间戳的句子级匹配结果。

对于需要重复搜索的词语，优先使用 Gong Trackers。 对于竞争对手名称、ESP/技术术语（Klaviyo、Braze、Iterable、Postscript、Attentive、Sendgrid、Customer.io 等）以及其他你会反复搜索的词语，可在界面中将其设置为 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 或创建日期搜索和筛选用户。与 list_users 相比，它更适合批量解析通话数据中的指定用户 ID。

参数：

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

参数：

列出某个工作区中所有公开的 Gong 通话库文件夹。返回可与 get_library_folder_calls 配合使用的文件夹 ID 和名称。不返回私有文件夹和已归档文件夹。

参数：

获取保存在指定 Gong 库文件夹中的所有通话。返回通话 ID、标题、整理者备注，以及片段的时间信息。通话 ID 可直接传递给 get_call_summary 或 get_call_transcript。

参数：

返回 Gong 工作区中所有用户的 Markdown 格式列表。可用于查找通话数据中的用户 ID 对应的用户。

**参数：**无