Genesys Flow MCP

Genesys Cloud に接続し、IVR ルートを一覧表示し、IVR の設定済み営業時間内フローを取得して、読みやすい Markdown ドキュメントを生成するローカル MCP サーバーです。

生成されたドキュメントは、ビジネス関係者と技術者の両方を対象とした構成になっています。

• ルート — IVR 名、ID、状態、DNIS（利用可能な場合）、および設定済みフロー。

• ビジネス面 — フローの目的と顧客メニューのルーティング。

• 技術面 — フロー設定、変数、プロンプト/TTS、タスク、メニュー、分岐パス。

• 統合とルーティングの依存関係 — データアクション、ボットフロー、ACD キュー。

前提条件

• Node.js 18 以降

• クライアント認証情報 付与を使用する Genesys Cloud OAuth クライアント

• 関連する Genesys Cloud 組織で Architect IVR とフローを読み取る権限

Related MCP server: Hive Mind MCP Server

インストールと設定

依存関係をインストールします。

cd <path-to-genesys-flow-mcp>
npm install

プロジェクトのルートに .env ファイルを作成します。

GENESYS_CLIENT_ID=your-client-id
GENESYS_CLIENT_SECERET=your-client-secret
GENESYS_REGION=ie

重要: GENESYS_CLIENT_SECERET は、現在のソースコードに一致するため、意図的にこのように綴られています。src/config/env.ts も更新しない限り、SECRET に名前を変更しないでください。

GENESYS_REGION を Genesys Cloud リージョンのサフィックス（例: mypurecloud.ie の場合は ie）に設定します。

ローカルでの実行

開発用:

npm run dev

デスクトップクライアントが使用するコンパイル済みサーバーの場合:

npm run build
npm start

サーバーは MCP stdio トランスポートを使用します。MCP クライアントによって起動されます。ブラウザの URL や HTTP ポートを公開しません。

MCP Inspector でテストする

MCP Inspector を使用して、Claude Desktop に接続する前にサーバーを直接テストします。

cd <path-to-genesys-flow-mcp>
npm run inspect

Inspector によってローカルブラウザのインターフェースが開きます。その中で:

1. デフォルトの stdio 設定を使用してサーバーに接続します。

2. ツール タブを開きます。

3. get_ivrs を実行して、Genesys の認証とルートの取得を確認します。

4. IVR 名を指定して get_flow_by_name を実行します。例:

   {
     "name": "testt call"
   }

5. レスポンスが ルート セクションで始まり、設定済みのフロー、プロンプト、統合が含まれていることを確認します。

利用可能なツール

get_ivrs

Genesys Cloud のルーティング/IVR リストを返します。

リクエスト例:

List the available Genesys IVRs.

get_flow_by_name

名前で IVR を検索し、設定されている営業時間内フローを取得して、Markdown ドキュメントを返します。

入力:

{
  "name": "testt call"
}

リクエスト例:

Use get_flow_by_name for the IVR named "testt call".

IVR が見つからない場合、または営業時間内フローがない場合は、問題を説明するエラーが返されます。

生成されるドキュメントの内容

ドキュメントは以下の関係に従います:

Genesys IVR Route
        ↓
Configured Open-Hours Flow
        ├── Business Focus: customer routing and menu choices
        └── Technical Focus: prompts, variables, tasks, menus, integrations

統合の検出は、以下の一般的な Architect の依存関係を対象としています:

タスクやメニューの挨拶で見つかったすべての TTS プロンプトは、技術的なフローの説明に含まれます。

Claude Desktop でテストする

1. プロジェクトをビルドします:

   cd <path-to-genesys-flow-mcp>
   npm run build

2. Claude Desktop で、以下を開きます:

   File → Settings → Developer → Edit Config

3. 開いた JSON ファイルの最上位レベルに次を追加します。preferences など既存の設定は保持してください。

   {
     "mcpServers": {
       "genesys-flow": {
         "command": "node",
         "args": [
           "<path-to-genesys-flow-mcp>\\dist\\index.js"
         ],
         "env": {
           "GENESYS_CLIENT_ID": "your-client-id",
           "GENESYS_CLIENT_SECERET": "your-client-secret",
           "GENESYS_REGION": "ie"
         }
       }
     }
   }

   <path-to-genesys-flow-mcp> をローカルプロジェクトフォルダのフルパスに置き換えます。ファイルにすでにプロパティが含まれている場合は、mcpServers をそれらに追加し、前のプロパティがカンマで終わっていることを確認します。

4. Claude Desktop を完全に終了して、再度開きます。

5. 新しいチャットを開始して、次のように尋ねます:

   What Genesys tools are available?

   次に、ドキュメントをテストします:

   Use get_flow_by_name for the IVR named "testt call" and document its route, configured flow, prompts, and integrations.

クライアントシークレットが含まれている場合は、Claude Desktop の設定をコミットしたり共有したりしないでください。個人用デバイスでのローカルテストでは、MCP の env ブロックを介して認証情報を渡しても問題ありません。最小限の必要な Genesys 権限を持つ専用の OAuth クライアントを使用してください。

ビルドチェック

コード変更後に TypeScript のビルドチェックを実行します:

npm run build

プロジェクト構成

src/
├── config/       Environment variable validation
├── mcp/          MCP server and tool registration
├── services/     Genesys authentication, API access, and documentation generation
├── tools/        MCP tool handlers
└── types/        Genesys Cloud response types