genesys-mcp

Ihre Genesys Cloud-Organisation in den Händen Ihrer KI. Ein Open-Source-MCP-Server für Genesys Cloud auf Cloudflare Workers. Keine Abhängigkeiten, kein Terminal erforderlich, und sein einziger Zweck ist das Erstellen: Warteschlangen, Skills, Benutzer, Wrap-Up-Codes und Architect-Flows.

Es erstellt, nicht nur liest.

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

• "Erstelle eine Warteschlange namens Weekend Support"

• "Erstelle einen Anruffluss: Begrüße Anrufer, drücke 1 für Weekend Support, drücke 9 zum Beenden. Zeige mir zuerst das Diagramm."

• "Zeichne mein Main IVR als Diagramm"

• "Onboarding-Vorbereitung: Erstelle einen spanischen Skill und weise ihn Jess mit Kompetenzstufe 4 zu."

Der Flow-Builder erstellt echte Archy-YAML, zeigt Ihnen den Flow als Mermaid-Diagramm im Chat an und veröffentlicht ihn 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-Werkzeuge. Dieses Feld 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öschwerkzeuge, und das Raw-API-Tool verweigert DELETE. Von Grund auf auf Erstellen ausgelegt.

Related MCP server: Genesys Cloud MCP Server

Eigene Bereitstellung in 3 Schritten

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 → Grant-Typ Client Credentials → Rolle zuweisen (siehe Rollenabgrenzung) → 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 Zugangsschlüssel (einmalig angezeigt).

Bevorzugen Sie terminalgesteuerte 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 Zugangsschlüssel ein.

• Claude Code: claude mcp add --transport http genesys https://<your-worker>/mcp und authentifizieren Sie sich bei Aufforderung.

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

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

Dann versuchen Sie: "Überprüfe die Verbindung und liste meine Warteschlangen auf."

Das Werkzeugset (25 Werkzeuge)

✏️ = Schreibwerkzeug. Alles löst Namen in GUIDs für Sie auf, sodass "die Weekend Support Warteschlange" einfach funktioniert.

So funktioniert der Flow-Builder

1. build_flow wandelt eine Spezifikation (Begrüßung + DTMF-Menü + Warteschlangentransfers) 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 die YAML hoch und pollt. 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 existieren, und export_flow exportiert jeden Flow zurück in 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-Anmeldeinformationen befinden sich in Ihrem Cloudflare-Konto (Wrangler-Secrets oder der automatisch bereitgestellte KV) und nirgendwo sonst.

• 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 Zugangsschlüssel (rohes Bearer oder der integrierte OAuth 2.1-Flow für Connectors).

• Es gibt keine Löschwerkzeuge, und genesys_api_call verweigert DELETE grundsätzlich.

Rollenabgrenzung

Damit alles hier funktioniert, benötigt die Rolle des OAuth-Clients: Routing (Warteschlangen, Skills, Wrap-Up-Codes) anzeigen + hinzufügen, Directory-Benutzer anzeigen + bearbeiten (für Skill-Zuweisung), Architect-Flow anzeigen + hinzufügen + bearbeiten + veröffentlichen und Telephony-DID anzeigen. Master Admin funktioniert für eine Sandbox; für die Produktion den Umfang einschränken. 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

Entwickelt im offenen Rahmen von Ryan Shatzkamer (Director, Technical Services bei outboundIQ), Ersteller von five9-mcp, derselben abhängigkeitsfreien Architektur, die auf eine zweite Plattform abzielt. Issues und PRs sind willkommen; die Roadmap ist der Issue-Tracker.

MIT