RapidID MCP Server は、Model Context Protocol (MCP) をサポートする AI アプリケーション（Claude Desktop など）が RapidID の ID 管理システムと連携できるようにします。ユーザーの検索、エンタイトルメントの管理、グループの照会、監査ログの確認、Connect アクションセットの操作を行うためのツールを提供します。
はじめに
Claude Extensions を使用する場合
- お使いの OS 用の mcpb パッケージをダウンロードします
- Claude Desktop を開き、Settings ➡️ Extensions ➡️ Advanced Settings ➡️ Install Extension に移動します
- 手順 1 の mcpb パッケージを選択します
- Hostname と Username/Password、または Service Identity を入力します
バイナリを使用する場合
リリースからお使いの OS 用のバイナリをダウンロードし、Usage with Model Context Protocol の手順に従います。
Model Context Protocol での使用
RapidID のユーザー名とパスワードを使用して、MCP をサポートするアプリとこのサーバーを統合するには：
{
"mcpServers": {
"mcp-rapidid": {
"command": "<path to downloaded binary>",
"env": {
"RI_USER": "kclarkson",
"RI_PASSWORD": "notarealpassword123",
"RI_HOST": "portal.us006-rapididentity.com"
}
}
}
}
RapidID のサービス ID を使用して、MCP をサポートするアプリとこのサーバーを統合するには次のようにします。Service Identity は Tenant Admin ロールを持っていても、すべての API エンドポイントにアクセスできるわけではない点に注意してください。
{
"mcpServers": {
"mcp-rapidid": {
"command": "<path to downloaded binary>",
"env": {
"RI_SERVICE_IDENTITY_SECRET_KEY": "1jdie203i4jjf9",
"RI_HOST": "portal.us006-rapididentity.com"
}
}
}
}
ツール
search-users: 認証済みユーザーが利用可能な委任に基づいて簡易検索を実行します。search-entitlements-for-user: 指定したユーザーの idautoID に基づいてエンタイトルメントを検索します。start-entitlement-request: idautoID と resourceId に基づき、特定のユーザーとエンタイトルメントに対するエンタイトルメント要求を開始します。get-my-delegations: 認証済みユーザーがアクセスできる委任を取得します。これは環境変数に含まれる認証情報に基づきます。get-user-info-in-delegation: RapidID の委任の高度な検索を実行します。search-groups: RapidID グループの簡易検索を実行します。get-group-members: 指定した RapidID グループのグループメンバーを取得します。get-user-activity-from-audit-log: 指定した期間における特定の RapidID ユーザーの監査ログアクティビティを返します。get-connect-projects: すべての RapidID Connect プロジェクトを返しますget-connect-actions: プロジェクト内、または全プロジェクトにわたる Connect アクションセットを返しますget-connect-action: ID で指定した単一の RapidID Connect アクションセットを返しますsave-connect-action: RapidID Connect アクションセットを保存（作成または更新）しますdelete-connect-action: ID で指定した RapidID Connect アクションセットを削除しますget-password-policies-for: 指定したユーザーのパスワードポリシーを取得しますset-password: 委任を通じて 1 人以上のユーザーの RapidID パスワードを設定しますrun-connect-action: RapidID Connect アクションセットを実行し、HTML ログを返しますget-connect-files: RapidID Connect files モジュール内のファイルとディレクトリのメタデータを返しますget-connect-file-content: RapidID Connect files モジュールからファイルのテキストコンテンツを返します
スキル
- RapidID Role Mining: 静的な RapidID グループの動的フィルターを特定するプロセスです。
- Connect Action Sets: RapidID Connect アクションセットの操作方法に関する知識です。
トラブルシューティング
- 認証に失敗した場合は、RI_HOST、RI_USER / RI_PASSWORD、または RI_SERVICE_IDENTITY_SECRET_KEY が正しく設定されていることを確認してください
search-usersまたはget-user-info-in-delegationを使用した際に予期しない空の配列[]を受け取った場合、多くの場合はサービス ID を使用していることが原因であり、ユーザー名とパスワードに切り替えることで問題が解決します。- サービス ID は Tenant Administrator ロールを持っていてもすべてのエンドポイントにアクセスできず、通常は空の配列
[]や空のオブジェクト{}などの空の応答として現れます get-user-info-in-delegationはページネーションをサポートしていないため、ツール応答のサイズエラーが発生することがあります。回避策として、search-groupsとget-group-membersツールを組み合わせ、ユーザーを複数のツール呼び出しに分割する方法があります。get-group-membersツールはページネーションをサポートしています。save-connect-actionsツールを使用して保存エラーが発生した場合、多くの場合はバージョン番号をインクリメントしていないことが原因です。get-connect-actionを使ってアクションセットの最新バージョンを先に取得し、バージョン番号を適切にインクリメントしてくださいget-user-info-in-delegationは生の LDAP フィルターを入力として受け取ります。結果が返されない場合は、LDAP フィルターの形式が不正であることが原因の可能性があります。
ヘルプの入手
https://github.com/Jamf-Concepts/mcp-rapidid/issues で issue を作成してください
