genesys-mcp

Ihre Genesys-Cloud-Organisation in den Händen Ihrer KI. Ein Open-Source-MCP-Server für Genesys Cloud auf Cloudflare Workers. Null Abhängigkeiten, kein Terminal erforderlich, und sein einziger Zweck ist es zu bauen: Warteschlangen, Fähigkeiten, Benutzer, Wrap-up-Codes und Architect-Flows.

Es baut, nicht nur liest.

Fordern Sie Claude (oder einen beliebigen MCP-Client) auf:

• "Erstellen Sie eine Warteschlange namens Weekend Support"

• "Erstellen Sie einen Anruf-Flow: Begrüßen Sie Anrufer, drücken Sie 1 für Weekend Support, drücken Sie 9 zum Beenden des Anrufs. Zeigen Sie mir zuerst das Diagramm."

• "Zeichnen Sie meine Haupt-IVR als Diagramm"

• "Onboarding-Vorbereitung: Erstellen Sie eine Spanisch-Fähigkeit und weisen Sie sie Jess mit Kenntnisstufe 4 zu."

Der Flow-Builder erstellt echtes Archy-YAML, zeigt Ihnen den Flow als Mermaid-Diagramm im Chat und veröffentlicht dann über die eigene Flow-Jobs-Pipeline von Genesys (dieselbe, die CX as Code verwendet), sodass Genesys serverseitig validiert und veröffentlicht.

Was es bewusst NICHT tut

• Keine Analyse- oder KPI-Tools. Diese Spur ist bereits abgedeckt; für Gesprächsanalysen über MCP schauen Sie sich MakingChatbots' genesys-cloud-mcp-server an.

• Keine Kontaktlistenverwaltung.

• Keine Löschungen. Es gibt keine Lösch-Tools, und das Roh-API-Tool lehnt DELETE ab. Von Natur aus erst-erstellen.

Related MCP server: Genesys Cloud MCP Server

Eigene Instanz in 3 Schritten bereitstellen

1. Bereitstellen: Klicken Sie auf den Button (kostenloses Cloudflare-Konto) oder git clone + npx wrangler deploy. Der CONFIG-KV-Namespace wird automatisch bereitgestellt.

2. Genesys-OAuth-Client erstellen: Admin → Integrationen → OAuth → Client hinzufügen → Gewährungstyp Client Credentials → Rolle zuweisen (siehe Rolle eingrenzen) → speichern.

3. Konfigurieren: Öffnen Sie /setup auf Ihrem neuen Worker und fügen Sie Client-ID, Secret und Ihre Region ein. Der Assistent validiert sie live gegen Genesys, bevor er speichert, und übergibt Ihnen dann Ihren Zugriffsschlüssel (nur einmal angezeigt).

Bevorzugen Sie terminalverwaltete Konfiguration? Setzen Sie stattdessen Wrangler-Secrets; sie überschreiben den Assistenten: GENESYS_CLIENT_ID, GENESYS_CLIENT_SECRET, GENESYS_REGION (z. B. usw2.pure.cloud), MCP_AUTH_TOKEN.

Verbinden Sie Ihre KI

Der MCP-Endpunkt ist https://<your-worker>/mcp.

• Claude (Web/Desktop): Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → URL einfügen. Wenn der Autorisierungsbildschirm erscheint, fügen Sie Ihren Zugriffsschlüssel ein.

• Claude Code: claude mcp add --transport http genesys https://<your-worker>/mcp und authentifizieren Sie sich, wenn Sie dazu aufgefordert werden.

• ChatGPT: Einstellungen → Connectors → Erweitert → Entwicklermodus → MCP-Server-URL hinzufügen.

• Alles andere: Standard-Streamable-HTTP-MCP mit OAuth 2.1 (oder senden Sie den Zugriffsschlüssel als Bearer-Token).

Dann versuchen Sie: "Überprüfen Sie die Verbindung und listen Sie meine Warteschlangen auf."

Die Toolbox (25 Tools)

✏️ = Schreib-Tool. Alles löst Namen für Sie in GUIDs auf, sodass „die Weekend-Support-Warteschlange“ einfach funktioniert.

So funktioniert der Flow-Builder

1. build_flow wandelt eine Spezifikation (Begrüßung + DTMF-Menü + Warteschlangen-Transfers) in Archy-YAML und ein Mermaid-Diagramm um. Ihre KI zeigt Ihnen zuerst das Diagramm.

2. publish_flow registriert einen Architect-Flow-Job, lädt das YAML hoch und fragt ab. Genesys validiert und veröffentlicht serverseitig; Validierungsfehler werden wörtlich zurückgegeben.

3. render_flow erstellt auch Diagramme für Flows, die bereits in Ihrer Organisation vorhanden sind, und export_flow führt jeden Flow zurück zu YAML.

TTS ist inline im Flow (die TTS-Engine Ihrer Organisation spricht ihn), sodass keine Audiodateien aufgenommen oder hochgeladen werden müssen.

Sicherheitsmodell

• Ihre Genesys-Anmeldedaten liegen in Ihrem Cloudflare-Konto (Wrangler-Secrets oder der automatisch bereitgestellte KV) und sonst nirgendwo.

• Die KI kann nur das tun, was die Rolle des OAuth-Clients erlaubt. Sie legen den Umfang fest; Genesys setzt ihn durch.

• Der MCP-Endpunkt erfordert den Zugriffsschlüssel (rohes Bearer-Token oder den integrierten OAuth-2.1-Flow für Connectors).

• Es gibt keine Lösch-Tools, und genesys_api_call lehnt DELETE kategorisch ab.

Rolle eingrenzen

Damit alles hier funktioniert, benötigt die Rolle des OAuth-Clients: Routing (Warteschlangen, Fähigkeiten, Wrap-up-Codes) anzeigen + hinzufügen, Directory-Benutzer anzeigen + bearbeiten (für die Fähigkeitszuweisung), Architect-Flow anzeigen + hinzufügen + bearbeiten + veröffentlichen und Telephony-DID anzeigen. Master Admin funktioniert für eine Sandbox; für die Produktion enger fassen. Der Server kann immer nur so mächtig sein wie die Rolle, die Sie zuweisen.

Lokale Entwicklung

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

Über

Offen gebaut von Ryan Shatzkamer (Director, Technical Services bei outboundIQ), Ersteller von five9-mcp, derselben Null-Abhängigkeits-Architektur, die auf eine zweite Plattform ausgerichtet ist. Issues und PRs sind willkommen; die Roadmap ist der Issue-Tracker.

MIT