Pega Dx MCP

🚀 Pega DX MCP Server

このパッケージは、Model Context Protocolを通じて、Pega Infinity™の対話を直感的な会話型体験に変えます。Pega DX APIと自然言語インターフェースを橋渡しすることで、GenAIエージェント、IDE、その他のMCP対応ツールが、シンプルで人間が読みやすいコマンドを使用してPega Infinity™アプリケーションと対話できるようになります。

🚀 クイックスタート

前提条件

• Node.js (22+) と npm
• DX APIが有効になっているPega Infinity™ (23+) へのアクセス
• OAuth 2.1クライアントの資格情報

インストール

# npmからインストール（推奨）
npm install -g @marco-looy/pega-dx-mcp

MCPクライアントとの統合

Claude Desktop、Claude Code、Clineなど、多くのMCP対応アプリケーションと互換性があります。MCPクライアントの設定ファイルに以下を追加してください。

{
  "mcpServers": {
    "pega-dx-mcp": {
      "command": "npx",
      "args": ["-y", "@marco-looy/pega-dx-mcp"],
      "env": {
        "PEGA_BASE_URL": "https://your-pega-instance.com",
        "PEGA_CLIENT_ID": "your-client-id",
        "PEGA_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

設定ファイルの場所:

• Claude Desktop: MCPサーバーを追加する方法について、Claude Desktopのドキュメントを参照してください。
• Claude Code: MCPサーバーを構成する方法について、Claude Codeのドキュメントを参照してください。
• Cline: Cline MCP設定を編集する方法について、Clineのドキュメントを参照してください。

💡 使用アドバイス MCPクライアントを再起動し、Pega DX MCPツールが利用可能であることを確認してください。

✨ 主な機能

• 🤖 自然言語インターフェース - 「Johnの旅行請求を作成する」などの会話型ケース作成を実証します。
• 🔌 プラグアンドプレイ統合 - GenAIエージェント、IDE、およびMCP対応ツールとの実験的な互換性。
• 🧪 イノベーションプロトタイプ - 包括的なエラー処理アプローチを備えたエンタープライズグレードのパターンを探索します。
• 📡 API統合探索 - ケース、アサインメント、添付ファイル、およびデータ操作へのアクセスを調査します。
• ⚡ パフォーマンス研究 - インテリジェントキャッシュと最適化戦略を実験します。
• 🛡️ セキュリティフレームワーク - PKCEを備えたOAuth 2.1とロールベースのアクセス制御パターンを実装します。

🧪 実験的なプロジェクト

Pega DX MCP Serverは、Model Context ProtocolとPega Infinity™の機能の融合を探索する実験的なプロジェクトです。これは公式のPegasystems製品ではなく、一般に利用できるものではありません。すべてのコマンド、パラメーター、その他の機能は、事前の通知なしに随時変更または廃止される可能性があります。本番環境での機能にこのMCPサーバーを使用しないでください。この実験は、Pega Infinity™の対話における自然言語インターフェースの可能性を示しています。GenAIによるビジネス自動化の未来を形作るためのフィードバックと貢献を歓迎します。

🏗️ アーキテクチャ

Pega DX MCP Serverは、Model Context Protocolを使用してGenAIアプリケーションとPega Infinityを橋渡しします。

🛠️ 利用可能なツール

Pega DX MCP Serverは、10以上の機能カテゴリーにまとめられた60以上の包括的なツールを提供します。各カテゴリーは、環境変数を介して個別に有効または無効にすることができます。

🔧 ツールの設定

MCPクライアントの設定で環境変数を使用して、どのツールカテゴリーを読み込むかを制御します。すべてのカテゴリーはデフォルトで有効になっています。無効にするには、"false"に設定してください。

例 - コアケース管理ツールのみを有効にする:

{
  "mcpServers": {
    "pega-dx-mcp": {
      "command": "npx",
      "args": ["-y", "@marco-looy/pega-dx-mcp"],
      "env": {
        "PEGA_BASE_URL": "https://your-pega-instance.com",
        "PEGA_CLIENT_ID": "your-client-id",
        "PEGA_CLIENT_SECRET": "your-client-secret",
        "PEGA_SERVICE_TOOLS": "true",
        "PEGA_CASETYPE_TOOLS": "true",
        "PEGA_CASE_TOOLS": "true",
        "PEGA_ASSIGNMENT_TOOLS": "false",
        "PEGA_ATTACHMENT_TOOLS": "false",
        "PEGA_DATAVIEW_TOOLS": "false",
        "PEGA_DOCUMENT_TOOLS": "false",
        "PEGA_FOLLOWER_TOOLS": "false",
        "PEGA_PARTICIPANT_TOOLS": "false",
        "PEGA_RELATED_CASE_TOOLS": "false",
        "PEGA_TAG_TOOLS": "false"
      }
    }
  }
}

📋 ツールの完全なリスト

アサインメントツール (9)

• get_assignment - 詳細なアサインメント情報を取得します。
• get_assignment_action - アサインメントアクションの詳細とUIメタデータを取得します。
• get_next_assignment - ユーザーの次の作業アサインメントを取得します。
• jump_to_step - アサインメントフローの特定のステップに移動します。
• navigate_assignment_previous - アサインメントの前のステップに移動します。
• perform_assignment_action - アサインメントアクションを実行します。
• recalculate_assignment_fields - アサインメントフォームのフィールドを再計算します。
• refresh_assignment_action - アサインメントアクションフォームのデータを更新します。
• save_assignment_action - アサインメントフォームのデータを実行せずに保存します。

添付ファイルツール (7)

• add_case_attachments - ケースにファイル/URLを添付します。
• delete_attachment - ケースから添付ファイルを削除します。
• get_attachment - 添付ファイルの内容を取得します。
• get_attachment_categories - 利用可能な添付ファイルのカテゴリーをリストします。
• get_case_attachments - すべてのケース添付ファイルをリストします。
• update_attachment - 添付ファイルのメタデータを更新します。
• upload_attachment - 一時的な添付ファイルとしてファイルをアップロードします。

ケースツール (16)

• add_optional_process - ステージまたはケース全体のオプションプロセスを追加します。
• bulk_cases_patch - 複数のケースに対してアクションを実行します。
• change_to_next_stage - ケースを次のステージに移動します。
• change_to_stage - ケースを特定のステージに移動します。
• create_case - 内容を含む新しいケースを作成します。
• delete_case - 作成ステージのケースを削除します。
• get_case - 詳細なケース情報を取得します。
• get_case_action - ケースアクションの詳細とメタデータを取得します。
• get_case_ancestors - ケースの祖先階層を取得します。
• get_case_descendants - ケースの子孫階層を取得します。
• get_case_stages - ケースのステージとプロセスをリストします。
• get_case_view - 特定のケースビューの詳細を取得します。
• get_case_view_calculated_fields - ケースビューのフィールドを計算します。
• perform_bulk_action - バルクケース操作を実行します。
• perform_case_action - ケース全体のアクションを実行します。
• recalculate_case_action_fields - ケースアクションのフィールドを再計算します。
• refresh_case_action - ケースアクションフォームのデータを更新します。
• release_case_lock - 悲観的なケースロックを解除します。

ケースタイプツール (3)

• get_case_type_action - ケースタイプアクションのメタデータを取得します。
• get_case_type_bulk_action - ケースタイプのバルクアクションのメタデータを取得します。
• get_case_types - 利用可能なケースタイプをリストします。

データビューツール (7)

• delete_data_record - 保存可能なデータページからデータレコードを削除します。
• get_data_objects - 利用可能なデータオブジェクトをリストします。
• get_data_view_count - データビューの結果数を取得します。
• get_data_view_metadata - データビューのメタデータとパラメーターを取得します。
• get_list_data_view - フィルタリングを使用してリストデータビューをクエリします。
• update_data_record_full - データレコードを完全に更新します。
• update_data_record_partial - データレコードを部分的に更新します。

ドキュメントツール (2)

• get_document - ドキュメントの内容をBase64形式で取得します。
• remove_case_document - ケースにリンクされたドキュメントを削除します。

フォロワーツール (3)

• add_case_followers - ケースのフォロワーとしてユーザーを追加します。
• delete_case_follower - ケースのフォロワーを削除します。
• get_case_followers - ケースのフォロワーをリストします。

参加者ツール (7)

• create_case_participant - ケースに参加者を追加します。
• delete_participant - ケースの参加者を削除します。
• get_case_participants - すべてのケース参加者をリストします。
• get_participant - 特定の参加者の詳細を取得します。
• get_participant_role_details - 参加者のロール情報を取得します。
• get_participant_roles - 利用可能な参加者のロールをリストします。
• update_participant - 参加者の情報を更新します。

関連ケースツール (3)

• delete_related_case - ケースの関係を削除します。
• get_related_cases - 関連するケースをリストします。
• relate_cases - ケースの関係を作成します。

サービスツール (1)

• ping_pega_service - Pega InfinityへのOAuth2接続をテストします。

タグツール (3)

• add_case_tags - ケースにタグを追加します。
• delete_case_tag - 特定のケースタグを削除します。
• get_case_tags - ケースのタグをリストします。

💻 使用例

⚠️ 重要な注意 以下の例は、想定される機能と計画されたユーザー体験を示しています。これらのシナリオは、このGenAIイノベーションプロジェクトの実験的な目標を表しており、現在の実装状況を反映していない場合があります。

ケースの作成

ユーザー: "ポリシー番号 #12345の新しい保険請求を作成してください"
AI: 新しい保険請求ケースを作成します。これはどのような種類の請求ですか？
ユーザー: "自動車事故請求"
AI: ✅ 自動車事故請求ケース INS-CLAIM-789を作成しました。
    ケースID: INS-CLAIM-789
    ポリシー: #12345
    ステータス: オープン
    次のステップ: 事故の詳細を提供する

アサインメントの管理

ユーザー: "私の次のアサインメントは何ですか？"
AI: 保留中のアサインメントが3件あります。
    1. 請求書類のレビュー (INS-CLAIM-789) - 今日期限
    2. 旅行申請の承認 (TRAVEL-456) - 明日期限
    3. 顧客へのコールバック (SERVICE-123) - 2時間以内に期限
ユーザー: "請求書類のレビューをやりましょう"
AI: ✅ INS-CLAIM-789の請求書類レビューを開きます。
    [関連するケースデータと必要なアクションが表示されます]

⚙️ 設定

環境変数

# Pega Infinity接続
PEGA_BASE_URL=https://your-pega-instance.com

# OAuth 2.1認証
PEGA_CLIENT_ID=your-oauth-client-id
PEGA_CLIENT_SECRET=your-oauth-client-secret

OAuthの設定

1. Pega InfinityインスタンスでOAuthクライアントを登録します。
2. APIアクセスのためにスコープを構成します。
3. 認証コードフローを使用する場合は、リダイレクトURIを設定します。
4. クライアントの資格情報で環境を更新します。

詳細な設定手順については、設定ガイドを参照してください。

🤝 貢献

このエキサイティングなGenAIイノベーション実験に参加しましょう！エンタープライズプラットフォームの自然言語インターフェースの未来を探索する実験的なプロジェクトとして、このイノベーションの旅を形作るためのコミュニティの参加を歓迎します。

貢献の方法

• 🔬 実験のフィードバック - プロトタイプのテストから得た経験と洞察を共有してください。
• 💡 イノベーションのアイデア - 創造的な提案でGenAIイノベーションのロードマップに貢献してください。
• 🐛 問題の報告 - この実験的なプロジェクトの課題を特定するのを手伝ってください。
• 🔧 コードの貢献 - コードベースと概念実証機能に貢献してください。
• 📖 ドキュメント - 学習内容と実験結果のドキュメント化を手伝ってください。
• 🧪 テストと検証 - 新しい実験的な機能のテストに参加してください。

開発環境のセットアップ

# リポジトリをフォークしてクローンする
git clone https://github.com/your-username/pega-dx-mcp.git
cd pega-dx-mcp

# 依存関係をインストールする
npm install

# 機能ブランチを作成する
git checkout -b feature/your-feature-name

# 変更を加えてテストする
npm test

# プルリクエストを送信する

ガイドライン

• 行動規範に従ってください。
• テストが通過することを確認し、機能に対して新しいテストを追加してください。
• APIの変更に対してドキュメントを更新してください。
• 従来のコミットメッセージを使用してください。

📄 ライセンス

このプロジェクトは、Apache License, Version 2.0の下でライセンスされています。詳細については、LICENSEを参照してください。