Genesys Cloud MCP Server

Genesys Cloud MCP Server

Um servidor Model Context Protocol (MCP) para a Platform API do Genesys Cloud.

Recursos

Ferramenta	Descrição
Search Queues	Busca filas pelo nome (suporta curingas)
Query Queue Volumes	Recupera volumes de conversas e contagem de membros por IDs de fila
Sample Conversations By Queue	Recupera uma amostra representativa de IDs de conversa para um ID de fila
Voice Call Quality	Recupera métricas de qualidade de chamadas de voz para uma ou mais conversas por ID
Conversation Sentiment	Recupera o sentimento de uma ou mais conversas por ID
Conversation Topics	Recupera os tópicos de uma conversa por ID
Search Voice Conversation	Busca conversas de voz por critérios opcionais
Conversation Transcript	Recupera a transcrição da conversa
OAuth Clients	Recupera uma lista de todos os clientes OAuth
OAuth Client Usage	Recupera o uso do cliente OAuth para um período determinado

Uso com o Claude Desktop

MCP Bundle

Este MCP Server fornece um MCP Bundle (arquivo .mcpb) junto com cada release, que é um pacote instalável com um clique para o Claude Desktop. Para usá-lo:

1. Baixe o arquivo .mcpb da última versão
2. No Claude Desktop, navegue até Configurações > Extensões.
3. Abra o arquivo .mcpb com o Claude
4. Configure a Região e o Cliente OAuth para a extensão

A extensão agora estará disponível em suas conversas.

NPX

Adicione isto ao seu 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 com o Gemini CLI

Adicione abaixo ao seu arquivo .gemini/settings.json. Você pode ler mais sobre a configuração no guia 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}"
      }
    }
  }
}

Autenticação

Atualmente, isso suporta apenas um servidor stdio. Para configurar a autenticação, você precisará de:

1. Criar um Cliente OAuth no Genesys Cloud
2. Atribuir as permissões a ele para as ferramentas que você deseja usar
3. Fornecer as seguintes variáveis de ambiente ao referenciar o servidor:
   • GENESYSCLOUD_REGION
   • GENESYSCLOUD_OAUTHCLIENT_ID
   • GENESYSCLOUD_OAUTHCLIENT_SECRET

Desenvolvimento

Primeiros Passos

nvm use
npm install
npm run dev

Em desenvolvimento ativo

Isto faz parte de um projeto pessoal para criar uma ferramenta conversacional de Business Insights. É uma forma prática de eu aprender sobre servidores MCP e como melhor representar as Platform APIs do Genesys Cloud de uma forma que possa ser facilmente consumida por LLMs.

Haverá muitas mudanças, e com certeza compartilharei meus aprendizados na minha newsletter.