Genesys MCP

Независимый от поставщика сервер протокола контекста модели (MCP) для Genesys Cloud.

genesys-mcp — это сервер протокола контекста модели (MCP), который предоставляет возможности платформы Genesys Cloud — очереди, разговоры, пользователи, статус присутствия, аналитика — в виде инструментов, ресурсов и промптов MCP. Любой ИИ-агент, совместимый с MCP, может взаимодействовать с Genesys через него: Claude Desktop, Claude Code, Cursor, Continue, Cline и любой пользовательский агент, созданный на базе LangGraph, LangChain, CrewAI, AutoGen или SDK провайдера.

Статус

v0.1.0 — предварительный выпуск. Фреймворк, транспорты и уровень надежности уже готовы. Первая партия инструментов только для чтения появится в v0.2; курируемые инструменты записи (за флагом --enable-writes) и ресурсы/промпты появятся в v0.3. Релиз v1.0 будет включать всё сразу вместе с PyPI, Docker (GHCR), прослойкой npx и пакетом MCPB.

Related MCP server: agent-notify

Зачем

В экосистеме MCP уже есть сервер Genesys Cloud, но он поставляется только с stdio без HTTP-транспорта, не имеет контекста аутентификации для каждого запроса (один глобальный логический флаг модуля управляет всем процессом) и не имеет уровня надежности промышленного уровня (нет обработки 429, нет обновления токенов, нет структурированного логирования). genesys-mcp разработан для промышленного использования: готовый к хостингу Streamable HTTP, аутентификация для каждого запроса, повторные попытки с учетом 429, обновление при 401, структурированные логи и трассировка OpenTelemetry — всё с первого дня и всё независимо от поставщика.

Быстрый старт

Инструменты еще не выпущены — эти фрагменты показывают шаблон установки. v0.2 перечислит здесь фактическую поверхность инструментов.

Claude Desktop

Добавьте запись в раздел mcpServers в вашем файле claude_desktop_config.json:

{
  "mcpServers": {
    "genesys": {
      "command": "uvx",
      "args": ["genesys-mcp"],
      "env": {
        "GENESYS_REGION": "mypurecloud.com",
        "GENESYS_CLIENT_ID": "...",
        "GENESYS_CLIENT_SECRET": "..."
      }
    }
  }
}

Claude Code или Cursor

Добавьте запись в конфигурацию сервера MCP вашего редактора (.claude/settings.json для Claude Code, панель настроек MCP в Cursor для Cursor):

{
  "mcpServers": {
    "genesys": {
      "command": "genesys-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "GENESYS_REGION": "mypurecloud.com",
        "GENESYS_CLIENT_ID": "...",
        "GENESYS_CLIENT_SECRET": "..."
      }
    }
  }
}

Программный Python

Подключитесь через официальный Python-клиент mcp по stdio или HTTP:

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

params = StdioServerParameters(command="genesys-mcp", args=["--transport", "stdio"])

async with stdio_client(params) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        # tools = await session.list_tools()  # available from v0.2

Для HTTP-транспорта запустите genesys-mcp --transport http --port 8000 и подключите ваш MCP-клиент к http://localhost:8000.

Установка

pip install genesys-mcp

Ожидается в v1.0: опубликовано на PyPI, GHCR, npm shim, и в виде пакета MCPB, прикрепленного к релизам GitHub.

Транспорты

Оба транспорта используют одну и ту же поверхность инструментов. Выбор транспорта определяется окружением (MCP_TRANSPORT=stdio|http) или CLI (--transport).

Безопасность

HTTP-транспорт в версии v0.x поставляется без аутентификации. Уровень фрейминга MCP не выполняет никакой аутентификации вызывающей стороны; сервер доверяет любому процессу, который может получить доступ к прослушиваемому порту. У операторов есть два ответственных варианта развертывания:

1. Привязка только к 127.0.0.1 (по умолчанию MCP_HOST) и разрешение локальным агентам подключаться через loopback.

2. Привязка к адресу, отличному от loopback, только за обратным прокси-сервером (nginx, Caddy, Cloudflare Access, API-шлюз), который выполняет аутентификацию и авторизацию перед пересылкой в genesys-mcp.

Привязка к 0.0.0.0 без фронтального уровня аутентификации раскрывает вышестоящие учетные данные Genesys любому пользователю в сети. Поэтому Docker-образ по умолчанию использует MCP_HOST=127.0.0.1; операторы, которым действительно нужна публичная привязка, должны явно выбрать это с помощью -e MCP_HOST=0.0.0.0.

Размещенный мультиарендный шлюз с первоклассной аутентификацией, аудитом и RBAC находится в дорожной карте Pro/SaaS (см. ADR-006 в docs/warm/decisions.md).

Модель доверия

Несколько вещей, которые нужно знать перед установкой плагинов или запуском в промышленной среде:

• Плагины точек входа (группа genesys_mcp.plugins) выполняются в процессе сервера с полным доступом ко всем зависимостям, переменным окружения и учетным данным Genesys, которые есть у сервера. Устанавливайте только те плагины, которым доверяете.

• Хук лицензии (группа genesys_mcp.license) — это функциональный ограничитель, а не средство контроля безопасности. Любой установленный пакет может зарегистрировать его, и любой плагин может игнорировать ответ. Он существует для того, чтобы пакет Pro мог выражать права доступа; относитесь к нему соответственно.

• Секреты OAuth-клиента загружаются из переменных окружения (и файла .env, если он есть), и сам сервер никогда их не логирует. Мы не можем гарантировать то же самое для сторонних плагинов — проверяйте их или запускайте с LOG_LEVEL=INFO и проверяйте вывод, прежде чем доверять им секреты.

Конфигурация

Конфигурация считывается из переменных окружения (или файла .env). См. .env.example для получения полного списка. Самые важные переменные:

Разработка

git clone https://github.com/digitalvanguardsolutions/genesys-mcp.git
cd genesys-mcp

uv sync --all-extras

uv run pytest
uv run ruff check src tests
uv run mypy src

uv run genesys-mcp --transport stdio

pre-commit install подключит ruff, mypy и запуск pytest перед push.

Лицензия

MIT — см. LICENSE. Авторское право 2026 Digital Vanguard Solutions.