genesys-mcp

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

Он создает, а не просто читает.

Подсказка для Claude (или любого MCP-клиента):

• "создай очередь под названием Weekend Support"

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

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

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

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

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

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

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

• Нет удаления. Нет инструментов удаления, и сырой API-инструмент отклоняет DELETE. Сначала создание — по замыслу.

Related MCP server: Genesys Cloud 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. Когда появится экран авторизации, вставьте ваш ключ доступа.

• 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 (или отправьте ключ доступа как Bearer-токен).

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

Инструментарий (25 инструментов)

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

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

1. build_flow преобразует спецификацию (приветствие + DTMF-меню + переводы в очередь) в Archy YAML и диаграмму Mermaid. Ваш ИИ сначала показывает диаграмму.

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

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

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

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

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

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

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

• Инструментов удаления нет, и genesys_api_call категорически отклоняет DELETE.

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

Чтобы все здесь работало, роль OAuth-клиента должна включать: просмотр и добавление маршрутизации (очереди, навыки, коды завершения), просмотр и редактирование пользователей каталога (для назначения навыков), просмотр, добавление, редактирование и публикацию потоков Architect, а также просмотр 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

О проекте

Создано в открытую Райаном Шацкамером (директор технических служб в outboundIQ), создателем five9-mcp, той же архитектуры с нулевыми зависимостями, направленной на вторую платформу. Приветствуются вопросы и PR; дорожная карта — это трекер задач.

MIT