AI导哈

Gong通话记录服务器

一个本地MCP服务器，通过自然语言对话连接Claude与Gong实例，实现通话记录查询和导出功能。

  • by austinsomer
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 austinsomer/gong-mcp-server

使用说明

龚MCP服务器（V2）

一个本地MCP（模型上下文协议）服务器，将Claude连接到您的Gong实例。按帐户名提取通话记录，列出通话记录，并将完整记录导出到文件中——所有这些都是通过自然对话完成的。

适用于 克劳德代码, 克劳德桌面版，以及 克劳德协作.

此回购中有什么

文件/文件夹 目的
gong_mcp.py MCP服务器（V2——并发取数，平面工具参数）
requirements.txt Python依赖关系
claude_desktop_config.template.json Claude Desktop的模板配置
install-process.md 分步设置指南（对Claude友好——Claude实例可以遵循）
skill/SKILL.md 共同工作技能档案——教克劳德如何有效地使用锣工具
.gitignore 使凭据和venv不受版本控制

可用工具

工具 说明
gong_list_calls 使用基本元数据（ID、标题、时间、持续时间）在日期范围内列出呼叫
gong_get_call 获取特定通话的详细元数据（参与者、CRM上下文、媒体）
gong_get_transcripts 提取特定呼叫ID的转录（受25K字符响应限制）
gong_list_calls_extensive 列出包含完整参与者详细信息、交互统计数据和CRM上下文的通话
gong_get_account_transcripts 查找并返回特定账户的成绩单（受25K字符响应限制）
gong_export_account_transcripts 将帐户的完整、未截断的成绩单导出到磁盘上的标记文件

这 导出工具 是主要的工作流工具。它扫描日期范围内的所有通话，将其与帐户相匹配，并将完整的记录写入磁盘。

V2改进

V2在性能和兼容性方面比V1有了重大升级：

  • 并发日期块获取 --将大日期范围拆分为10天的块，并通过以下方式并行获取它们 asyncio.gather，在大范围内实现了约95%的快速发现
  • 平刀参数 --所有工具函数都接受单独的命名参数，而不是包装好的Pydantic模型，这修复了与Cowork和其他将参数作为平面键值对传递的MCP客户端的兼容性
  • 标题优先帐户匹配 --在CRM数据之前检查通话标题（最便宜的先检查，最常见的匹配）
  • 连接池 --重复使用持久性 httpx.AsyncClient 跨请求
  • 速率限制 — asyncio.Semaphore(3) 匹配龚的3次请求/秒限制

帐户匹配

服务器使用三层方法匹配对帐户的调用（按此顺序选中）：

  1. 通话标题 --将帐户筛选器与通话标题相匹配（例如，“Acme<>YourCompany”匹配“Acme”）
  2. CRM帐户 --在龚的CRM上下文中与HubSpot/Salesforce帐户名或网站匹配
  3. 参与者电子邮件/公司 --与参与者电子邮件域或公司名称匹配

所有匹配都不区分大小写。您可以使用公司名称("Acme")，域("acme.com")，或部分匹配("acme").

输出结构

导出的成绩单另存为：

~/Documents/Transcripts/
  +-- {account_name}/
      |-- 2026-03-02_Call_Title_Here.md
      |-- 2026-03-10_Another_Call.md
      +-- _combined_transcripts.md

每个文件都包括通话元数据（日期、持续时间、参与者、龚链接），后面是标有完整说话者的记录。合并文件包含一个文档中的所有成绩单。

需求

  • Python 3.10+
  • Claude Code、Claude Desktop或Claude Cowork
  • Gong API凭证（访问密钥+访问密钥机密），作用域：
    • api:calls:read:basic
    • api:calls:read:extensive
    • api:calls:read:transcript

设置

看 安装过程.md 获取完整的分步指南。编写该文档是为了让Claude实例可以跟随它在您的计算机上设置服务器。

快速版本：

  1. 复制 gong_mcp.py 和 requirements.txt 到 ~/Documents/MCP/
  2. 创建Python venv并安装依赖项
  3. 从您的Gong管理员处获取您的Gongneneneba API证书
  4. 配置您的Claude客户端（Claude代码、桌面或协作）
  5. （仅限协作）从以下位置安装技能 skill/SKILL.md
  6. 重新启动克劳德

使用示例

安装后，自然地问克劳德：

  • “提取Acme Corp过去3个月的成绩单”
  • “导出2月份以来的所有Notion通话记录”
  • “将最后5个TraceLink调用保存到我的桌面”
  • “列出上周的所有电话”
  • “获取呼叫ID 1234567890的记录”

速率限制

龚API默认：3个请求/秒，10000个请求/天。服务器自动处理分页，并将大日期范围分块到同时获取的10天窗口中。

故障排除

问题 解决方案
刀具超时错误 日期范围太大；尝试更短的距离
身份验证错误 验证配置中的访问密钥和密码
未找到呼叫 请尝试更广泛的帐户筛选器（公司名称、电子邮件域或部分匹配）。为精确起见，请使用电子邮件域。
找不到模块 重新运行 pip install -r requirements.txt 在venv里面
工具未出现 重新启动克劳德代码/桌面/协作；用于桌面和协作 Cmd+Q
Pydantic验证错误 您可能正在运行V1。替换 gong_mcp.py 使用此仓库中的V2文件。
当天电话丢失 已设置 to_date_time 到明天，不是今天

相关 MCP