Pega DX MCP

Pega DX MCP Server

Pega Infinity™ アプリケーションとの対話を可能にします

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

🧪 実験的プロジェクト

Pega DX MCP Server は、Model Context Protocol と Pega Infinity™ の機能の融合を探る実験的なプロジェクトです。これは Pegasystems の公式製品ではなく、一般提供もされていません。すべてのコマンド、パラメーター、その他の機能は、予告の有無を問わず、いつでも変更または廃止される可能性があります。本番環境の機能にこの MCP サーバーを使用しないでください。この実験では、Pega Infinity™ とのやり取りに自然言語インターフェースを活用する可能性を示しています。GenAI を活用したビジネスオートメーションの未来を形作るため、皆さまからのフィードバックや貢献をお待ちしています。

🌟 主な機能

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

🚀 クイックスタート

前提条件

• Node.js (22+) と npm
• DX API が有効な Pega Infinity™ (23+) へのアクセス
• OAuth 2.1 クライアント認証情報

インストール

# Install from npm (recommended)
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：Claude Desktop のドキュメントを参照し、MCP Server の追加方法を確認してください
• Claude Code：Claude Code のドキュメントを参照し、MCP Servers の設定方法を確認してください
• Cline：Cline のドキュメントを参照し、Cline MCP 設定の編集方法を確認してください

TIP： MCP クライアントを再起動し、Pega DX MCP ツールが利用可能になっていることを確認してください。

🏗️ アーキテクチャ

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 Innovation プロジェクトの実験的な目標を表すものであり、現在の実装状況を反映しているとは限りません。

ケースの作成

User: "Create a new insurance claim for policy #12345"
AI: I'll create a new insurance claim case. What type of claim is this?
User: "Auto accident claim"
AI: ✅ Created auto accident claim case INS-CLAIM-789
    Case ID: INS-CLAIM-789
    Policy: #12345
    Status: Open
    Next step: Provide accident details

割り当ての管理

User: "What's my next assignment?"
AI: You have 3 pending assignments:
    1. Review claim documentation (INS-CLAIM-789) - Due today
    2. Approve travel request (TRAVEL-456) - Due tomorrow
    3. Customer callback (SERVICE-123) - Due in 2 hours
User: "Let me work on the claim review"
AI: ✅ Opening claim documentation review for INS-CLAIM-789
    [Displays relevant case data and required actions]

⚙️ 設定

環境変数

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

# OAuth 2.1 Authentication
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 Innovation の実験にぜひご参加ください！エンタープライズプラットフォーム向けの自然言語インターフェースの未来を探る実験的なプロジェクトとして、このイノベーションの歩みを形作るコミュニティの皆さまのご参加を歓迎します。

貢献方法

• 🔬 実験へのフィードバック - プロトタイプをテストした経験や知見を共有してください
• 💡 イノベーションのアイデア - 独創的な提案で GenAI Innovation のロードマップづくりにご協力ください
• 🐛 問題の報告 - この実験的なプロジェクトでの課題の特定にご協力ください
• 🔧 コードへの貢献 - コードベースや概念実証機能にご協力ください
• 📖 ドキュメント - 学びや実験の成果の記録にご協力ください
• 🧪 テストと検証 - 新しい実験的機能のテストにご参加ください

開発環境のセットアップ

# Fork and clone the repository
git clone https://github.com/your-username/pega-dx-mcp.git
cd pega-dx-mcp

# Install dependencies
npm install

# Create a feature branch
git checkout -b feature/your-feature-name

# Make changes and test
npm test

# Submit pull request

ガイドライン

• 行動規範に従ってください
• テストがすべて成功することを確認し、機能の新しいテストを追加してください
• API に変更を加えた場合は、ドキュメントを更新してください
• Conventional Commits のメッセージ形式を使用してください

📄 ライセンス

Apache License, Version 2.0 の下でライセンスされています。詳細はLICENSEをご覧ください。