genesys-mcp

あなたのGenesys Cloud組織を、あなたのAIの手に。 Cloudflare Workers上で動作する、Genesys Cloud向けのオープンソースMCPサーバーです。依存関係ゼロ、ターミナル不要で、その目的はただ一つ、構築することです：キュー、スキル、ユーザー、ラップアップコード、そしてArchitectフロー。

読み取るだけでなく、構築します。

Claude（または任意のMCPクライアント）にプロンプトを送信：

• 「Weekend Supportというキューを作成して」

• 「コールフローを作成：発信者に挨拶、1を押すとWeekend Support、9を押すと通話終了。最初に図を表示して」

• 「メインIVRを図として描画して」

• 「オンボード準備：スペイン語スキルを作成し、習熟度4でJessに割り当てて」

フロービルダーは実際のArchy YAMLを構成し、チャット内でフローをMermaid図として表示した後、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. Genesys OAuthクライアントを作成：管理 → 統合 → OAuth → クライアント追加 → 許可タイプ Client Credentials → ロールを割り当て（役割のスコープ設定を参照）→ 保存。

3. 設定：新しいWorkerで/setupを開き、クライアントID、シークレット、リージョンを貼り付けます。ウィザードは保存前にGenesysに対してライブで検証し、その後アクセスキー（一度だけ表示）を提供します。

ターミナルで設定を管理したい場合？代わりにWranglerシークレットを設定してください。ウィザードより優先されます：GENESYS_CLIENT_ID、GENESYS_CLIENT_SECRET、GENESYS_REGION（例：usw2.pure.cloud）、MCP_AUTH_TOKEN。

AIを接続

MCPエンドポイントはhttps://<your-worker>/mcpです。

• Claude（Web/デスクトップ）：設定 → コネクタ → カスタムコネクタを追加 → URLを貼り付け。認証画面が表示されたら、アクセスキーを貼り付けます。

• Claude Code：claude mcp add --transport http genesys https://<your-worker>/mcp を実行し、プロンプトに従って認証します。

• ChatGPT：設定 → コネクタ → 詳細設定 → デベロッパーモード → MCPサーバーURLを追加。

• その他：標準のストリーミング可能なHTTP MCP（OAuth 2.1対応）、またはアクセスキーをBearerトークンとして送信。

その後、試してみてください："接続を確認して、私のキューを一覧表示して。"

ツールボックス（25ツール）

✏️ = 書き込みツール。すべてのツールは名前をGUIDに自動解決するため、「Weekend Supportキュー」と指定するだけで機能します。

フロービルダーの仕組み

1. build_flowは仕様（挨拶 + DTMFメニュー + キュー転送）をArchy YAMLとMermaid図に変換します。AIが最初に図を表示します。

2. publish_flowはArchitectフロージョブを登録し、YAMLをアップロードしてポーリングします。Genesysがサーバーサイドで検証および公開し、検証エラーはそのまま返されます。

3. render_flowは組織内に既存のフローも図示し、export_flowは任意のフローをYAMLにラウンドトリップします。

TTSはフロー内にインラインで含まれます（組織のTTSエンジンが読み上げるため）、録音やアップロードする音声ファイルは不要です。

セキュリティモデル

• Genesysの認証情報はあなたのCloudflareアカウント（Wranglerシークレットまたは自動プロビジョニングされたKV）にのみ保存され、他の場所には保存されません。

• AIは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

概要

Ryan Shatzkamer（outboundIQ、テクニカルサービスディレクター）によって公開で構築されました。five9-mcpの作成者でもあり、同じ依存関係ゼロのアーキテクチャを別のプラットフォームに向けたものです。IssueとPRは歓迎します。ロードマップはIssueトラッカーにあります。

MIT