genesys-mcp

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

読むだけでなく、構築します。

Claude（または任意のMCPクライアント）にプロンプトしてみてください：

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

• "通話フローを構築して：発信者に挨拶し、1を押すとWeekend Support、9を押すと通話終了。最初に図を見せて"

• "私のMain IVRを図として描いて"

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

フロービルダーは実際のArchy YAMLを生成し、チャット内でフローをMermaidダイアグラムとして表示し、その後Genesys独自のflow-jobsパイプライン（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 → クライアントを追加 → グラントタイプクライアント資格情報 → ロールを割り当て（ロールのスコープを参照）→ 保存。

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

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

AIを接続する

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

• Claude（ウェブ/デスクトップ）：設定 → コネクタ → カスタムコネクタを追加 → 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クライアントのロールに以下が必要です：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の作者であり、同じゼロ依存アーキテクチャを別のプラットフォームに向けたものです。IssueとPRを歓迎します。ロードマップはIssueトラッカーです。

MIT