genesys-mcp

您的 Genesys Cloud 组织，尽在 AI 掌控之中。 一个部署在 Cloudflare Workers 上、面向 Genesys Cloud 的开源 MCP 服务器。零依赖，无需终端，其全部目标就是构建：队列、技能、用户、结束代码和 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。设计上以先建为主。

三步部署您自己的实例

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

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

3. 配置：打开新 Worker 上的 /setup，粘贴客户端 ID、密钥和您的区域。向导会在保存前与 Genesys 实时验证这些信息，然后给您一个访问密钥（仅显示一次）。

更喜欢用终端管理配置？可以改为设置 Wrangler 密钥；它们会覆盖向导中的配置：GENESYS_CLIENT_ID、GENESYS_CLIENT_SECRET、GENESYS_REGION（例如 usw2.pure.cloud）、MCP_AUTH_TOKEN。

连接您的 AI

MCP 端点为 https://<your-worker>/mcp。

• Claude (web/desktop)：设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。出现授权屏幕时，粘贴您的访问密钥。

• Claude Code：执行 claude mcp add --transport http genesys https://<your-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 客户端的角色需要具备：Routing（队列、技能、结束代码）的查看和添加权限、Directory 用户查看和编辑权限（用于技能分配）、Architect 流程查看、添加、编辑和发布权限，以及 Telephony DID 查看权限。Master Admin（超级管理员）适用于沙箱环境；生产环境请缩小权限范围。服务器的能力永远不会超过您分配的角色。

本地开发

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 和 PR；路线图就是问题跟踪器。

MIT