genesys-mcp

将你的 Genesys Cloud 组织交到你的 AI 手中。 一个运行在 Cloudflare Workers 上的开源 Genesys Cloud MCP 服务器。零依赖、无需终端，其全部意义在于构建：队列、技能、用户、总结代码和 Architect 流程。

它负责构建，而非仅仅读取。

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

• "create a queue called Weekend Support"

• "build a call flow: greet callers, press 1 for Weekend Support, press 9 to end the call. show me the diagram first"

• "draw my Main IVR as a diagram"

• "onboard prep: create a spanish skill and assign it to Jess at proficiency 4"

流程构建器会生成真正的 Archy YAML，在聊天中将流程显示为 Mermaid 图表，然后通过 Genesys 自己的流程任务管道（与 CX as Code 使用的相同）发布，因此 Genesys 会在服务器端验证并发布。

它有意识不做的事

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

• 没有联系人列表管理。

• 没有删除功能。没有删除工具，原始 API 工具也拒绝 DELETE。按设计为先创建后删除。

Related MCP server: Salesforce MCP Server

3 步部署你自己的服务器

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/desktop)：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。

• 其他任何客户端：标准的可流式 HTTP MCP，使用 OAuth 2.1（或将访问密钥作为 Bearer 令牌发送）。

然后尝试："check the connection and list my queues."

工具箱（28 个工具）

✏️ = 写入工具。所有工具都会帮你将名称解析为 GUID，因此“the Weekend Support queue”这样的引用就能直接使用。

流程构建器的工作原理

1. build_flow 将描述转换为 Archy YAML 和 Mermaid 图表：TTS 问候语、可选的 营业时间门控（开放时转到菜单；关闭或假期播放消息，然后断开或转接语音信箱），以及一个 DTMF 菜单，其选项可以 转接到队列、转接队列语音信箱、拨打外部号码或断开连接。你的 AI 首先会向你显示图表。

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

3. 你组织现有的流程。

TTS 内嵌在流程中（你组织的 TTS 引擎会朗读这些文本），因此无需录制或上传音频文件。

安全模型

• 你的 Genesys 凭据存储介质在你的 Cloudflare 账户中（Wrangler secrets 或自动配置的 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 和 PR；路线图就是 issue 跟踪器。

MIT