内容
<p align="center">
<img src="assets/social-preview.png" alt="Gong MCP — 全表面 Gong API 网关，适用于 Claude" width="820">
</p>
<h1 align="center">Gong MCP</h1>
<p align="center">
<b>适用于 <a href="https://www.gong.io">Gong</a> API 的全表面 <a href="https://modelcontextprotocol.io">模型上下文协议</a> 服务器。</b><br>
跨通话、转录、用户、活动、记分卡、辅导和 CRM 的 20 种工具。只需单击一下即可安装到 Claude Desktop。
</p>
<p align="center">
<a href="https://github.com/scandolo/gong-mcp/actions/workflows/ci.yml"><img src="https://github.com/scandolo/gong-mcp/actions/workflows/ci.yml/badge.svg" alt="持续集成"></a>
<img src="https://img.shields.io/badge/tools-20-7c5cff" alt="20 种工具">
<img src="https://img.shields.io/badge/MCP-server-6a4bff" alt="MCP 服务器">
<a href="./LICENSE"><img src="https://img.shields.io/github/license/scandolo/gong-mcp" alt="MIT 许可证"></a>
</p>
---
## ⬇️ 在 Claude Desktop 中安装（单击安装，无需终端）
如果您使用 **Claude Desktop** 应用程序，这是一个简单的路径。无需 Node.js，无需 JSON，无需命令行。
<p>
<a href="https://github.com/scandolo/gong-mcp/releases/latest/download/gong-mcp.mcpb">
<img src="https://img.shields.io/badge/⬇%20下载%20Gong%20MCP%20扩展-.mcpb-7c5cff?style=for-the-badge" alt="下载 Gong MCP 扩展">
</a>
</p>
1. **[下载 `gong-mcp.mcpb`](https://github.com/scandolo/gong-mcp/releases/latest/download/gong-mcp.mcpb)**（单个文件）。
2. **双击它**（或在 Claude Desktop 中前往 **设置 → 扩展 → 安装扩展…** 并选择该文件）。
3. 当提示时，粘贴您的 **Gong 基本 URL**、**访问密钥** 和 **访问密钥秘密**（参见 [获取您的 Gong 凭证](#获取您的gong凭证)），然后单击 **安装**。
就这样。询问 Claude *"列出我的 Gong 工作区"* 以确认它已连接。
<p align="center">
<img src="assets/demo.gif" alt="Claude 使用 Gong MCP 拉取通话记录并总结续约风险" width="720">
</p>
> 偏好 Claude Code / Cursor / 终端？跳转到 [在 Claude Code 中安装](#在claude-code中安装)。
---
## Gong MCP 与官方 Gong MCP
Gong 在 `mcp.gong.io` 上提供了一个官方托管的 MCP 服务器。它是一个用于不同任务的不同工具：三个 AI 工具，返回生成的答案和简报。该存储库公开原始 Gong REST API，因此您可以获取底层数据并在此基础上构建自己的分析。
| | 官方 Gong MCP (`mcp.gong.io`) | 本存储库 (`gong-mcp`) |
|---|---|---|
| 工具 | 3 (`ask_account`, `ask_deal`, `generate_brief`) | 20（原始 REST API 接口） |
| 返回 | AI 生成的答案和简报 | 原始数据：转录、通话、用户、活动、记分卡、辅导、CRM |
| 原始转录 / 通话列表 | 不返回 | 是 |
| 粒度 | 账户和交易 | 通话、用户、工作区、CRM |
| 托管 | Gong 托管的远程连接器 | 自托管，在本地运行 |
| 认证和设置 | 管理员创建 MCP 集成，MCP 范围，客户端 ID/密钥 | 您自己的 Gong API 密钥和密钥 |
| 成本 | 消耗 Gong 积分 | 免费（您的正常 API 配额） |
| Claude 计划 | Pro/Max/Team/Enterprise（自定义远程连接器） | 任意（本地标准输入/输出服务器） |
经验法则：对于快速的 AI 简报，使用官方服务器，无需任何基础设施；当您需要原始转录、通话和活动数据，或基于整个 API 构建自己的分析时，请使用此服务器。
---
## 工具
| 工具 | 它做什么 |
|---|---|
| `list_workspaces` | 列出 Gong 工作区 / 确认身份验证。 |
| `list_calls` | 在日期范围内列出通话（轻量级元数据）。 |
| `get_call` | 按 ID 获取单个通话的元数据。 |
| `list_calls_extensive` | 丰富的通话数据：内容、参与者、统计数据、CRM 上下文。 |
| `get_transcripts` | 单字级通话记录。 |
| `list_library_folders` | 列出工作区的库文件夹。 |
| `get_library_folder_content` | 列出库文件夹中的通话。 |
| `list_users` | 列出所有 Gong 用户。 |
| `get_user` | 按 Gong ID 获取单个用户。 |
| `get_users_extensive` | 按 ID 或电子邮件批量查找用户。 |
| `get_activity_aggregate` | 按用户汇总活动总量。 |
| `get_activity_by_period` | 按用户和时间段查看活动。 |
| `get_activity_day_by_day` | 按用户和每天查看活动。 |
| `get_interaction_stats` | 销售人员互动质量统计。 |
| `list_scorecards` | 列出记分卡模板。 |
| `get_answered_scorecards` | 实际已回答的记分卡。 |
| `get_coaching_metrics` | 经理辅导指标。 |
| `get_manual_crm_associations` | 手动通话到 CRM 关联。 |
| `list_crm_integrations` | 列出 CRM 集成。 |
| `get_crm_entities` | 读取自定义集成 CRM 对象。 |
---
## 获取您的 Gong 凭证
1. 在 Gong 中，前往 **公司设置 → API**。
2. 点击 **获取 API 密钥**（需要技术管理员角色）。
3. 复制 **访问密钥** 和 **访问密钥秘密**。
4. 记下您的 **工作区主机**（区域特定），类似于 `https://us-XXXXX.api.gong.io`。它与您的 API 密钥一起在 Gong 中显示。如果留空，服务器将回退到 `https://api.gong.io`。
> 凭证从环境变量（`GONG_ACCESS_KEY`、`GONG_ACCESS_SECRET`、`GONG_BASE_URL`）或 Claude Desktop 安装对话框中读取。没有任何内容被硬编码，也没有任何内容被提交到此存储库中。
---
## 在 Claude Code 中安装
适用于 CLI / 终端代理（和 Cursor，或任何 MCP 客户端）。
```bash
git clone https://github.com/scandolo/gong-mcp.git
cd gong-mcp
npm install
# 在 Claude Code 中注册服务器（用户范围）
claude mcp add gong node "$(pwd)/server/index.js" \
--scope user \
--env GONG_BASE_URL=https://us-XXXXX.api.gong.io \
--env GONG_ACCESS_KEY=您的访问密钥 \
--env GONG_ACCESS_SECRET=您的访问密钥秘密
```
或直接将其添加到 `~/.claude.json` 中的 `mcpServers` 下：
```json
{
"mcpServers": {
"gong": {
"command": "node",
"args": ["/绝对路径/到/gong-mcp/server/index.js"],
"env": {
"GONG_BASE_URL": "https://us-XXXXX.api.gong.io",
"GONG_ACCESS_KEY": "您的访问密钥",
"GONG_ACCESS_SECRET": "您的访问密钥秘密"
}
}
}
}
```
重启 Claude Code 并要求它运行 `list_workspaces` 以确认身份验证。
**复制粘贴提示（Claude Code）：** 将此内容粘贴到 Claude Code 会话中，填写三个值。
```text
在该 Claude Code 环境中为我设置 Gong MCP 服务器（https://github.com/scandolo/gong-mcp）。执行以下操作：
1. 将 https://github.com/scandolo/gong-mcp 克隆到 ~/code/gong-mcp（或告诉我它是否已存在），然后在其中运行 `npm install`。
2. 使用 `claude mcp add` 在用户范围内注册它，并使用以下环境变量：
GONG_BASE_URL=<粘贴您的主机，例如 https://us-XXXXX.api.gong.io>
GONG_ACCESS_KEY=<粘贴您的 Gong 访问密钥>
GONG_ACCESS_SECRET=<粘贴您的 Gong 访问密钥秘密>
3. 使用 `claude mcp list` 验证服务器是否已注册。
4. 告诉我重启 Claude Code，然后通过调用 `list_workspaces` 工具确认其有效。
请勿将我的访问密钥或秘密打印回给我，也不要将它们写入任何跟踪/提交的文件中。
```
### 自己构建 Claude Desktop 包
预构建的 `.mcpb` 文件附在每个 [发布](https://github.com/scandolo/gong-mcp/releases/latest) 中。要从源代码构建：
```bash
npm install
npx @anthropic-ai/mcpb pack # 生成 gong-mcp.mcpb
```
---
## 配置
| 环境变量 | 必需 | 默认值 | 备注 |
|---|---|---|---|
| `GONG_ACCESS_KEY` | 是 | — | Gong API 访问密钥。 |
| `GONG_ACCESS_SECRET` | 是 | — | Gong API 访问密钥秘密。 |
| `GONG_BASE_URL` | 否 | `https://api.gong.io` | 您的工作区特定主机，例如 `https://us-XXXXX.api.gong.io`。 |
身份验证使用 HTTP 基本身份验证（`AccessKey:Secret`，base64 编码），与 Gong REST API 期望的一样。客户端在瞬时错误和速率限制时重试，并带有指数退避。
## 要求
- Node.js >= 18（与 Claude Desktop 捆绑；为 Claude Code 单独安装）
- 具有 API 访问权限的 Gong 席位（技术管理员颁发密钥）
## 贡献
欢迎提出问题和 PR，特别是当 API 增长时添加额外的 Gong 端点。请参阅问题模板以报告问题。
## 许可证
[MIT](./LICENSE)
---
<sub>关键词：Gong MCP、Gong MCP 服务器、Gong API MCP、Gong 模型上下文协议、Gong API 网关、Gong Claude 集成、Gong Claude Desktop 扩展、Gong 会话智能 MCP、Gong REST API 包装器、RevOps MCP、销售智能 MCP。</sub>
