genesys-mcp

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

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

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

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

• 「コールフローを構築して：発信者に挨拶し、1でWeekend Support、9で通話終了。最初に図を見せて」

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

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

フロービルダーは実際のArchy YAMLを構成し、チャット内でフローをMermaid図として表示し、Genesys独自のフロージョブパイプライン（CX as Codeが使用するものと同じ）を通じて公開します。これにより、Genesysがサーバー側で検証・公開します。

意図的に行わないこと

• 分析やKPIツールはありません。 その領域はすでにカバーされています。MCP経由の会話分析については、MakingChatbotsのgenesys-cloud-mcp-serverを参照してください。

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

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

Related MCP server: Salesforce MCP Server

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

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

• ChatGPT：Settings → Connectors → Advanced → Developer mode → MCPサーバーURLを追加。

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

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

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

✏️ = 書き込みツール。すべての名前はGUIDに自動解決されるため、「Weekend Supportキュー」がそのまま機能します。

フロービルダーの仕組み

1. build_flowは仕様をArchy YAMLとMermaid図に変換します：TTSグリーティング、オプションの営業時間ゲート（営業中はメニューへ、閉店・祝日はメッセージを再生して切断またはボイスメール）、そして選択肢がキューへの転送、キューのボイスメール取得、外部番号へのダイヤル、切断のいずれかを実行できるDTMFメニュー。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の表示。サンドボックスではマスター管理者で動作しますが、本番ではスコープを絞ってください。サーバーは割り当てたロールと同じ力しか持てません。

ローカル開発

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は歓迎します。ロードマップはイシュートラッカーです。

MIT