Genesys Flow MCP

Servidor MCP local que se conecta a Genesys Cloud, lista rutas de IVR, recupera el flujo de horario de apertura configurado de un IVR y genera documentación Markdown legible.

El documento generado está estructurado tanto para lectores técnicos como de negocio:

• Ruta — nombre del IVR, ID, estado, DNIS (cuando esté disponible) y flujo configurado.

• Enfoque de negocio — el propósito del flujo y el enrutamiento del menú del cliente.

• Enfoque técnico — configuración del flujo, variables, prompts/TTS, tareas, menús y rutas de decisión.

• Integraciones y dependencias de enrutamiento — Data Actions, Bot Flows y colas ACD.

Requisitos previos

• Node.js 18 o posterior

• Un cliente OAuth de Genesys Cloud que use el flujo de Client Credentials

• Permisos para leer IVRs y flujos de Architect en la organización de Genesys Cloud correspondiente

Related MCP server: Hive Mind MCP Server

Instalar y configurar

Instala las dependencias:

cd <path-to-genesys-flow-mcp>
npm install

Crea un archivo .env en la raíz del proyecto:

GENESYS_CLIENT_ID=your-client-id
GENESYS_CLIENT_SECERET=your-client-secret
GENESYS_REGION=ie

Importante: GENESYS_CLIENT_SECERET está escrito así a propósito porque coincide con el código fuente actual. No lo renombres a SECRET a menos que también actualices src/config/env.ts.

Establece GENESYS_REGION al sufijo de tu región de Genesys Cloud, por ejemplo ie para mypurecloud.ie.

Ejecutar localmente

Para desarrollo:

npm run dev

Para el servidor compilado usado por clientes de escritorio:

npm run build
npm start

El servidor usa el transporte stdio de MCP. Lo inicia el cliente MCP; no expone una URL de navegador ni un puerto HTTP.

Probar con MCP Inspector

Usa MCP Inspector para probar el servidor directamente antes de conectarlo a Claude Desktop:

cd <path-to-genesys-flow-mcp>
npm run inspect

El Inspector abre una interfaz de navegador local. En ella:

1. Conéctate al servidor usando la configuración stdio predeterminada.

2. Abre la pestaña Tools.

3. Ejecuta get_ivrs para confirmar la autenticación de Genesys y la recuperación de rutas.

4. Ejecuta get_flow_by_name con un nombre de IVR, por ejemplo:

   {
     "name": "testt call"
   }

5. Comprueba que la respuesta comienza con la sección Route e incluye el flujo configurado, los prompts y las integraciones.

Herramientas disponibles

get_ivrs

Devuelve la lista de enrutamiento/IVR de Genesys Cloud.

Ejemplo de solicitud:

List the available Genesys IVRs.

get_flow_by_name

Busca un IVR por nombre, recupera su flujo de horario de apertura configurado y devuelve documentación Markdown.

Entrada:

{
  "name": "testt call"
}

Ejemplo de solicitud:

Use get_flow_by_name for the IVR named "testt call".

Si no se encuentra el IVR, o no tiene flujo de horario de apertura, la herramienta devuelve un error que describe el problema.

Qué incluye la documentación generada

La documentación sigue la relación siguiente:

Genesys IVR Route
        ↓
Configured Open-Hours Flow
        ├── Business Focus: customer routing and menu choices
        └── Technical Focus: prompts, variables, tasks, menus, integrations

La detección de integraciones cubre las dependencias comunes de Architect que se indican a continuación:

Todos los prompts TTS encontrados en tareas y saludos de menú se incluyen en el recorrido técnico del flujo.

Probar con Claude Desktop

1. Compila el proyecto:

   cd <path-to-genesys-flow-mcp>
   npm run build

2. En Claude Desktop, abre:

   File → Settings → Developer → Edit Config

3. Añade lo siguiente en el nivel superior del archivo JSON abierto. Conserva cualquier configuración existente, como preferences.

   {
     "mcpServers": {
       "genesys-flow": {
         "command": "node",
         "args": [
           "<path-to-genesys-flow-mcp>\\dist\\index.js"
         ],
         "env": {
           "GENESYS_CLIENT_ID": "your-client-id",
           "GENESYS_CLIENT_SECERET": "your-client-secret",
           "GENESYS_REGION": "ie"
         }
       }
     }
   }

   Reemplaza <path-to-genesys-flow-mcp> con la ruta completa a tu carpeta de proyecto local. Si el archivo ya contiene propiedades, añade mcpServers junto a ellas y asegúrate de que la propiedad anterior termine con una coma.

4. Cierra y vuelve a abrir Claude Desktop por completo.

5. Inicia un nuevo chat y pregunta:

   What Genesys tools are available?

   Luego prueba la documentación:

   Use get_flow_by_name for the IVR named "testt call" and document its route, configured flow, prompts, and integrations.

No confirmes ni compartas la configuración de Claude Desktop si contiene tu secreto de cliente. Para una prueba local en un dispositivo personal, es aceptable pasar las credenciales a través del bloque env de MCP. Usa un cliente OAuth dedicado con los permisos mínimos requeridos de Genesys.

Verificación de compilación

Ejecuta la verificación de compilación de TypeScript después de los cambios de código:

npm run build

Estructura del proyecto

src/
├── config/       Environment variable validation
├── mcp/          MCP server and tool registration
├── services/     Genesys authentication, API access, and documentation generation
├── tools/        MCP tool handlers
└── types/        Genesys Cloud response types