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独自のフロージョブパイプライン（CX as Codeが使用しているものと同じ）を通じて公開します。これによりGenesysがサーバー側で検証および公開します。

意図的に行わないこと

• 分析やKPIツールはありません。 その領域はすでにカバーされています。MCP経由の会話分析が必要な場合は、MakingChatbotsのgenesys-cloud-mcp-server をチェックしてください。

• コンタクトリスト管理はありません。

• 削除機能はありません。 削除ツールは存在せず、生APIツールもDELETEを拒否します。設計上、作成優先です。

3ステップで自分専用にデプロイ

1. デプロイ: ボタンをクリックするか（無料のCloudflareアカウント）、git clone + npx wrangler deploy を実行します。CONFIG KV名前空間は自動プロビジョニングされます。

2. Genesys OAuthクライアントを作成: Admin → Integrations → OAuth → Add Client → 許可タイプ Client Credentials → ロールを割り当て（ロールのスコープ を参照）→ 保存。

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（Web/デスクトップ）: 設定 → Connectors → Add custom connector → URLを貼り付けます。承認画面が表示されたら、アクセスキーを貼り付けます。

• Claude Code: claude mcp add --transport http genesys https://<your-worker>/mcp を実行し、プロンプトが表示されたら認証します。

• ChatGPT: 設定 → Connectors → Advanced → Developer mode → MCPサーバーURLを追加します。

• その他: OAuth 2.1を使用した標準のストリーミング可能なHTTP MCP（またはアクセスキーを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の作者であり、同じゼロ依存アーキテクチャを2番目のプラットフォームに向けたものです。IssueとPRを歓迎します。ロードマップはイシュートラッカーです。

MIT