使用说明

Gong MCP 服务器

一个模型上下文协议（MCP）服务器，通过它可访问Gong通话和数据工具（用于搜索）和资源（用于直接访问）。

特点/特性

灵活的呼叫搜索 通过（某种方式/途径） search_calls 带有全面过滤功能的工具
直接数据访问 通过资源（转录本、用户、状态）
分页支持 使用基于光标的导航
双运输模式stdio（默认）和适用于基于网页的客户端的Streamable HTTP
使用官方的Rust MCP SDK（rmcp v0.8）构建
支持Docker容器以实现轻松部署

先决条件

公开API凭据（访问密钥和访问密钥密钥）
您组织的 Gong 基础 URL

配置

服务器需要以下环境变量：

GONG_BASE_URL您的Gong API基础URL（例如。， https://api.gong.io)
GONG_ACCESS_KEY您的Gong API访问密钥
GONG_ACCESS_KEY_SECRET您的Gong API访问密钥

运输方式

服务器支持两种传输模式：

stdio（默认）

Stdio 传输使用标准输入/输出进行通信。这是默认模式，适用于：

Claude Desktop 集成
本地CLI使用
基于进程的MCP客户端

HTTP（可流式传输的HTTP）

Streamable HTTP传输为Web客户端提供了符合规范的基于HTTP的通信方式。请使用此模式来：

基于网络的应用程序
远程访问场景
云部署
支持现代的HTTP/2和HTTP/3协议

命令行界面选项：

--mode <stdio|http> - 选择传输模式（默认：stdio）
--host <address> - 在HTTP模式下绑定的主机（默认：127.0.0.1，或在Docker中为0.0.0.0）
--port <port> - HTTP模式下绑定的端口（默认：8080）

示例：

# Stdio mode (default)
gong-mcp

# HTTP mode on localhost
gong-mcp --mode http --host 127.0.0.1 --port 8080

# HTTP mode for remote access
gong-mcp --mode http --host 0.0.0.0 --port 8080

HTTP 端点：

http://<host>:<port>/mcp - 可流式传输的HTTP端点（MCP规范2025-03-26）

安装

使用 Docker（推荐）

从GitHub容器注册表中拉取预构建的镜像：

docker pull ghcr.io/cedricziel/gong-mcp:latest

运行容器：

标准I/O模式（适用于Claude桌面版，默认模式）：

docker run -i --rm \
  -e GONG_BASE_URL="https://api.gong.io" \
  -e GONG_ACCESS_KEY="your-access-key" \
  -e GONG_ACCESS_KEY_SECRET="your-secret" \
  ghcr.io/cedricziel/gong-mcp:latest

HTTP模式（用于网页客户端）：

docker run -d \
  -p 8080:8080 \
  -e GONG_BASE_URL="https://api.gong.io" \
  -e GONG_ACCESS_KEY="your-access-key" \
  -e GONG_ACCESS_KEY_SECRET="your-secret" \
  ghcr.io/cedricziel/gong-mcp:latest \
  --mode http --host 0.0.0.0 --port 8080

然后连接到 http://localhost:8080/mcp 来自您的网页客户端。

来自来源

构建：

cargo build --release

在标准I/O模式下运行：

GONG_BASE_URL="https://api.gong.io" \
GONG_ACCESS_KEY="your-access-key" \
GONG_ACCESS_KEY_SECRET="your-secret" \
./target/release/gong-mcp

在HTTP模式下运行：

GONG_BASE_URL="https://api.gong.io" \
GONG_ACCESS_KEY="your-access-key" \
GONG_ACCESS_KEY_SECRET="your-secret" \
./target/release/gong-mcp --mode http --host 127.0.0.1 --port 8080

与Claude Desktop配合使用

在您的Claude桌面配置文件中添加以下内容：

