Genesys Cloud MCP Server

Genesys Cloud MCP Server

Un servidor de Model Context Protocol (MCP) para la API de Platform de Genesys Cloud.

Características

Herramienta	Descripción
Search Queues	Busca colas por su nombre (admite comodines)
Query Queue Volumes	Recupera volúmenes de conversación y número de miembros por ID de cola
Sample Conversations By Queue	Recupera una muestra representativa de ID de conversación para un ID de cola
Voice Call Quality	Recupera métricas de calidad de llamadas de voz para una o más conversaciones por ID
Conversation Sentiment	Recupera el sentimiento de una o más conversaciones por ID
Conversation Topics	Recupera los temas de una conversación por ID
Search Voice Conversation	Busca conversaciones de voz por criterios opcionales
Conversation Transcript	Recupera la transcripción de la conversación
OAuth Clients	Recupera una lista de todos los clientes OAuth
OAuth Client Usage	Recupera el uso del cliente OAuth para un período determinado

Uso con Claude Desktop

MCP Bundle

Este servidor MCP proporciona un MCP Bundle (archivo .mcpb) junto con cada release, que es un paquete instalable con un solo clic para Claude Desktop. Para usarlo:

1. Descarga el archivo .mcpb desde la última versión
2. En Claude Desktop, navega a Configuración > Extensiones.
3. Abre el archivo .mcpb con Claude
4. Configura la Región y el Cliente OAuth para la extensión

La extensión ahora estará disponible en tus conversaciones.

NPX

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "genesys-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@makingchatbots/genesys-cloud-mcp-server"],
      "env": {
        "GENESYSCLOUD_REGION": "<PUT REGION HERE>",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "<PUT OAUTHCLIENT ID HERE>",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "<PUT OAUTHCLIENT SECRET HERE>"
      }
    }
  }
}

Uso con Gemini CLI

Añade lo siguiente a tu archivo .gemini/settings.json. Puedes leer más sobre la configuración en la guía oficial.

{
  "mcpServers": {
    "genesysCloud": {
      "command": "npx",
      "args": ["-y", "@makingchatbots/genesys-cloud-mcp-server"],
      "env": {
        "GENESYSCLOUD_REGION": "${GENESYSCLOUD_REGION}",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "${GENESYSCLOUD_OAUTHCLIENT_ID}",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "${GENESYSCLOUD_OAUTHCLIENT_SECRET}"
      }
    }
  }
}

Autenticación

Actualmente solo admite un servidor stdio. Para configurar la autenticación necesitarás:

1. Crear un Cliente OAuth en Genesys Cloud
2. Asignarle los permisos para las herramientas que quieras usar
3. Proporcionar las siguientes variables de entorno al hacer referencia al servidor:
   • GENESYSCLOUD_REGION
   • GENESYSCLOUD_OAUTHCLIENT_ID
   • GENESYSCLOUD_OAUTHCLIENT_SECRET

Desarrollo

Primeros pasos

nvm use
npm install
npm run dev

En desarrollo activo

Esto es parte de un proyecto personal para crear una herramienta conversacional de Business Insights. Es una forma práctica para mí de aprender sobre servidores MCP y cómo representar mejor las API de Platform de Genesys Cloud de una manera que pueda ser consumida fácilmente por LLMs.

Habrá muchos cambios, y me aseguraré de compartir mis aprendizajes en mi boletín.