使用说明

项目简介

Gong MCP Server 是一个桥梁，它连接了自然语言模型客户端（如 Claude）和 Gong 销售智能平台。通过实现 Model Context Protocol (MCP)，该服务器允许 LLM 安全、可控地访问 Gong 中存储的销售对话数据。这使得 LLM 能够利用真实的客户对话数据，执行如对话分析、内容总结、销售技巧学习等任务，从而提升销售效率和效果。

主要功能点

列出 Gong 通话记录: 允许 LLM 客户端查询指定日期范围内的 Gong 通话列表，返回通话 ID、标题、起止时间、参与者和时长等基本信息。
检索通话记录文本: 允许 LLM 客户端根据通话 ID 获取详细的 Gong 通话文本记录，包括发言人 ID、主题、带时间戳的句子等，为深入分析对话内容提供数据基础。
安全认证: 使用 Gong API 密钥进行安全认证，确保只有授权的 LLM 客户端才能访问 Gong 数据。
标准化 MCP 接口: 遵循 MCP 协议标准，易于集成到任何支持 MCP 协议的 LLM 客户端，例如 Claude。

安装步骤

克隆仓库

git clone https://github.com/kenazk/gong-mcp.git
cd gong-mcp

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下是 Claude Desktop 客户端的 MCP 服务器配置示例，其他 MCP 客户端的配置方式类似。

在 Claude Desktop 设置中，找到 MCP Servers 部分，点击 "Add Server" 添加一个新的服务器，配置信息如下：

{
  "command": "docker",
  "args": [
    "run",
    "-it",
    "--rm",
    "gong-mcp"
  ],
  "env": {
    "GONG_ACCESS_KEY": "your_gong_access_key",  // 替换为您的 Gong API Access Key
    "GONG_ACCESS_SECRET": "your_gong_access_secret" // 替换为您的 Gong API Access Secret
  }
}

配置参数说明:

command: 运行 MCP 服务器的命令。这里配置为 'docker'，表示使用 Docker 镜像运行服务器。如果本地直接运行 Node.js 服务，可以配置为 'node'。
args: 'command' 命令的参数列表。
- 如果 'command' 配置为 'docker'，则 'args' 配置为 '["run", "-it", "--rm", "gong-mcp"]'，表示运行名为 'gong-mcp' 的 Docker 镜像。
- 如果 'command' 配置为 'node'，则 'args' 可以配置为 '["dist/index.js"]'，表示运行编译后的 'index.js' 文件。
env: 环境变量配置。
- GONG_ACCESS_KEY: Gong API 的 Access Key，用于身份验证，请替换为您的真实 Access Key。
- GONG_ACCESS_SECRET: Gong API 的 Access Secret，用于签名请求，请替换为您的真实 Access Secret。

注意: 请务必将 'your_gong_access_key' 和 'your_gong_access_secret' 替换为您在 Gong 平台申请的 API 密钥。您可以通过 Gong 开发者平台获取这些密钥。建议将密钥配置在 '.env' 文件中，并确保 '.env' 文件不被提交到代码仓库中，以保障安全。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，即可通过以下工具与 Gong MCP Server 交互：

list_calls: 列出 Gong 通话记录。
- 可选参数:
  - 'fromDateTime': 起始日期时间，ISO 格式 (例如: "2024-03-01T00:00:00Z")，用于筛选起始时间之后的通话记录。
  - 'toDateTime': 结束日期时间，ISO 格式 (例如: "2024-03-31T23:59:59Z")，用于筛选结束时间之前的通话记录。
- 客户端将收到包含通话记录 JSON 数据的响应。
retrieve_transcripts: 检索通话记录文本。
- 必选参数:
  - 'callIds': 通话 ID 数组，指定需要获取文本记录的通话 ID 列表。
- 客户端将收到包含通话文本记录 JSON 数据的响应。

LLM 客户端可以根据这些工具的描述和参数，生成符合 MCP 协议的请求，并发送给 Gong MCP Server。服务器会处理请求，调用 Gong API 获取数据，并将结果以 MCP 协议规定的格式返回给客户端。LLM 即可利用这些数据进行后续的自然语言处理任务。

关键词