genesys-mcp

Ваша организация Genesys Cloud — в руках вашего ИИ. MCP-сервер с открытым исходным кодом для Genesys Cloud на Cloudflare Workers. Ноль зависимостей, терминал не требуется, и его единственное предназначение — создавать: очереди, навыки, пользователей, коды завершения и сценарии Architect.

Он создаёт, а не только читает.

Подскажите Claude (или любому MCP-клиенту):

• «создай очередь Weekend Support»

• «создай голосовой сценарий: поприветствуй звонивших, нажмите 1 для Weekend Support, нажмите 9 для завершения звонка. сначала покажи диаграмму»

• «нарисуй мой Main IVR в виде диаграммы»

• «подготовка к онбордингу: создай испанский навык (skill) и назначь его Джесс с уровнем 4»

Конструктор сценариев (flow builder) собирает настоящий YAML для Archy, показывает сценарий в виде диаграммы Mermaid прямо в чате, а затем публикует его через собственный конвейер заданий сценариев Genesys (тот же, что использует CX as Code), так что Genesys проверяет валидность и публикует на стороне сервера.

Чего он намеренно НЕ делает

• Без аналитики и KPI-инструментов. Это направление уже закрыто; для аналитики разговоров через MCP обратите внимание на genesys-cloud-mcp-server от MakingChatbots.

• Без управления списками контактов.

• Без удалений. Инструментов для удаления нет, а «сырой» API-инструмент отклоняет DELETE. По замыслу — только создание.

Related MCP server: Salesforce MCP Server

Разверните свой собственный за 3 шага

1. Разверните: нажмите кнопку (бесплатный аккаунт Cloudflare) или git clone + npx wrangler deploy. Пространство имён CONFIG KV будет подготовлено автоматически.

2. Создайте OAuth-клиент Genesys: Admin → Integrations → OAuth → Add Client → тип предоставления Client Credentials → назначьте роль (см. Ограничение роли) → сохраните.

3. Настройте: откройте /setup на вашем новом Worker и вставьте Client ID, Secret и ваш регион. Мастер проверяет их в реальном времени через Genesys перед сохранением, после чего выдаёт ваш ключ доступа (показывается один раз).

Предпочитаете настройку через терминал? Вместо этого задайте секреты Wrangler; они переопределяют мастер: GENESYS_CLIENT_ID, GENESYS_CLIENT_SECRET, GENESYS_REGION (например, usw2.pure.cloud), MCP_AUTH_TOKEN.

Подключите свой ИИ

Конечная точка MCP: https://<your-worker>/mcp.

• Claude (веб/десктоп): Settings → Connectors → Add custom connector → вставьте URL. Когда появится экран авторизации, вставьте ваш access key.

• Claude Code: claude mcp add --transport http genesys https://<your-worker>/mcp и пройдите аутентификацию по запросу.

• ChatGPT: Settings → Connectors → Advanced → Developer mode → добавьте URL MCP-сервера.

• Всё остальное: стандартный потоковый HTTP MCP с OAuth 2.1 (или отправка access key в качестве Bearer-токена).

Затем попробуйте: «проверь соединение и покажи мои очереди».

Набор инструментов (28 инструментов)

✏️ = инструмент записи. Все имена преобразуются в GUID автоматически, поэтому «очередь Weekend Support» просто работает.

Как работает конструктор сценариев

1. build_flow превращает спецификацию в Archy YAML и диаграмму Mermaid: приветствие TTS, опциональная проверка рабочего времени (в рабочее время — в меню; в нерабочее время и праздники — сообщение, затем завершение звонка или голосовая почта) и DTMF-меню, варианты которого могут переводить в очередь, принимать голосовую почту очереди, набирать внешний номер или завершать звонок. Ваш ИИ сначала покажет диаграмму.

2. publish_flow регистрирует задание сценария Architect, загружает YAML и опрашивает статус. Genesys проверяет и публикует на стороне сервера; ошибки проверки возвращаются дословно.

3. render_flow также строит диаграммы для сценариев, которые уже есть в вашей организации, а export_flow преобразует любой сценарий обратно в YAML.

TTS включён прямо в сценарий (его озвучивает TTS-движок вашей организации), поэтому записывать или загружать аудиофайлы не нужно.

Модель безопасности

• Ваши учётные данные Genesys хранятся в вашем аккаунте Cloudflare (секреты Wrangler или автоматически подготовленное KV) и больше нигде.

• ИИ может делать только то, что разрешает роль OAuth-клиента. Вы задаёте границы; Genesys их обеспечивает.

• Конечная точка MCP требует access key (прямой Bearer или встроенный поток OAuth 2.1 для коннекторов).

• Инструментов для удаления не существует, а genesys_api_call полностью отклоняет DELETE.

Ограничение роли

Чтобы всё здесь работало, роль OAuth-клиента должна включать: Routing (очереди, навыки, коды завершения) просмотр + добавление, Directory просмотр + редактирование пользователей (для назначения навыков), Architect просмотр + добавление сценариев + редактирование + публикация, Telephony просмотр DID. Master Admin подходит для песочницы; для продакшена уменьшайте права. Сервер может быть не «сильнее» роли, которую вы назначили.

Локальная разработка

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

О проекте

Создан в открытом формате Ryan Shatzkamer (директор по техническим вопросам в outboundIQ), автор five9-mcp, та же архитектура с нуля зависимостей, применённая к второй платформе. Принимаются issues заявки; добро пожаловать и PR; дорожная карта ведётся в трекере issues.

MIT