龚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次请求/秒限制
帐户匹配
服务器使用三层方法匹配对帐户的调用（按此顺序选中）：
- 通话标题 --将帐户筛选器与通话标题相匹配（例如，“Acme\<>YourCompany”匹配“Acme”）
- CRM帐户 --在龚的CRM上下文中与HubSpot/Salesforce帐户名或网站匹配
- 参与者电子邮件/公司 --与参与者电子邮件域或公司名称匹配
所有匹配都不区分大小写。您可以使用公司名称("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实例可以跟随它在您的计算机上设置服务器。
快速版本：
- 复制
gong_mcp.py和requirements.txt到~/Documents/MCP/ - 创建Python venv并安装依赖项
- 从您的Gong管理员处获取您的Gongneneneba API证书
- 配置您的Claude客户端（Claude代码、桌面或协作）
- （仅限协作）从以下位置安装技能
skill/SKILL.md - 重新启动克劳德
使用示例
安装后，自然地问克劳德：
- “提取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 到明天，不是今天 |