genesys-mcp

你的 Genesys Cloud 组织，尽在你的 AI 掌控之中。 这是一个运行在 Cloudflare Workers 上的 Genesys Cloud 开源 MCP 服务器。零依赖，无需终端，其全部目的就是构建：队列、技能、用户、话后总结代码和 Architect 流程。

它用于构建，而不仅仅是读取。

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

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

• “构建一个呼叫流程：问候来电者，按 1 转接 Weekend Support，按 9 结束通话。先给我看图表”

• “把我的 Main IVR 绘制成图表”

• “入职准备：创建一个西班牙语技能，并以熟练度 4 分配给 Jess”

流程构建器会生成真正的 Archy YAML，在聊天中把流程以 Mermaid 图表形式展示给你，然后通过 Genesys 自己的 flow-jobs 管道（与 CX as Code 使用的相同）发布，因此由 Genesys 在服务端完成验证和发布。

它刻意不做什么

• 没有分析或 KPI 工具。 这一领域已有现成方案；如需通过 MCP 进行对话分析，请查看 MakingChatbots' genesys-cloud-mcp-server。

• 不管理联系人列表。

• 没有删除操作。 不存在删除工具，原始 API 工具也会拒绝 DELETE。这是刻意的“先创建”设计。

Related MCP server: Genesys Cloud MCP Server

三步部署你自己的服务器

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

2. 创建 Genesys OAuth 客户端：Admin → Integrations → OAuth → Add Client → 授权类型 Client Credentials → 分配角色（参见 角色范围界定）→ 保存。

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

更喜欢通过终端管理配置？改为设置 Wrangler secrets；它们会覆盖向导：GENESYS_CLIENT_ID、GENESYS_CLIENT_SECRET、GENESYS_REGION（例如 usw2.pure.cloud）、MCP_AUTH_TOKEN。

连接你的 AI

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

• Claude（Web/桌面端）：Settings → Connectors → Add custom connector → 粘贴 URL。出现授权屏幕时，粘贴你的访问密钥。

• Claude Code：运行 claude mcp add --transport http genesys https://<your-worker>/mcp，出现提示时进行身份验证。

• ChatGPT：Settings → Connectors → Advanced → Developer mode → 添加 MCP 服务器 URL。

• 其他任何客户端：标准的 Streamable HTTP MCP，搭配 OAuth 2.1（或将访问密钥作为 Bearer token 发送）。

然后试试：“检查连接并列出的我的队列。”

工具箱（25 个工具）

✏️ = 写入工具。所有名称都会为你解析为 GUID，因此“Weekend Support 队列”直接就能用。

流程构建器的工作原理

1. build_flow 把规格（问候语 + DTMF 菜单 + 队列转接）转换成 Archy YAML 和 Mermaid 图表。你的 AI 会先向你展示图表。

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

3. render_flow 还能为你组织中现有的流程绘制图表，export_flow 则可将任何流程往返还原为 YAML。

TTS 直接内联在流程中（由你组织的 TTS 引擎朗读），因此无需录制或上传任何音频文件。

安全模型

• 你的 Genesys 凭据存放于你的 Cloudflare 账户中（Wrangler secrets 或自动预置的 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；路线图就是 issue 跟踪器。

MIT