Gong MCP

🚀 Gong MCP サーバー

Gong API へのアクセスを提供し、通話録音と文字起こしを取得するためのモデルコンテキストプロトコル (MCP) サーバーです。このサーバーにより、Claude は標準化されたインターフェースを通じて Gong データとやり取りできます。

✨ 主な機能

• Gong 通話を一覧表示し、日付範囲でのフィルタリングが可能
• 特定の通話の詳細な文字起こしを取得
• Gong の API 認証情報を使用した安全な認証
• Claude との統合を容易にする標準化された MCP インターフェース

📦 インストール

ローカル開発

1. リポジトリをクローンします。
2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

Docker

コンテナをビルドします。

docker build -t gong-mcp .

📚 ドキュメント

Claude の設定

1. Claude Desktop の設定を開きます。
2. MCP サーバーのセクションに移動します。
3. 新しいサーバーを追加し、以下のように設定します。

{
  "command": "docker",
  "args": [
    "run",
    "-it",
    "--rm",
    "gong-mcp"
  ],
  "env": {
    "GONG_ACCESS_KEY": "your_access_key_here",
    "GONG_ACCESS_SECRET": "your_access_secret_here"
  }
}

4. プレースホルダーの認証情報を、.env ファイルから取得した実際の Gong API 認証情報に置き換えます。

💻 使用例

基本的な使用法

通話の一覧表示

Gong 通話の一覧を、オプションの日付範囲でフィルタリングして取得します。

{
  name: "list_calls",
  description: "列出 Gong 通话，可选日期范围过滤。返回通话详细信息，包括 ID、标题、开始/结束时间、参与者和时长。",
  inputSchema: {
    type: "object",
    properties: {
      fromDateTime: {
        type: "string",
        description: "ISO 格式起始日期/时间（例如：2024-03-01T00:00:00Z）"
      },
      toDateTime: {
        type: "string",
        description: "ISO 格式结束日期/时间（例如：2024-03-31T23:59:59Z）"
      }
    }
  }
}

文字起こしの取得

指定された通話 ID の詳細な文字起こしを取得します。

{
  name: "retrieve_transcripts",
  description: "检索指定通话 ID 的转录。返回详细转录，包括说话人 ID、主题和时间戳句子。",
  inputSchema: {
    type: "object",
    properties: {
      callIds: {
        type: "array",
    }
  }
}

高度な使用法

高度なシナリオでは、上記の基本的な使用法を組み合わせることで、より複雑な操作を行うことができます。例えば、特定の日付範囲内の通話の文字起こしを一括で取得するなどです。

🔧 技術詳細

前提条件

• Node.js 18 以上
• Docker（コンテナ化デプロイ用、オプション）
• Gong API 認証情報（アクセスキーとシークレット）