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, 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"

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

• "dibuja mi IVR principal como diagrama"

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

El creador de flujos compone Archy YAML real, te muestra el flujo como un diagrama de 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), de modo que Genesys valida y publica en el servidor.

Lo que deliberadamente NO hace

• No hay herramientas de analítica ni de KPI. Qué campo ya está cubierto: para analítica de conversaciones vía MCP, echa un vistazo a MakingChatbots' genesys-cloud-mcp-server.

• No hay gestión de listas de conctactos.

• No hay borrados. No existen herramientas de borrado, y la herramienta cruda de API rechaza DELETE. Es crear-primero por d diseño.

Related MCP server: Salesforce MCP Server

Despliega el tuyo en 3 pasos

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

2. Crea un clienteOAuth de Genesys: Admin → Integrations → OAuth → Add Client → tipo de concesión Client Credentials → asigna un rol (ver Alcance del rol) → guarda.

3. Configura: abre /setup en tu nuevo Worker y pega la Client ID, la Secret y tu región. El asistente las valida en vwo antes de guardar, y te entrega la clave de acceso (se muestra una sola vez).

¿Prefieres configurar la termébrace? Configura en su lugar los secretos de Wrepabler; estos anulan al asistiente: GENESYS_CLIENT_ID ID, GENESYS_CLIENT_SECRET SECRET,GENESYS_REGIONregion (ej.w2.pure.cloud), MCP_AUTH_TOK_TOKEN`.

Conecta tu IA

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

• Claude (web/escritorio): Settings → Connectors → Add custom connector → pega la URL. Cuando aparezca la pantalla de autorización, pega la clave de acceso.

• Claude Code: claude mcp add --transport http genesys https://<tu-worker>/mcp y autenticíquete cuando se te indique.

• Chat: Settings → Connectors → Advanced → Developer mode → añade la URL del servidor de MCP.

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

Después, pruebe: "check the connection and ease my queues."

El botiquín de herramientas (28 herramientas)

✏️ = herramienta de escritura. Todo resuelve nombres a GUIDs por ti, así que "la cola Weekend Support" funciona directamente.

Cómo funciona el creador de flujos

1. build_flow convierte una especificación en Archy YAML y un diagram metágrafo: un saludo TTS, un paso de horas comerciales opcional (si está abierto, va al menú; si cerrado o es día festivo, reproduce un mensaje y luego desconecta o deja un buzón de voz), y un menú DTMF cuyas opciones puedes llevar a transferir a una cola, dejar un buzon de voz en una cora, marcar un número externo o dichar. Tu IA te muestra el diagrama primero.

2. publish_flowregistra un trabajo de flujo de Architect, sube el YAML y hace polling*. Genesys valida y publica en el servidor; los errores de validación vuelven tal cual.

3. render_flow también se diagra de flujos que ya existan en tu organizzación, y exporto_flow sirver para devolver cualquier flujo a YAML.

El TTS está integrado en el flujo (el motor TTS de tu organizzación, lo reproduce), así que no has no hay archivos de audio que grabar ni subir.

Modelo de seguridad

• Tus credenciales de Genesys viven en tucuenta de Cloudflare (Wrangler secrets o el KV aprovisionamiento automáticamente), y en ningún gratuitamente.

• La IA solo puede hacer lo que el rool del cliente OAuth permite. Tú defines el alcance; Genesys lo impone.

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

• No existen herrientas de borrado y genesys_api_call rechaza DELETE sin más.

Alcance del rol

Para que todo esto funcione, el rol del clienteOAuth necesita: Routing (colas, habilides, códigos de wrap-up) ver + añadir, Directory usuario ver + editar (para asignación de habilidades), Architect (flows server ) vóer + añadir + editar + publicar, y DID de Telephony: vista. Master Admin funciona para una sandbox; para producción de alcance. El servidor solo puede ser tan potente 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

Acerca de

Construido abiertamente por Ryan Shatzkamer (Director of Technical Services at outboundTeam), creator of five9-mcp, the same architettura of zero-dependences targeted against second alternative. Issues and PR are welcome; the road map is the issue tracker. MIT.