Genesys Flow MCP

Lokaler MCP-Server, der eine Verbindung zu Genesys Cloud herstellt, IVR-Routen auflistet, den konfigurierten Open-Hours-Flow einer IVR abruft und lesbare Markdown-Dokumentation erzeugt.

Das generierte Dokument ist sowohl für geschäftliche als auch für technische Leser strukturiert:

• Route — IVR-Name, ID, Status, DNIS (sofern verfügbar) und konfigurierter Flow.

• Business-Fokus — der Flow-Zweck und das Kundenmenü-Routing.

• Technischer Fokus — Flow-Einstellungen, Variablen, Prompts/TTS, Tasks, Menüs und Entscheidungspfade.

• Integrationen und Routing-Abhängigkeiten — Data Actions, Bot Flows und ACD-Warteschlangen.

Voraussetzungen

• Node.js 18 oder neuer

• Ein Genesys Cloud OAuth-Client mit dem Client Credentials-Grant

• Berechtigungen zum Lesen von Architect-IVRs und -Flows in der relevanten Genesys-Cloud-Organisation

Related MCP server: Hive Mind MCP Server

Installation und Konfiguration

Abhängigkeiten installieren:

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

Erstellen Sie eine .env-Datei im Projektstamm:

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

Wichtig: GENESYS_CLIENT_SECERET ist absichtlich so geschrieben, weil es dem aktuellen Quellcode entspricht. Benennen Sie es nicht in SECRET um, es sei denn, Sie aktualisieren auch src/config/env.ts.

Setzen Sie GENESYS_REGION auf das Suffix Ihrer Genesys-Cloud-Region, z. B. ie für mypurecloud.ie.

Lokal ausführen

Für die Entwicklung:

npm run dev

Für den kompilierten Server, der von Desktop-Clients verwendet wird:

npm run build
npm start

Der Server verwendet den MCP-stdio-Transport. Er wird vom MCP-Client gestartet; er stellt keine Browser-URL oder HTTP-Port bereit.

Mit MCP Inspector testen

Verwenden Sie den MCP Inspector, um den Server direkt zu testen, bevor Sie ihn mit Claude Desktop verbinden:

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

Der Inspector öffnet eine lokale Browser-Oberfläche. Darin:

1. Verbinden Sie sich mit dem Server über die Standard-stdio-Konfiguration.

2. Öffnen Sie den Tab Tools.

3. Führen Sie get_ivrs aus, um die Genesys-Authentifizierung und den Routenabruf zu bestätigen.

4. Führen Sie get_flow_by_name mit einem IVR-Namen aus, zum Beispiel:

   {
     "name": "testt call"
   }

5. Prüfen Sie, dass die Antwort mit dem Abschnitt Route beginnt und den konfigurierten Flow, Prompts und Integrationen enthält.

Verfügbare Tools

get_ivrs

Gibt die Genesys-Cloud-Routing-/IVR-Liste zurück.

Beispielanfrage:

List the available Genesys IVRs.

get_flow_by_name

Sucht eine IVR anhand des Namens, ruft ihren konfigurierten Open-Hours-Flow ab und gibt Markdown-Dokumentation zurück.

Eingabe:

{
  "name": "testt call"
}

Beispielanfrage:

Use get_flow_by_name for the IVR named "testt call".

Wenn die IVR nicht gefunden wird oder keinen Open-Hours-Flow hat, gibt das Tool einen Fehler zurück, der das Problem beschreibt.

Was die generierte Dokumentation enthält

Die Dokumentation folgt der folgenden Beziehung:

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

Die Integrationserkennung deckt die folgenden gängigen Architect-Abhängigkeiten ab:

Alle TTS-Prompts, die in Tasks und Menü-Begrüßungen gefunden werden, sind im technischen Flow-Durchlauf enthalten.

Mit Claude Desktop testen

1. Projekt erstellen:

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

2. In Claude Desktop öffnen:

   File → Settings → Developer → Edit Config

3. Fügen Sie Folgendes auf der obersten Ebene der geöffneten JSON-Datei hinzu. Bewahren Sie vorhandene Einstellungen wie preferences auf.

   {
     "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"
         }
       }
     }
   }

   Ersetzen Sie <path-to-genesys-flow-mcp> durch den vollständigen Pfad zu Ihrem lokalen Projektordner. Wenn die Datei bereits Eigenschaften enthält, fügen Sie mcpServers daneben hinzu und stellen Sie sicher, dass die vorherige Eigenschaft mit einem Komma endet.

4. Beenden Sie Claude Desktop vollständig und öffnen Sie es erneut.

5. Starten Sie einen neuen Chat und fragen Sie:

   What Genesys tools are available?

   Testen Sie dann die Dokumentation:

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

Geben Sie die Claude-Desktop-Konfiguration nicht weiter, wenn sie Ihr Client-Secret enthält. Für einen lokalen Test auf einem persönlichen Gerät ist die Übergabe der Anmeldedaten über den MCP-env-Block akzeptabel. Verwenden Sie einen dedizierten OAuth-Client mit den minimal erforderlichen Genesys-Berechtigungen.

Build-Prüfung

Führen Sie nach Codeänderungen die TypeScript-Build-Prüfung aus:

npm run build

Projektstruktur

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