Genesys Cloud MCP Server

Genesys Cloud MCP サーバー

Genesys Cloud の Platform API 用 Model Context Protocol（MCP）サーバーです。

機能

ツール	説明
キューを検索	名前でキューを検索します（ワイルドカードに対応）
キューのボリュームをクエリ	キュー ID による会話数とメンバー数を取得します
キュー別の会話サンプル	キュー ID の代表的な会話 ID のサンプルを取得します
音声通話品質	1 件以上の会話を ID で指定し、音声通話品質のメトリクスを取得します
会話のセンチメント	1 件以上の会話を ID で指定し、センチメントを取得します
会話のトピック	会話 ID のトピックを取得します
音声会話を検索	任意の条件で音声会話を検索します
会話のトランスクリプト	会話のトランスクリプトを取得します
OAuth クライアント	すべての OAuth クライアントの一覧を取得します
OAuth クライアントの使用状況	指定期間の OAuth クライアントの使用状況を取得します

Claude Desktop での使用方法

MCP バンドル

この MCP サーバーは、各リリースに、Claude Desktop にワンクリックでインストールできるパッケージである MCP バンドル（.mcpb ファイル）を同梱しています。使用するには、次の手順を行ってください。

1. 最新リリースから .mcpb ファイルをダウンロードします
2. Claude Desktop で「設定」>「拡張機能」に移動します。
3. .mcpb ファイルを Claude で開きます
4. 拡張機能のリージョンと OAuth クライアントを設定します

これで、会話でこの拡張機能を利用できるようになります。

NPX

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "genesys-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@makingchatbots/genesys-cloud-mcp-server"],
      "env": {
        "GENESYSCLOUD_REGION": "<PUT REGION HERE>",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "<PUT OAUTHCLIENT ID HERE>",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "<PUT OAUTHCLIENT SECRET HERE>"
      }
    }
  }
}

Gemini CLI での使用方法

.gemini/settings.json ファイルに以下を追加します。公式ガイドのセットアップ方法も参照してください。

{
  "mcpServers": {
    "genesysCloud": {
      "command": "npx",
      "args": ["-y", "@makingchatbots/genesys-cloud-mcp-server"],
      "env": {
        "GENESYSCLOUD_REGION": "${GENESYSCLOUD_REGION}",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "${GENESYSCLOUD_OAUTHCLIENT_ID}",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "${GENESYSCLOUD_OAUTHCLIENT_SECRET}"
      }
    }
  }
}

認証

現在、stdio サーバーのみをサポートしています。認証を設定するには、次の手順が必要です。

1. Genesys Cloud で OAuth クライアントを作成します
2. 使用するツールに必要な権限を割り当てます
3. サーバーを参照するときに、次の環境変数を指定します。
   • GENESYSCLOUD_REGION
   • GENESYSCLOUD_OAUTHCLIENT_ID
   • GENESYSCLOUD_OAUTHCLIENT_SECRET

開発

はじめに

nvm use
npm install
npm run dev

活発に開発中

これは、対話型のビジネスインサイトツールを作成するための個人プロジェクトの一部です。MCP サーバーについて学び、Genesys Cloud のプラットフォーム API を LLM が簡単に利用できる形で表現する最善の方法を学ぶための、実践的な取り組みです。

今後、多くの変更を加える予定です。また、学んだことをニュースレターで共有していきます。