macOS（发音：/ˈmækɒs/，中文常称为“苹果电脑操作系统”或简称为“苹果系统”）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gong": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GONG_BASE_URL=https://api.gong.io",
        "-e",
        "GONG_ACCESS_KEY=your-access-key",
        "-e",
        "GONG_ACCESS_KEY_SECRET=your-secret",
        "ghcr.io/cedricziel/gong-mcp:latest"
      ]
    }
  }
}

Windows

编辑 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "gong": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GONG_BASE_URL=https://api.gong.io",
        "-e",
        "GONG_ACCESS_KEY=your-access-key",
        "-e",
        "GONG_ACCESS_KEY_SECRET=your-secret",
        "ghcr.io/cedricziel/gong-mcp:latest"
      ]
    }
  }
}

Linux

编辑 ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gong": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GONG_BASE_URL=https://api.gong.io",
        "-e",
        "GONG_ACCESS_KEY=your-access-key",
        "-e",
        "GONG_ACCESS_KEY_SECRET=your-secret",
        "ghcr.io/cedricziel/gong-mcp:latest"
      ]
    }
  }
}

与Claude代码（Cursor IDE）一起使用

在你的Cursor设置中添加：

打开光标设置
导航至MCP服务器
添加一个新的服务器配置：

{
  "gong": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "GONG_BASE_URL=https://api.gong.io",
      "-e",
      "GONG_ACCESS_KEY=your-access-key",
      "-e",
      "GONG_ACCESS_KEY_SECRET=your-secret",
      "ghcr.io/cedricziel/gong-mcp:latest"
    ]
  }
}

可用功能

一旦配置完成，服务器将提供：

工具

search_calls - 灵活的呼叫搜索功能，可选过滤器：

from_date_time (字符串)：ISO 8601 格式的开始日期
to_date_time (字符串)：ISO 8601格式的结束日期
workspace_id (字符串): 按工作区过滤
call_ids (数组)：特定的呼叫ID
primary_user_ids (数组): 按用户/主机过滤
cursor (字符串): 分页游标

所有参数均为可选。返回的调用支持分页。

资源

静态：

gong://status - 配置状态和健康检查
gong://users - 您的 Gong 工作区中的用户列表

动态（模板）：

gong://calls/{callId}/transcript - 获取特定通话的文字记录

使用示例

查找通话记录

请Claude使用自然语言搜索通话记录：

“给我看看上周的来电记录”
“查找用户ID为12345在1月份参与的通话”
“接收来自工作区W789的来电”

克劳德将使用 search_calls 带有适当参数的工具：

{
  "name": "search_calls",
  "arguments": {
    "from_date_time": "2024-01-01T00:00:00Z",
    "to_date_time": "2024-01-31T23:59:59Z",
    "primary_user_ids": ["12345"]
  }
}

获取成绩单

一旦从搜索结果中获得了通话ID，请请求通话记录：

“给我看看通话ABC123的记录。”

克劳德将访问： gong://calls/ABC123/transcript

发展

建筑

cargo build

测试

cargo test

本地运行

标准I/O模式（默认）：

GONG_BASE_URL="https://api.gong.io" \
GONG_ACCESS_KEY="your-access-key" \
GONG_ACCESS_KEY_SECRET="your-secret" \
cargo run

HTTP 模式：

GONG_BASE_URL="https://api.gong.io" \
GONG_ACCESS_KEY="your-access-key" \
GONG_ACCESS_KEY_SECRET="your-secret" \
cargo run -- --mode http --host 127.0.0.1 --port 8080

寻求帮助：

cargo run -- --help

依赖项

gong-rs 翻译为中文可以是“龚-瑞斯”（假设这是一个人名或特定名称的拼音），但具体翻译可能因上下文或特定命名规则而有所不同。如果“gong-rs”是某个特定领域或技术中的术语，可能需要更具体的翻译或解释。在没有更多上下文的情况下，“龚-瑞斯”是一个合理的翻译假设 - Gong API的Rust客户端库
rmcp - Model Context Protocol 的官方 Rust SDK

许可证

Apache-2.0（Apache许可证第2版）