Gongio MCP

龚MCP服务器

](https://www.npmjs.com/package/gongio-mcp) 

提供对Gong.io数据访问的MCP（模型上下文协议）服务器。直接从Claude或任何兼容MCP的客户端查询调用、转录、用户、关键字跟踪器等。

工具快速参考

先决条件

• Node.js 18+ 或 码头工人
• 龚API证书（访问密钥和秘密）

Getting API Credentials

1. 以管理员身份登录龚
2. 首选 公司设置 → 生态系统 → API
3. 点击 创建API密钥
4. 保存访问密钥和密钥（密钥只显示一次）

Installation

选项1:npx（无需安装）

npx gongio-mcp

选项2：全局npm安装

npm install -g gongio-mcp
gongio-mcp

选项3：来源

git clone https://github.com/JustinBeckwith/gongio-mcp.git
cd gongio-mcp
npm install
npm run build
node dist/index.js

选项4:Docker（本地构建）

git clone https://github.com/JustinBeckwith/gongio-mcp.git
cd gongio-mcp
docker build -t gongio-mcp .
docker run --rm -i \
  -e GONG_ACCESS_KEY=your-access-key \
  -e GONG_ACCESS_KEY_SECRET=your-secret-key \
  gongio-mcp

Configuration

将您的Gong凭据设置为环境变量：

export GONG_ACCESS_KEY="your-access-key"
export GONG_ACCESS_KEY_SECRET="your-secret-key"

或者将它们内联传递：

GONG_ACCESS_KEY=your-key GONG_ACCESS_KEY_SECRET=your-secret npx gongio-mcp

Client Setup

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

使用npx：

{
  "mcpServers": {
    "gong": {
      "command": "npx",
      "args": ["gongio-mcp"],
      "env": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_ACCESS_KEY_SECRET": "your-secret-key"
      }
    }
  }
}

使用Docker：

{
  "mcpServers": {
    "gong": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
               "-e", "GONG_ACCESS_KEY",
               "-e", "GONG_ACCESS_KEY_SECRET",
               "gongio-mcp"],
      "env": {
        "GONG_ACCESS_KEY": "your-access-key",
        "GONG_ACCESS_KEY_SECRET": "your-secret-key"
      }
    }
  }
}

克劳德代码

使用npx：

claude mcp add gong -e GONG_ACCESS_KEY=your-key -e GONG_ACCESS_KEY_SECRET=your-secret -- npx gongio-mcp

使用Docker（之后 docker build -t gongio-mcp .):

claude mcp add gong -e GONG_ACCESS_KEY=your-key -e GONG_ACCESS_KEY_SECRET=your-secret -- docker run --rm -i -e GONG_ACCESS_KEY -e GONG_ACCESS_KEY_SECRET gongio-mcp

可用工具

list_calls — List Gong calls with date filtering

列出具有可选日期范围和工作区筛选器的调用。返回最小调用元数据（ID、标题、日期、持续时间）。

参数：

get_call — Get metadata for a specific call

获取一次调用的URL、时间、方向、范围、系统和其他元数据。比...更快 get_call_summary 当你只需要调用元数据时。

参数：

get_call_summary — AI-generated call summary

获取人工智能生成的摘要，包括简要概述、要点、主题、行动项和详细大纲。这是理解调用的推荐方法——使用 get_call_transcript 只有当你需要精确的报价时。

参数：

get_call_transcript — Full speaker-attributed transcript

获取带有说话者归属的原始成绩单。转录被分页（默认10KB）以防止上下文溢出——使用 maxLength 和 offset 导航。

参数：

search_calls — Advanced call search

使用高级过滤器搜索通话。比更灵活 list_calls 用于有针对性的查询。

参数：

get_trackers — List keyword trackers

列出所有关键字跟踪器定义，包括跟踪的短语、从属关系（其语音被跟踪）和过滤查询。解释中可见的跟踪器点击 get_call_summary 输出。

参数：

list_workspaces — List all workspaces

列出所有龚工作区及其ID和名称。在中使用这些ID作为筛选器 list_calls, search_calls, get_trackers以及其他工具。大多数公司都有1-3个工作区（例如，按地区或产品线）。

参数： 无

get_user — Get a user's profile

获取特定用户的个人资料，包括姓名、电子邮件、职务、电话和设置。可用于解析从呼叫数据返回的用户ID。

参数：

search_users — Search users by filter

按ID或创建日期搜索和筛选用户。比更灵活 list_users 用于从呼叫数据中批量解析特定用户ID。

参数：

list_users — List all workspace users

列出您工作区中的所有Gong用户。返回每个用户的姓名、电子邮件和标题。

参数：

list_library_folders — List public call library folders

列出工作区的所有公共Gong调用库文件夹。返回与一起使用的文件夹ID和名称 get_library_folder_calls。私人文件夹和存档文件夹不会返回。

参数：

get_library_folder_calls — Get calls in a library folder

获取保存在特定Gong库文件夹中的所有呼叫。返回剪辑的呼叫ID、标题、策展人注释和片段计时。呼叫ID可以直接传递给 get_call_summary 或 get_call_transcript.

参数：

可用资源

gong://users — All workspace users

返回Gong工作区中所有用户的markdown格式列表。可用于解析呼叫数据中的用户ID。

参数： 无

示例提示

一旦连接到克劳德，你可以问：

• “列出我上周的龚电话”
• “获取呼叫123456789的详细信息”
• “显示呼叫摘要123456789”
• “获取789012通话记录”
• “龚有哪些工作空间？”
• “龚为竞争对手追踪哪些关键词？”
• “龚的图书馆文件夹叫什么？”
• “显示“最佳发现呼叫”库文件夹中的呼叫”
• “我们龚工作区的用户都是谁？”
• “搜索Justin（用户ID 232255198215877499）在2025年7月主持的呼叫”
• 查找这些用户ID:111222333

贡献

有兴趣贡献吗？结账 贡献.md 用于开发设置、测试说明和指南。

存储库包括 gong-openapi.json -Gong API OpenAPI规范的本地副本。在添加新工具时，它可以作为参考：使用它在不离开编辑器的情况下查找端点路径、参数名称和响应形状。最新规范可从以下网址下载 龚API文件.