ツールおよび機能リファレンス
OpenLM MCP レポートサーバーは、12 カテゴリーに分類された 58 のツールを公開しています。各ツールは、OpenLM テナントデータベースに対する特定の GraphQL クエリにマッピングされます。AI アシスタントは、自然言語のプロンプトに基づいて、これらのツールを自動的に呼び出します。
ツールを名前で呼び出す必要はありません。必要な内容を平易な言葉で説明すれば、AI クライアントが適切なツールを選択します。このリファレンスは、利用可能なデータを理解し、各カテゴリーのプロンプト例を確認するのに役立ちます。
リファレンスの読み方
各ツールのエントリには、以下の情報が含まれます。
- Name: MCP プロトコルで使用される、マシン可読なツール識別子。
- Description: ツールが実行する内容と、返されるデータ。
- Annotation: ツールが
read_only(データ変更のない安全なツール) か、destructive(サーバーの状態を変更するツール) か。 - Example prompt: このツールをトリガーする自然言語のクエリ例。
共通のツールパターン
ほとんどのカテゴリーは、一貫した 5 つのツールパターンに従っています。このパターンを理解することで、任意のデータカテゴリーに対してどのような質問ができるかを把握できます。
| パターン | 機能 |
|---|---|
| List / Fetch | ページネーションとフィルタリングに対応したレコードを取得します。データの閲覧や特定のフィルターの適用に使用します。 |
| By ID | 一意の識別子で単一のレコードを取得します。特定の項目の詳細を知りたい場合に使用します。 |
| Summary | 高レベルの合計、平均、ユニーク数を返します。概要や KPI に使用します。 |
| Aggregates | 列 (機能、ユーザー、ホストなど) でデータをグループ化し、グループごとのカウントを返します。比較に使用します。 |
| Group summary | サマリー指標をグループごとに分解します。部門別またはチーム別の分析に使用します。 |
アカウントおよびセッション管理 (3 ツール)
ID とセッションコンテキストを確認するためのツールです。これらは読み取り専用で、通常はセッション開始時に AI クライアントによって自動的に呼び出されます。
| ツール名 | 説明 | 注釈 |
|---|---|---|
get_openlm_identity | 現在の MCP セッションで認証されたユーザー ID (テナントとアカウントの詳細を含む) を返します。 | read_only |
残りのセッション管理ツールは、内部プロトコルのハンドシェイクを処理するもので、ユーザープロンプトから直接呼び出されることはありません。
プロンプト例
- 「誰としてログインしていますか？」
プロンプト例
- 「現在のキャッシュ統計を表示して。」
- 「サーバーのキャッシュをクリアして、最新のデータを取得して。」
ライセンス使用状況 (5 ツール)
コアとなるレポートツールです。ページネーション、フィルタリング、集計、グループレベルの内訳に対応し、組織全体のライセンス消費データをクエリできます。
| ツール名 | 説明 | 注釈 |
|---|---|---|
license_usage | ライセンス使用状況レコードを取得します。ページネーション、および日付範囲、ユーザー、ホスト、機能、ベンダーによるフィルタリングに対応しています。 | read_only |
license_usage_by_id | 一意の ID で特定のライセンス使用状況レコードを取得します。 | read_only |
license_usage_summary | 合計使用回数、平均、ユニークユーザー数、ホスト数、機能数などの高レベルな合計を返します。 | read_only |
license_usage_aggregates | 指定された列 (機能、ユーザー、ホストなど) で使用状況データをグループ化し、集計されたカウントとメトリクスを返します。 | read_only |
license_usage_group_summary | 使用回数と平均を含む、グループごとのライセンス使用状況の内訳を提供します。 | read_only |
プロンプト例
- 「過去 30 日間のすべてのライセンス使用状況を表示して。」
- 「使用状況レコード ID 12345 の詳細を見せて。」
- 「今四半期のライセンス使用状況のサマリーを作成して。」
- 「機能名別に集計したライセンス使用状況を表示して。」
- 「部門別にライセンス使用状況を分解して。」
ライセンス割り当て (5 ツール)
ライセンス割り当てと割り当て先データをクエリし、組織全体にライセンスがどのように分配されているかを把握します。
| ツール名 | 説明 | 注釈 |
|---|---|---|
license_allocations | ライセンス割り当てのトランザクションレコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
license_allocation_by_id | 一意の ID で特定の割り当てレコードを取得します。 | read_only |
license_allocation_summary | テナント全体のアクティブとインアクティブの割り当てのカウントとパーセンテージを返します。 | read_only |
license_allocation_aggregates | 指定された列で割り当てデータをグループ化し、集計されたカウントを返します。 | read_only |
license_allocation_group_summary | グループごとにアクティブ/インアクティブの割り当て内訳を提供します。 | read_only |
プロンプト例
- 「現在のすべてのライセンス割り当てを表示して。」
- 「割り当てレコード ID 5678 を見せて。」
- 「アクティブなライセンス割り当ての割合は？」
- 「ライセンスタイプ別に割り当てを集計して。」
- 「部門ごとの割り当てステータスを表示して。」
ライセンス調達 (5 ツール)
購入日、有効期限ステータス、更新タイムラインなど、ライセンス調達レコードを追跡します。
| ツール名 | 説明 | 注釈 |
|---|---|---|
license_procurements | ライセンス調達レコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
license_procurement_by_id | 一意の ID で特定の調達レコードを取得します。 | read_only |
license_procurement_summary | 調達ステータス (期限切れ、まもなく期限切れ、アクティブ) のライセンスをカウントとパーセンテージで返します。 | read_only |
license_procurement_aggregates | 指定された列で調達データをグループ化し、集計されたカウントを返します。 | read_only |
license_procurement_group_summary | グループごとに有効期限ステータス (期限切れ、まもなく期限切れ、アクティブ) の内訳を提供します。 | read_only |
プロンプト例
- 「すべてのライセンス調達レコードを表示して。」
- 「調達レコード ID 9012 を見せて。」
- 「今後 90 日以内に期限切れになるライセンスはいくつありますか？」
- 「ベンダー別に調達データを集計して。」
- 「どの部門のライセンスがまもなく期限切れになるかを表示して。」
ライセンスサーバーステータス (5 ツール)
ライセンスサーバーのヘルスとステータスを監視します。
| ツール名 | 説明 | 注釈 |
|---|---|---|
license_server_status | ライセンスサーバーのステータスレコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
license_server_status_by_id | 一意の ID で特定のサーバーステータスレコードを取得します。 | read_only |
license_server_status_summary | 合計サーバー数、ユニークホスト数、ステータスの分布のサマリーを返します。 | read_only |
license_server_status_aggregates | 指定された列でサーバーステータスデータをグループ化し、集計されたカウントを返します。 | read_only |
license_server_status_group_summary | グループごとのサーバーステータスの内訳を提供します。 | read_only |
プロンプト例
- 「すべてのライセンスサーバーのステータスを表示して。」
- 「サーバー ID 3456 のステータスは？」
- 「すべてのライセンスサーバーのヘルスのサマリーを作成して。」
- 「ホスト別にサーバーステータスを集計して。」
- 「データセンターごとにグループ化したサーバーステータスを表示して。」
同時使用量 (5 ツール)
ピーク同時セッション、最小/最大値、使用率など、ライセンスの同時使用パターンを分析します。
| ツール名 | 説明 | 注釈 |
|---|---|---|
license_concurrent_measures | 同時使用量の測定レコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
license_concurrent_measure_by_id | 一意の ID で特定の同時使用量レコードを取得します。 | read_only |
concurrent_measure_summary | 最大同時使用数、最小同時使用数、使用率の平均を含むサマリー統計を返します。 | read_only |
license_concurrent_measure_aggregates | 指定された列で同時使用量データをグループ化し、集計された指標を返します。 | read_only |
concurrent_measure_group_summary | グループごとの同時使用量メトリクスの内訳を提供します。 | read_only |
プロンプト例
- 「先週の同時ライセンス使用量を表示して。」
- 「同時使用量レコード ID 7890 を見せて。」
- 「今月のピーク同時使用量の平均は？」
- 「機能別に同時使用量を集計して。」
- 「製品別に同時使用量を分解して。」
拒否 (5 ツール)
ユーザーがライセンスをチェックアウトできない場合のライセンス拒否イベントを追跡・分析します。
| ツール名 | 説明 | 注釈 |
|---|---|---|
denials | ライセンス拒否レコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
denial_by_id | トランザクション ID で特定の拒否レコードを取得します。 | read_only |
denial_summary | 合計拒否回数と、影響を受けたユーザー、ホスト、機能、ベンダーのユニーク数を返します。 | read_only |
denial_aggregates | 指定された列で拒否データをグループ化し、集計されたカウントを返します。 | read_only |
denial_group_summary | グループごとの拒否回数の内訳を提供します。 | read_only |
プロンプト例
- 「先月のすべてのライセンス拒否を表示して。」
- 「拒否トランザクション ID 4567 を見せて。」
- 「今四半期のライセンス拒否はいくつありましたか？」
- 「最もライセンス拒否が多い機能は？」
- 「部門別に拒否件数を表示して。」
未使用ライセンス (5 ツール)
割り当てられているものの使用されていないライセンスを特定します。これらのツールは、ライセンスの最適化とコスト削減に不可欠です。
| ツール名 | 説明 | 注釈 |
|---|---|---|
not_used_licenses | 割り当て済みだが使用されていないライセンスのレコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
not_used_license_by_id | 一意の ID で特定の未使用ライセンスレコードを取得します。 | read_only |
not_used_license_summary | 未使用ライセンスの合計、ユニークエンティティ数、平均を返します。 | read_only |
not_used_license_aggregates | 指定された列で未使用ライセンスデータをグループ化し、集計されたカウントを返します。 | read_only |
not_used_license_group_summary | グループごとの未使用ライセンス数の内訳を提供します。 | read_only |
プロンプト例
- 「使用されていないライセンスは？」
- 「未使用ライセンスレコード ID 2345 を見せて。」
- 「すべての未使用ライセンスのサマリーを作成して。」
- 「ベンダー別に未使用ライセンスを集計して。」
- 「最も未使用ライセンスが多い部門は？」
プロセス (5 ツール)
プロセスレベルのデータをクエリし、どのアプリケーションとセッションがライセンスを消費しているかを確認します。
| ツール名 | 説明 | 注釈 |
|---|---|---|
processes | ライセンスを消費するアプリケーションを示すプロセスレコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
process_by_id | トランザクション ID で特定のプロセスレコードを取得します。 | read_only |
process_summary | セッション数、ユニークエンティティ数、平均時間を返します。 | read_only |
process_aggregates | 指定された列でプロセスデータをグループ化し、集計されたカウントを返します。 | read_only |
process_group_summary | グループごとのプロセスアクティビティの内訳を提供します。 | read_only |
プロンプト例
- 「すべてのアクティブなライセンスプロセスを表示して。」
- 「プロセストランザクション ID 6789 を見せて。」
- 「ライセンスプロセスアクティビティのサマリーを作成して。」
- 「アプリケーション名別にプロセスデータを集計して。」
- 「チーム別にプロセスアクティビティを表示して。」
タッチポイント詳細 (4 ツール)
ライセンスインフラストラクチャ全体でタッチポイントイベントを追跡します。
| ツール名 | 説明 | 注釈 |
|---|---|---|
touchpoint_details | タッチポイント詳細レコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
touchpoint_detail_by_row_number | 行番号で特定のタッチポイントレコードを取得します。 | read_only |
touchpoint_summary | 合計イベント数とユニークエンティティ数を返します。 | read_only |
touchpoint_group_summary | グループごとのタッチポイントイベントの内訳を提供します。 | read_only |
プロンプト例
- 「先週のすべてのタッチポイントイベントを表示して。」
- 「タッチポイントレコード番号 123 を見せて。」
- 「今月何件のタッチポイントイベントがありましたか？」
- 「グループ別にタッチポイントイベントを分解して。」
ドングル監視 (4 ツール)
ドングルベースのライセンス適用に備えて、ハードウェアドングルのステータス、接続性、使用状況を監視します。
| ツール名 | 説明 | 注釈 |
|---|---|---|
dongle_monitoring | ドングル監視レコードを取得します。ページネーションとフィルタリングに対応しています。 | read_only |
dongle_monitoring_by_row_number | 行番号で特定のドングル監視レコードを取得します。 | read_only |
dongle_monitoring_summary | 合計カウント、ユニークデバイス数、接続統計を返します。 | read_only |
dongle_monitoring_aggregates | 指定された列でドングル監視データをグループ化し、集計されたカウントを返します。 | read_only |
プロンプト例
- 「監視対象のすべてのドングルのステータスを表示して。」
- 「ドングルレコード番号 456 を見せて。」
- 「ドングルのヘルスと接続性のサマリーを作成して。」
- 「接続ステータス別にドングルデータを集計して。」
効果的なプロンプトのヒント
- 期間を具体的に指定してください。 関連性の高い結果を得るため、日付範囲、月、四半期を含めます。
- 製品名や機能名を具体的に指定してください。 機能レベルのデータをクエリするときは、ソフトウェア製品、ライセンス、機能の名前を記載します。
- フォローアップの質問をしてください。 サマリーから広範に始め、そこから詳細に掘り下げていきます。
- 特定の出力形式をリクエストしてください。 視覚的な出力が欲しい場合は、テーブル、グラフ、ダッシュボードを指定します。
- カテゴリーを組み合わせてください。 「部門別にライセンス使用量と拒否率を比較して」のように、複数のツールカテゴリーにまたがる質問も可能です。
- キャッシュを活用してください。 繰り返しのクエリでは、結果がキャッシュされています。既知の更新後に最新データが必要な場合は、まずキャッシュをクリアするよう AI に依頼してください。
警告
ビジネス上の意思決定を行う前に、特にライセンス最適化の推奨事項については、OpenLM Platform の BI レポートとダッシュボードで AI が生成したインサイトを検証してください。AI モデルのデータ解釈には最大 3% の誤差が含まれる可能性があります。