genesys-mcp

您的 Genesys Cloud 组织，尽在 AI 之手。 这是一个基于 Cloudflare Workers 的开源 MCP 服务器，专为 Genesys Cloud 打造。零依赖，无需终端，其全部意义在于构建：队列、技能、用户、结束码以及 Architect 流程。

它能构建，而不仅仅是读取。

提示 Claude（或任何 MCP 客户端）：

• "创建一个名为 Weekend Support 的队列"

• "创建一个呼叫流程：问候来电者，按 1 转 Weekend Support，按 9 结束通话。先给我显示图表"

• "将我的 Main IVR 绘制成图表"

• "上岗准备：创建一个西班牙语技能，并将其分配给 Jess，熟练度为 4"

流程构建器会生成真实的 Archy YAML，在聊天中以 Mermaid 图表形式向您展示流程，然后通过 Genesys 自身的 flow-jobs 管道（与 CX as Code 使用的相同）进行发布，因此 Genesys 会在服务器端验证并发布。

它明确不做什么

• 无分析或 KPI 工具。 该领域已有覆盖；如需通过 MCP 进行对话分析，请查看 MakingChatbots 的 genesys-cloud-mcp-server。

• 无联系人列表管理。

• 无删除功能。 没有删除工具，并且原始 API 工具会拒绝 DELETE。设计上以先创建为原则。

Related MCP server: genesys-mcp

三步部署您自己的实例

1. 部署：点击按钮（需要免费 Cloudflare 账户），或使用 git clone + npx wrangler deploy。CONFIG KV 命名空间会自动配置。

2. 创建 Genesys OAuth 客户端：管理 → 集成 → OAuth → 添加客户端 → 授权类型 客户端凭据 → 分配角色（参见限定角色范围）→ 保存。

3. 配置：在浏览器中打开您新 Worker 的 /setup 路径，粘贴客户端 ID、密钥和您的区域。向导会在保存前实时向 Genesys 验证它们，然后向您提供访问密钥（仅显示一次）。

偏好终端管理配置？可以改用 Wrangler 机密变量；它们会覆盖向导：GENESYS_CLIENT_ID、GENESYS_CLIENT_SECRET、GENESYS_REGION（例如 usw2.pure.cloud）、MCP_AUTH_TOKEN。

连接您的 AI

MCP 端点为 https://<您的worker>/mcp。

• Claude（网页/桌面版）：设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。出现授权屏幕时，粘贴您的访问密钥。

• Claude Code：claude mcp add --transport http genesys https://<您的worker>/mcp，并在提示时进行身份验证。

• ChatGPT：设置 → 连接器 → 高级 → 开发者模式 → 添加 MCP 服务器 URL。

• 其他任何工具：支持标准可流式 HTTP MCP 与 OAuth 2.1（或将访问密钥作为 Bearer 令牌发送）。

然后尝试："检查连接并列出我的队列。"

工具箱（25种工具）

✏️ = 写入工具。所有操作都会自动将名称解析为 GUID，因此"Weekend Support 队列"可以直接使用。

流程构建器的工作原理

1. build_flow 将规范（问候语 + DTMF 菜单 + 队列转接）转换为 Archy YAML 和 Mermaid 图表。您的 AI 会首先向您展示图表。

2. publish_flow 注册一个 Architect 流程作业，上传 YAML，并进行轮询。Genesys 会在服务器端验证并发布；验证错误会原样返回。

3. render_flow 也可以对您组织中已有的流程进行图表化，export_flow 则可以将任何流程回转为 YAML。

TTS 是流程内嵌的（您组织的 TTS 引擎会朗读它），因此无需录制或上传音频文件。

安全模型

• 您的 Genesys 凭据存储在您的 Cloudflare 账户中（Wrangler 机密变量或自动配置的 KV），不会存储在其他任何地方。

• AI 只能执行OAuth 客户端的角色所允许的操作。由您限定范围；Genesys 负责强制执行。

• MCP 端点需要访问密钥（原始 Bearer 或连接器中内置的 OAuth 2.1 流程）。

• 不存在删除工具，并且 genesys_api_call 会直接拒绝 DELETE 请求。

限定角色范围

为使此处所有功能正常运作，OAuth 客户端的角色需要：路由（队列、技能、结束码）的查看和添加权限、目录用户查看和编辑权限（用于技能分配）、Architect 流程的查看、添加、编辑和发布权限，以及 Telephony DID 查看权限。对于沙箱环境，主管理员角色即可；生产环境请缩小范围。服务器的能力始终受限于您分配的角色。

本地开发

git clone https://github.com/ryanshatz/genesys-mcp
cd genesys-mcp
cp .dev.vars.example .dev.vars   # or create it: GENESYS_CLIENT_ID / GENESYS_CLIENT_SECRET / GENESYS_REGION / MCP_AUTH_TOKEN
npm test                          # zero-dep unit tests (node --test)
npm run smoke                     # live read-tools smoke against your org
npm run smoke -- --writes         # also exercises create tools (MCP_Test_* artifacts)
npm run dev                       # wrangler dev

关于

由 Ryan Shatzkamer（outboundIQ 技术服务总监）公开构建，他也是 five9-mcp 的创建者，采用了相同的零依赖架构并应用于第二个平台。欢迎提交 Issue 和拉取请求；路线图详见 Issue 跟踪器。

MIT