Genesys Cloud MCP Server

Genesys Cloud平台API的模型上下文协议（MCP）服务器。

功能

工具	描述
搜索队列	按名称搜索队列（支持通配符）
查询队列容量	根据队列ID检索对话量和成员数
按队列抽样对话	根据队列ID检索代表性对话ID样本
语音通话质量	根据ID检索一个或多个对话的语音通话质量指标
对话情感分析	根据ID检索一个或多个对话的情感分析
对话主题	根据ID检索对话的主题
搜索语音对话	根据可选标准搜索语音对话
对话记录	检索对话记录

与Claude Desktop一起使用

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>"
      }
    }
  }
}

MCP捆绑包

此MCP服务器提供了一个MCP捆绑包（.mcpb文件），随每个发布版本一起提供，这是一个单击即可安装的Claude Desktop扩展包。要使用它：

1. 从最新发布版本下载.mcpb文件。
2. 在Claude Desktop中导航到设置 > 扩展。
3. 浏览或拖放下载的.mcpb文件。
4. 点击“安装”。
5. 配置扩展的区域和OAuth客户端。

现在，该扩展将在您的对话中可用。

与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，以便LLMs能够轻松消费。

将会有很多变化，我一定会在我的通讯中分享我的学习成果。