genesys-mcp

Tu organización de Genesys Cloud, en manos de tu IA. Un servidor MCP de código abierto para Genesys Cloud en Cloudflare Workers. Cero dependencias, sin necesidad de terminal, y su único propósito es construir: colas, habilidades, usuarios, códigos de cierre y flujos de Architect.

Construye, no solo lee.

Indícale a Claude (o a cualquier cliente MCP):

• "crea una cola llamada Soporte de Fin de Semana"

• "construye un flujo de llamada: saluda a los que llaman, presiona 1 para Soporte de Fin de Semana, presiona 9 para finalizar la llamada. muéstrame el diagrama primero"

• "dibuja mi IVR principal como un diagrama"

• "preparación de onboarding: crea una habilidad de español y asígnala a Jess con nivel 4"

El constructor de flujos compone YAML real de Archy, te muestra el flujo como un diagrama Mermaid en el chat, y luego lo publica a través del propio pipeline de trabajos de flujo de Genesys (el mismo que usa CX as Code), por lo que Genesys valida y publica del lado del servidor.

Lo que deliberadamente NO hace

• Sin herramientas de análisis o KPI. Ese ámbito ya está cubierto; para análisis de conversaciones a través de MCP, consulta MakingChatbots' genesys-cloud-mcp-server.

• Sin gestión de listas de contactos.

• Sin eliminaciones. No hay herramientas de eliminación, y la herramienta de API sin procesar rechaza DELETE. Diseñado para crear primero.

Related MCP server: Genesys Cloud MCP Server

Despliega el tuyo propio en 3 pasos

1. Despliega: haz clic en el botón (cuenta gratuita de Cloudflare), o git clone + npx wrangler deploy. El espacio de nombres CONFIG KV se aprovisiona automáticamente.

2. Crea un cliente OAuth de Genesys: Admin → Integraciones → OAuth → Agregar Cliente → tipo de concesión Credenciales de Cliente → asigna un rol (consulta Delimitando el rol) → guarda.

3. Configura: abre /setup en tu nuevo Worker y pega el ID de Cliente, el Secreto y tu región. El asistente los valida en vivo contra Genesys antes de guardar, y luego te entrega tu clave de acceso (se muestra una vez).

¿Prefieres la configuración gestionada por terminal? Configura los secretos de Wrangler; estos anulan al asistente: GENESYS_CLIENT_ID, GENESYS_CLIENT_SECRET, GENESYS_REGION (ej. usw2.pure.cloud), MCP_AUTH_TOKEN.

Conecta tu IA

El endpoint MCP es https://<tu-worker>/mcp.

• Claude (web/escritorio): Configuración → Conectores → Agregar conector personalizado → pega la URL. Cuando aparezca la pantalla de autorización, pega tu clave de acceso.

• Claude Code: claude mcp add --transport http genesys https://<tu-worker>/mcp y autentícate cuando se te solicite.

• ChatGPT: Configuración → Conectores → Avanzado → Modo desarrollador → agrega la URL del servidor MCP.

• Cualquier otra cosa: MCP HTTP transmisible estándar con OAuth 2.1 (o envía la clave de acceso como un token Bearer).

Luego prueba: "verifica la conexión y lista mis colas."

El conjunto de herramientas (25 herramientas)

✏️ = herramienta de escritura. Todo resuelve nombres a GUIDs por ti, por lo que "la cola de Soporte de Fin de Semana" simplemente funciona.

Cómo funciona el constructor de flujos

1. build_flow convierte una especificación (saludo + menú DTMF + transferencias a cola) en YAML de Archy y un diagrama Mermaid. Tu IA te muestra primero el diagrama.

2. publish_flow registra un trabajo de flujo de Architect, sube el YAML y hace sondeos. Genesys valida y publica del lado del servidor; los errores de validación se devuelven textualmente.

3. render_flow también diagrama flujos que ya existen en tu organización, y export_flow convierte cualquier flujo de vuelta a YAML.

El TTS está en línea dentro del flujo (el motor TTS de tu organización lo pronuncia), por lo que no hay archivos de audio que grabar o subir.

Modelo de seguridad

• Tus credenciales de Genesys residen en tu cuenta de Cloudflare (secretos de Wrangler o el KV aprovisionado automáticamente), y en ningún otro lugar.

• La IA solo puede hacer lo que el rol del cliente OAuth permite. Tú lo delimitas; Genesys lo aplica.

• El endpoint MCP requiere la clave de acceso (Bearer sin procesar o el flujo OAuth 2.1 integrado para conectores).

• No existen herramientas de eliminación, y genesys_api_call rechaza DELETE de forma rotunda.

Delimitando el rol

Para que todo esto funcione, el rol del cliente OAuth necesita: Enrutamiento (colas, habilidades, códigos de cierre) ver + agregar, Directorio de usuarios ver + editar (para asignación de habilidades), Flujos de Architect ver + agregar + editar + publicar, y DID de Telefonía ver. El rol de Administrador Maestro funciona para un sandbox; delimítalo para producción. El servidor solo puede ser tan potente como el rol que asignes.

Desarrollo local

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

Acerca de

Construido de forma abierta por Ryan Shatzkamer (Director de Servicios Técnicos en outboundIQ), creador de five9-mcp, la misma arquitectura de cero dependencias apuntada a una segunda plataforma. Las incidencias y PRs son bienvenidos; la hoja de ruta es el rastreador de incidencias.

MIT