Skip to main content
Glama
deenesjakoruzh
outboundani

genesys-mcp

by outboundani
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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。设计上以先建为主。

Related MCP server: Genesys Cloud MCP Server

三步部署您自己的实例

Deploy to Cloudflare

  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 个工具）

分组

工具

🔌 组织与连接

about, check_connection, list_divisions, list_did_pools

📞 队列与路由

list_queues, get_queue, create_queue ✏️, list_wrapup_codes, create_wrapup_code ✏️

👥 用户与技能

list_users, get_user, list_skills, create_skill ✏️, assign_user_skill ✏️

🌳 流程（Architect）

list_flows, get_flow, get_flow_configuration, list_prompts, render_flow, export_flow

🏗️ 流程构建器

build_flow, publish_flow ✏️, get_flow_job, unlock_flow ✏️

⚡ 高级功能

genesys_api_call ✏️（任意 Platform API 端点；仅支持 GET/POST/PUT/PATCH）

✏️ = 写入工具。所有名称都会为您解析为 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Genesys MCP

    DigitalVanguardSolutions
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to interact with Genesys Cloud platform through MCP tools, resources, and prompts, supporting queues, conversations, users, presence, and analytics with production-ready features like Streamable HTTP and per-request authentication.
    1
    MIT

  • five9-mcp

    GordonALP
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server that connects AI assistants to Five9 cloud contact center, exposing 77 tools for configuration, statistics, IVR building, and campaign management via Cloudflare Workers with zero dependencies.
    MIT

  • genesys-mcp

    joe23byte
    F
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that puts your Genesys Cloud org under AI control, enabling natural language creation of queues, skills, users, wrap-up codes, and Architect IVR flows with Mermaid diagrams.
    -