ツールおよび機能リファレンス
OpenLM Platform のデータをクエリするには、必要な内容を平易な言葉で説明します。AI アシスタントは、自然言語のプロンプトから OpenLM MCP コネクターのツールを自動的に呼び出します。このリファレンスは、ツールとその操作を一覧にしたものです。
OpenLM MCP コネクターは、12 のデータカテゴリーにわたる 19 のツールを公開しています。各データカテゴリーは 1 つのツールで、operation パラメーターを受け取ります。各操作は、OpenLM データベースに対する特定の GraphQL クエリにマッピングされます。AI アシスタントは、自然言語のプロンプトに基づいて、これらのツールを自動的に呼び出します。
ツールを名前で呼び出したり、操作を自分で設定したりする必要はありません。AI クライアントが、プロンプトから適切なツールと操作を選択します。
リファレンスの読み方
各カテゴリーのエントリには、以下の情報が含まれます。
- ツール: MCP プロトコルで使用される、マシン可読なツール識別子。
- 操作: ツールが
operationパラメーターを通じてサポートするアクション。 - 安全性:
read_onlyツールは、レポートデータを変更しません。destructiveツールは、サーバーまたはセッションの状態を変更します。これらのラベルは動作を表します。 - プロンプト例: このツールをトリガーする自然言語のクエリ例。
操作モデル
各データカテゴリーのツールは、同じ操作セットをサポートしています。これらの操作から、任意のカテゴリーに対してどのような質問ができるかを把握できます。
| 操作 | 機能 |
|---|---|
list | ページネーションとフィルタリングに対応したレコードを取得します。データの閲覧や特定のフィルターの適用に使用します。 |
by_id | 一意の識別子で単一のレコードを取得します。特定の項目の詳細を知りたい場合に使用します。 |
summary | 高レベルの合計、平均、ユニーク数を返します。概要や KPI に使用します。 |
aggregates | 列（機能、ユーザー、ホストなど）でデータをグループ化し、グループごとのメトリクスを返します。比較に使用します。 |
group_summary | サマリー指標をグループごとに分解します。部門別またはチーム別の分析に使用します。 |
overview | サマリーとグループごとの内訳を、1 回のリクエストでまとめて返します。ダッシュボードに使用します。 |
aggregates 操作は、カテゴリーと集計するフィールドに応じて、COUNT、SUM、AVG、MIN、MAX、COUNT_DISTINCT をサポートします。
アカウントおよびセッション管理
ID とセッションコンテキストを確認するためのツールです。AI クライアントは、セッション開始時にこれらを自動的に呼び出します。
ツール名、説明、安全性ラベルを次の表に示します。
| ツール名 | 説明 | 安全性 |
|---|---|---|
get_openlm_identity | 現在の MCP セッションで認証されたユーザー ID（テナントとアカウントの詳細を含む）を返します。 | read_only |
link_openlm_account | セッションの OpenLM Identity サインインを開始します。 | read_only |
unlink_openlm_account | 現在の OpenLM Identity セッションからサインアウトします。 | destructive |
次のプロンプトでこれらのツールを使用します。
- 「誰としてサインインしていますか？」
- 「OpenLM の ID を表示して。」
- 「OpenLM Identity からサインアウトして。」
キャッシュ管理
ツール名、説明、安全性ラベルを次の表に示します。
| ツール名 | 説明 | 安全性 |
|---|---|---|
cache_stats | サイズ、最大サイズ、TTL を含む、現在のキャッシュ統計を返します。 | read_only |
clear_cache | サーバー側のキャッシュをクリアし、次のクエリで最新のデータを取得します。 | destructive |
次のプロンプトでこれらのツールを使用します。
- 「現在のキャッシュ統計を表示して。」
- 「キャッシュをクリアして、最新のデータを取得して。」
ライセンス使用状況
コアとなるレポートツールです。ページネーション、フィルタリング、集計、グループレベルの内訳に対応し、組織全体のライセンス消費データをクエリできます。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
license_usage | list、by_id（使用状況 ID 別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「過去 30 日間のすべてのライセンス使用状況を表示して。」
- 「今四半期のライセンス使用状況のサマリーを作成して。」
- 「部門別にライセンス使用状況を分解して。」
ライセンス割り当て
ライセンス割り当てと割り当て先データをクエリし、組織全体にライセンスがどのように分配されているかを把握します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
license_allocation | list、by_id（割り当て ID 別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「現在のすべてのライセンス割り当てを表示して。」
- 「アクティブなライセンス割り当ての割合は？」
- 「部門ごとの割り当てステータスを表示して。」
ライセンス調達
購入日、有効期限ステータス、更新タイムラインなど、ライセンス調達レコードを追跡します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
license_procurement | list、by_id（機能、ベンダー、サーバー別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「すべてのライセンス調達レコードを表示して。」
- 「今後 90 日以内に期限切れになるライセンスはいくつありますか？」
- 「どの部門のライセンスがまもなく期限切れになるかを表示して。」
ライセンスサーバーステータス
ライセンスサーバーのヘルスとステータスを監視します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
server_status | list、by_id（トランザクション ID 別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「すべてのライセンスサーバーのステータスを表示して。」
- 「すべてのライセンスサーバーのヘルスのサマリーを作成して。」
- 「ホスト別にサーバーステータスを集計して。」
同時使用量
ピーク同時セッション、最小値と最大値、使用率など、ライセンスの同時使用パターンを分析します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
license_concurrent_measure | list、by_id（ライセンス ID 別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「先週の同時ライセンス使用量を表示して。」
- 「今月のピーク同時使用量の平均は？」
- 「製品別に同時使用量を分解して。」
拒否
ユーザーがライセンスをチェックアウトできない場合のライセンス拒否イベントを追跡・分析します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
denial | list、by_id（トランザクション ID 別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「先月のすべてのライセンス拒否を表示して。」
- 「今四半期のライセンス拒否はいくつありましたか？」
- 「最もライセンス拒否が多い機能は？」
未使用ライセンス
割り当てられているものの使用されていないライセンスを特定します。このツールは、ライセンスの最適化とコスト削減に使用します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
not_used_license | list、by_id（ライセンス ID 別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「使用されていないライセンスは？」
- 「すべての未使用ライセンスのサマリーを作成して。」
- 「最も未使用ライセンスが多い部門は？」
プロセス
プロセスレベルのデータをクエリし、どのアプリケーションとセッションがライセンスを消費しているかを確認します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
process | list、by_id（トランザクション ID 別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「すべてのアクティブなライセンスプロセスを表示して。」
- 「ライセンスプロセスアクティビティのサマリーを作成して。」
- 「アプリケーション名別にプロセスデータを集計して。」
タッチポイント詳細
ライセンスインフラストラクチャ全体でタッチポイントイベントを追跡します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
touchpoint | list、by_id（行番号別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「先週のすべてのタッチポイントイベントを表示して。」
- 「今月何件のタッチポイントイベントがありましたか？」
- 「グループ別にタッチポイントイベントを分解して。」
ドングル監視
ドングルベースのライセンス適用に備えて、ハードウェアドングルのステータス、接続性、使用状況を監視します。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
dongle | list、by_id（行番号別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「監視対象のすべてのドングルのステータスを表示して。」
- 「ドングルのヘルスと接続性のサマリーを作成して。」
- 「接続ステータス別にドングルデータを集計して。」
ユーザー詳細
部門、オフィス、国、グループなど、ユーザーディレクトリをクエリします。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
user_detail | list、by_id（ユーザー名別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「すべてのユーザーを一覧表示して。」
- 「各部門のユーザー数は？」
- 「国別にユーザーを分解して。」
ライセンス詳細
機能、ベンダー、製品、数量など、ライセンスインベントリをクエリします。
ツール名、操作、安全性ラベルを次の表に示します。
| ツール名 | 操作 | 安全性 |
|---|---|---|
license_detail | list、by_id（ライセンス ID 別）、summary、aggregates、group_summary、overview | read_only |
次のプロンプトでこのツールを使用します。
- 「ライセンスインベントリを表示して。」
- 「ベンダー別のライセンスのサマリーを作成して。」
- 「ライセンスタイプ別にライセンスを分解して。」
シート空き状況
これらのツールは、シートの空き状況に関する質問に直接答えます。
ツール名、説明、安全性ラベルを次の表に示します。
| ツール名 | 説明 | 安全性 |
|---|---|---|
license_seat_availability | ある日付における機能または製品のフローティングライセンスのシート空き状況（総シート数、使用中、空き、使用率）、または日付範囲にわたる同時使用量の推移。 | read_only |
named_user_seat_availability | 機能のシートを誰が保持していて、使用しているかどうかを示す、指名ユーザー（シートごと）の割り当ての検索。 | read_only |
次のプロンプトでこれらのツールを使用します。
- 「Revit のシートは今日いくつ空いていますか？」
- 「過去 30 日間の AutoCAD の同時使用量の推移を表示して。」
- 「MATLAB の指名ユーザーシートを現在保持しているのは誰ですか？」
効果的なプロンプトの書き方
より関連性の高い結果を得るには、次のヒントを参考にします。
- 期間を具体的に指定する: 関連性の高い結果を得るため、日付範囲、月、四半期を含めます。
- 製品名や機能名を具体的に指定する: 機能レベルのデータをクエリするときは、ソフトウェア製品、ライセンス、機能の名前を記載します。
- 概要を依頼する: ダッシュボード形式の回答が必要な場合は、「X の Y 別の概要」を依頼します。合計とグループごとの内訳が 1 回で返されます。
- フォローアップの質問をする: サマリーから広範に始め、そこから詳細に掘り下げていきます。
- 特定の出力形式をリクエストする: 視覚的な出力が欲しい場合は、テーブル、グラフ、ダッシュボードを指定します。
- カテゴリーを組み合わせる: 「部門別にライセンス使用量と拒否率を比較して」のように、複数のツールカテゴリーにまたがる質問も可能です。
- 最新データのためにキャッシュをクリアする: 繰り返しのクエリでは、結果がキャッシュされています。既知の更新後に最新データが必要な場合は、まずキャッシュをクリアするよう AI に依頼してください。
ビジネス上の意思決定を行う前に、特にライセンス最適化の推奨事項については、OpenLM Platform の BI レポートとダッシュボードで AI が生成したインサイトを検証してください。AI モデルのデータ解釈には最大 3% の誤差が含まれる可能性があります。
ドキュメントチームは、大規模言語モデルを使ってこのページを下書きすることがあります。公開前に、テクニカルライターがすべてのページをレビューし、製品と照らし合わせて検証します。最終的な判断は人間が行います。