Genesys MCP

Genesys Cloud向けのベンダーニュートラルなModel Context Protocolサーバー。

genesys-mcpは、Genesys Cloudプラットフォームの機能（キュー、会話、ユーザー、プレゼンス、分析）をMCPツール、リソース、プロンプトとして公開するModel Context Protocol (MCP) サーバーです。Claude Desktop、Claude Code、Cursor、Continue、Cline、およびLangGraph、LangChain、CrewAI、AutoGen、または生のプロバイダーSDK上に構築されたカスタムエージェントなど、MCP互換のAIエージェントであれば、これを通じてGenesysと対話できます。

ステータス

v0.1.0 — プレリリース。 フレームワーク、トランスポート、信頼性レイヤーが実装されています。読み取り専用ツールの最初のバッチはv0.2で提供され、厳選された書き込み機能（--enable-writesで有効化）およびリソース/プロンプトはv0.3で提供されます。v1.0のローンチでは、PyPI、Docker (GHCR)、npxシム、MCPBバンドルとともにすべてが提供されます。

Related MCP server: agent-notify

理由

MCPエコシステムにはすでにGenesys Cloudサーバーが存在しますが、HTTPトランスポートなしのstdioのみで提供されており、リクエストごとの認証コンテキストがなく（モジュールグローバルな単一のブール値がプロセス全体を制御）、本番環境向けの信頼性レイヤー（429ハンドリング、トークン更新、構造化ログなし）もありません。genesys-mcpは、ホスト対応のStreamable HTTP、リクエストごとの認証、429対応の再試行、401時の更新、構造化ログ、OpenTelemetryトレーシングなど、本番環境の要件を初日からすべて満たし、かつベンダーニュートラルに設計されています。

クイックスタート

ツールはまだ提供されていません。これらのスニペットはインストールパターンを示しています。v0.2で実際のツール面がここにリストされます。

Claude Desktop

claude_desktop_config.jsonのmcpServersの下にエントリを追加します：

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

Claude CodeまたはCursor

エディタのMCPサーバー設定（Claude Codeの場合は.claude/settings.json、Cursorの場合はCursorのMCP設定パネル）にエントリを追加します：

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

プログラムによるPython利用

公式のmcp Pythonクライアントを使用して、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、およびGitHub Releasesに添付されたMCPBバンドルとして公開されます。

トランスポート

両方のトランスポートは同じツール面を共有します。トランスポートの選択は環境変数（MCP_TRANSPORT=stdio|http）またはCLI（--transport）によって行われます。

セキュリティ

v0.xのHTTPトランスポートは認証なしで提供されます。MCPフレーミングレイヤーは呼び出し元の認証を行わず、サーバーはリスニングポートに到達できるプロセスをすべて信頼します。運用者は以下の2つの責任あるデプロイメントオプションを選択できます：

1. 127.0.0.1のみ（デフォルトのMCP_HOST）にバインドし、ローカルエージェントがループバック経由で接続できるようにする。

2. 認証と認可を行うリバースプロキシ（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ロードマップに含まれています（docs/warm/decisions.mdのADR-006を参照）。

信頼モデル

プラグインをインストールしたり、本番環境で実行したりする前に知っておくべきことがいくつかあります：

• エントリーポイントプラグイン（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実行が設定されます。

ライセンス

MIT — LICENSEを参照してください。Copyright 2026 Digital Vanguard Solutions.