genesys-mcp

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

Construye, no solo lee.

Pídele a Claude (o a cualquier cliente MCP):

• "crea una cola llamada Weekend Support"

• "construye un flujo de llamada: saluda a los llamantes, pulsa 1 para Weekend Support, pulsa 9 para finalizar la llamada. muéstrame primero el diagrama"

• "dibuja mi IVR principal como 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 de Archy real, te muestra el flujo como un diagrama de Mermaid en el chat y luego publica a través del pipeline de flujos de Genesys (el mismo que usa CX as Code), por lo que Genesys valida y publica en el servidor.

Lo que deliberadamente NO hace

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

• Sin gestión de listas de contactos.

• Sin borrados. No hay herramientas de borrado, y la herramienta de API bruta rechaza DELETE. Diseñado para crear primero.

Related MCP server: five9-mcp

Despliega el tuyo en 3 pasos

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

2. Crea un cliente OAuth de Genesys: Admin → Integraciones → OAuth → Añadir Cliente → tipo de concesión Client Credentials → asigna un rol (ver Delimitando el rol) → guarda.

3. Configura: abre /setup en tu nuevo Worker y pega el Client ID, el Secret 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 configurar por terminal? Establece los secretos de Wrangler; estos anulan el asistente: GENESYS_CLIENT_ID, GENESYS_CLIENT_SECRET, GENESYS_REGION (p. ej. usw2.pure.cloud), MCP_AUTH_TOKEN.

Conecta tu IA

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

• Claude (web/escritorio): Ajustes → Conectores → Añadir 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://<your-worker>/mcp y autentica cuando se te pida.

• ChatGPT: Ajustes → Conectores → Modo desarrollador → añade la URL del servidor MCP.

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

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

El conjunto de herramientas (25 herramientas)

✏️ = herramienta de escritura. Todo resuelve nombres a GUIDs por ti, así que "la cola de Weekend Support" 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 de Mermaid. Tu IA te muestra primero el diagrama.

2. publish_flow registra un trabajo de flujo de Architect, sube el YAML y hace polling. Genesys valida y publica en el servidor; los errores de validación se devuelven tal cual.

3. render_flow también dibuja diagramas de flujos existentes en tu organización, y export_flow convierte cualquier flujo de vuelta a YAML.

El TTS está integrado en el flujo (lo habla el motor de tu organización), así que no hay archivos de audio que grabar o subir.

Modelo de seguridad

• Tus credenciales de Genesys viven en tu cuenta de Cloudflare (secretos de Wrangler o el namespace KV aprovisionado automáticamente).

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

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

• No hay herramientas de borrado, y genesys_api_call rechaza DELETE deliberadamente.

Delimitando el rol

Para que todo funcione, el rol necesita: Routing (ver/editar colas, habilidades, códigos de wrap-up), Directorio (ver/editar usuarios para la asignación de habilidades), Architect (ver/crear/editar/publicar flujos) y Telefonía (ver DIDs). Master Admin funciona para pruebas; reduce el alcance para producción. El servidor solo puede ser tan poderoso como el rol que le 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

Licencia

MIT