Skip to main content
Glama
genesys-mcp
by veenabob6

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-mcp

自分でデプロイする3ステップ

Deploy to Cloudflare

  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ツール)

グループ

ツール

🔌 組織と接続

about, check_connection, list_divisions, list_did_pools

📞 キューとルーティング

list_queues, get_queue, create_queue ✏️, list_wrapup_codes, create_wrapup_code ✏️

👥 ユーザーとスキル

list_users, get_user, list_skills, create_skill ✏️, assign_user_skill ✏️

🌳 フロー(Architect)

list_flows, get_flow, get_flow_configuration, list_prompts, render_flow, export_flow

🏗️ フロービルダー

build_flow, publish_flow ✏️, get_flow_job, unlock_flow ✏️

⚡ パワー

genesys_api_call ✏️ (任意のPlatform APIエンドポイント;GET/POST/PUT/PATCHのみ)

✏️ = 書き込みツール。すべての名前は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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Genesys Cloud that enables AI assistants to build and manage queues, skills, users, wrap-up codes, and Architect flows, including a flow builder that renders diagrams and publishes via Genesys' validation pipeline.
      22
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server that puts your Genesys Cloud org under AI control, enabling natural language creation of queues, skills, users, wrap-up codes, and Architect IVR flows with Mermaid diagrams.
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server that puts a Genesys Cloud org in an AI assistant's hands, enabling it to build queues, skills, users, wrap-up codes, Architect flows, and outbound contact lists, campaigns, and cadences. It composes flows as diagrams and YAML, then publishes them through Genesys' own validation pipeline.
      MIT