Genesys Flow MCP

本地 MCP 服务器，连接 Genesys Cloud，列出 IVR 路由，检索 IVR 配置的营业时间流程，并生成可读的 Markdown 文档。

生成的文档面向业务和技术读者，结构如下：

• 路由 — IVR 名称、ID、状态、DNIS（如有）以及配置的流程。

• 业务重点 — 流程目的和客户菜单路由。

• 技术重点 — 流程设置、变量、提示/TTS、任务、菜单和决策路径。

• 集成与路由依赖 — 数据操作、机器人流程和 ACD 队列。

前提条件

• Node.js 18 或更高版本

• 使用 客户端凭证 授权的 Genesys Cloud OAuth 客户端

• 在相关 Genesys Cloud 组织中具有读取 Architect IVR 和流程的权限

Related MCP server: Hive Mind MCP Server

安装与配置

安装依赖：

cd <path-to-genesys-flow-mcp>
npm install

在项目根目录创建 .env 文件：

GENESYS_CLIENT_ID=your-client-id
GENESYS_CLIENT_SECERET=your-client-secret
GENESYS_REGION=ie

重要提示： GENESYS_CLIENT_SECERET 故意拼写为这样，因为它与当前源代码匹配。除非同时更新 src/config/env.ts，否则不要将其重命名为 SECRET。

将 GENESYS_REGION 设置为您的 Genesys Cloud 区域后缀，例如 ie 对应 mypurecloud.ie。

本地运行

用于开发：

npm run dev

用于桌面客户端使用的编译后服务器：

npm run build
npm start

服务器使用 MCP stdio 传输。它由 MCP 客户端启动；不暴露浏览器 URL 或 HTTP 端口。

使用 MCP Inspector 测试

在连接到 Claude Desktop 之前，使用 MCP Inspector 直接测试服务器：

cd <path-to-genesys-flow-mcp>
npm run inspect

Inspector 会打开本地浏览器界面。在其中：

1. 使用默认的 stdio 配置连接到服务器。

2. 打开 工具 选项卡。

3. 运行 get_ivrs 以确认 Genesys 身份验证和路由检索。

4. 使用 IVR 名称运行 get_flow_by_name，例如：

   {
     "name": "testt call"
   }

5. 检查响应是否以 路由 部分开头，并包含配置的流程、提示和集成。

可用工具

get_ivrs

返回 Genesys Cloud 路由/IVR 列表。

示例请求：

List the available Genesys IVRs.

get_flow_by_name

按名称查找 IVR，检索其配置的营业时间流程，并返回 Markdown 文档。

输入：

{
  "name": "testt call"
}

示例请求：

Use get_flow_by_name for the IVR named "testt call".

如果未找到 IVR，或没有营业时间流程，工具将返回描述问题的错误。

生成的文档包含内容

文档遵循以下关系：

Genesys IVR Route
        ↓
Configured Open-Hours Flow
        ├── Business Focus: customer routing and menu choices
        └── Technical Focus: prompts, variables, tasks, menus, integrations

集成检测涵盖以下常见的 Architect 依赖项：

任务和菜单问候语中找到的所有 TTS 提示都包含在技术流程说明中。

使用 Claude Desktop 测试

1. 构建项目：

   cd <path-to-genesys-flow-mcp>
   npm run build

2. 在 Claude Desktop 中，打开：

   File → Settings → Developer → Edit Config

3. 在打开的 JSON 文件的顶层添加以下内容。保留任何现有设置，如 preferences。

   {
     "mcpServers": {
       "genesys-flow": {
         "command": "node",
         "args": [
           "<path-to-genesys-flow-mcp>\\dist\\index.js"
         ],
         "env": {
           "GENESYS_CLIENT_ID": "your-client-id",
           "GENESYS_CLIENT_SECERET": "your-client-secret",
           "GENESYS_REGION": "ie"
         }
       }
     }
   }

   将 <path-to-genesys-flow-mcp> 替换为本地项目文件夹的完整路径。如果文件已包含属性，请将 mcpServers 添加到它们旁边，并确保前面的属性以逗号结尾。

4. 完全退出并重新打开 Claude Desktop。

5. 开始新聊天并询问：

   What Genesys tools are available?

   然后测试文档：

   Use get_flow_by_name for the IVR named "testt call" and document its route, configured flow, prompts, and integrations.

如果 Claude Desktop 配置包含您的客户端密钥，请勿提交或共享。在个人设备上进行本地测试时，通过 MCP env 块传递凭据是可以接受的。使用具有最低所需 Genesys 权限的专用 OAuth 客户端。

构建检查

代码更改后运行 TypeScript 构建检查：

npm run build

项目结构

src/
├── config/       Environment variable validation
├── mcp/          MCP server and tool registration
├── services/     Genesys authentication, API access, and documentation generation
├── tools/        MCP tool handlers
└── types/        Genesys Cloud response types