genesys-mcp
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
DELETEab. Von Natur aus erst-erstellen.
Related MCP server: genesys-mcp
Eigene Instanz in 3 Schritten bereitstellen
Bereitstellen: Klicken Sie auf den Button (kostenloses Cloudflare-Konto) oder
git clone+npx wrangler deploy. Der CONFIG-KV-Namespace wird automatisch bereitgestellt.Genesys-OAuth-Client erstellen: Admin → Integrationen → OAuth → Client hinzufügen → Gewährungstyp Client Credentials → Rolle zuweisen (siehe Rolle eingrenzen) → speichern.
Konfigurieren: Öffnen Sie
/setupauf 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>/mcpund 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)
Gruppe | Tools |
🔌 Organisation & Verbindung |
|
📞 Warteschlangen & Routing |
|
👥 Benutzer & Fähigkeiten |
|
🌳 Flows (Architect) |
|
🏗️ Flow-Builder |
|
⚡ Leistung |
|
✏️ = Schreib-Tool. Alles löst Namen für Sie in GUIDs auf, sodass „die Weekend-Support-Warteschlange“ einfach funktioniert.
So funktioniert der Flow-Builder
build_flowwandelt eine Spezifikation (Begrüßung + DTMF-Menü + Warteschlangen-Transfers) in Archy-YAML und ein Mermaid-Diagramm um. Ihre KI zeigt Ihnen zuerst das Diagramm.publish_flowregistriert einen Architect-Flow-Job, lädt das YAML hoch und fragt ab. Genesys validiert und veröffentlicht serverseitig; Validierungsfehler werden wörtlich zurückgegeben.render_flowerstellt auch Diagramme für Flows, die bereits in Ihrer Organisation vorhanden sind, undexport_flowfü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_calllehntDELETEkategorisch 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for Genesys Cloud Platform API, enabling queue search, conversation analysis, call quality, sentiment, topics, and transcript retrieval.MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for Genesys Cloud that enables AI assistants to build and manage queues, skills, users, wrap-up codes, and Architect flows, including a flow builder that renders diagrams and publishes via Genesys' validation pipeline.22MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that puts your Genesys Cloud org under AI control, enabling natural language creation of queues, skills, users, wrap-up codes, and Architect IVR flows with Mermaid diagrams.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that puts a Genesys Cloud org in an AI assistant's hands, enabling it to build queues, skills, users, wrap-up codes, Architect flows, and outbound contact lists, campaigns, and cadences. It composes flows as diagrams and YAML, then publishes them through Genesys' own validation pipeline.MIT