AI导哈

Gong通话数据接口服务

Gong MCP是一个将Gong通话数据暴露给Claude桌面的接口服务，提供通话列表、详情、转录、搜索和用户信息等功能。

  • by alroy
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 alroy/Gong-MCP

使用说明

龚MCP

向Claude Desktop公开Gong呼叫数据的MCP。PM信号智能系统的一部分。

它的作用

向克劳德展示五个工具：

  1. list_calls --按日期范围列出调用（龚的光标会自动分页）。返回呼叫ID、标题、日期、持续时间。
  2. get_call_details --为参与者提供姓名、头衔、电子邮件和内部/外部分类，以及主题和跟踪器。
  3. get_transcripts --获取按说话者分段并带有时间戳的完整成绩单。匹配 speakerId 针对参与者 get_call_details.
  4. 搜索呼叫 --在日期范围内的成绩单中搜索关键字。返回具有说话者和时间戳上下文的匹配片段。可选的 maxCalls （默认50，最大200）限制了扫描的呼叫数量。
  5. 用户名 --列出龚用户（id、姓名、电子邮件、职务）。用于将说话者ID映射到人。

先决条件

  • Node.js 18+
  • A Gong API密钥（访问密钥+密钥）。从您的Gong管理员处获取：Gong>设置>技术>API。

设置

1.安装依赖项

npm install

2.建造

npm run build

3.本地测试（可选）

GONG_ACCESS_KEY=your-access-key GONG_SECRET_KEY=your-secret-key npm start

服务器通过stdio（stdin/stdout）进行通信，因此您不会在终端中看到输出。它是由Claude Desktop开发的。

4.添加到克劳德桌面

打开克劳德桌面>设置>开发人员>应用程序配置文件。

将以下内容添加到 mcpServers section（如果不存在，则创建该节）：

{
  "mcpServers": {
    "gong": {
      "command": "node",
      "args": ["/absolute/path/to/gong-mcp-server/build/index.js"],
      "env": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

替换 /absolute/path/to/gong-mcp-server 使用机器上的实际路径。

5.重新启动克劳德桌面

保存配置后，重新启动Claude Desktop。Gong连接器应出现在“设置”>“连接器”中。

6.设置权限

在“设置”>“连接器”>“锣”中，设置工具权限：

  • list_calls： 允许
  • get_call_details： 允许
  • get_transcripts： 允许
  • 搜索呼叫： 允许
  • 用户名： 允许

Claude中的用法

连接后，克劳德可以直接使用龚工具：

"List all Gong calls from last week"
→ Claude calls list_calls with the date range

"Show me the transcript for call 1234567890"
→ Claude calls get_transcripts with the call ID

"Search for mentions of 'city manager' in Gong calls this month"
→ Claude calls search_calls with the query and date range

"Who was on the call with City of Durham on March 15?"
→ Claude calls get_call_details with the call ID

API费率限制

龚的API有价格限制。服务器以指数回退的方式重试429个响应，最多3次，遵守 Retry-After 当存在时。如果在大型回填过程中仍然看到速率限制错误，请减少 maxCalls 上 search_calls 或者缩小日期范围。

龚API参考

服务器使用这些Gong v2端点：

  • GET /v2/calls --按日期范围列出调用（光标分页）
  • POST /v2/calls/extensive --获取参与者的详细通话数据
  • POST /v2/calls/transcript --获取通话记录
  • GET /v2/users --列出用户（光标分页）

API完整文档：https://gong.app.gong.io/settings/api/documentation

故障排除

服务器未出现在Claude Desktop连接器中：

  • 检查配置中的路径是否绝对正确。
  • 核实一下 node 可从系统PATH访问。
  • 更改配置后重新启动Claude Desktop。

身份验证错误：

  • 验证GONG_ACCES_KEY和GONG_SECRET_KEY是否正确。
  • Gong API密钥使用基本身份验证（access_key:secret_key）。服务器自动处理编码。

空结果：

  • 检查日期范围格式（带时区的ISO 8601）。
  • 验证调用是否存在于龚UI中的指定范围内。
  • 一些Gong计划限制API访问。确认您的计划包括API访问。

速率限制错误：

  • 减少批量大小。这 search_calls 工具有一个 maxCalls 参数（默认值50）。
  • 缩小日期范围，这样分页的呼叫就更少了。

相关 MCP