MCP ツール一覧¶

本ドキュメントでは、OWL MCP Server が現在 MCP 経由で呼び出せるビジネスツールの機能について、ツール分類、権限タイプ、使用上の注意、ツール概要、および代表的な MCP 使用手順を説明します。

ツールの可視範囲と呼び出し結果は、使用する API Key の権限に依存します。API Key に対象リソースや操作の権限がない場合、該当ツールの呼び出しは失敗するか、空の結果を返します。

ツール範囲¶

OWL MCP Server で実行可能なビジネスツールは、プラットフォームの機能拡張に伴い随時更新されます。実際に実行可能なツールは、list_catalogs および list_tools が返すツールカタログを基準とします。

本ドキュメントでは、現在以下のビジネスカテゴリをカバーしています。

権限タイプ¶

使用上の注意¶

facade モードでは、MCP クライアントは以下の順序で呼び出しを行う必要があります。

1. list_catalogs を呼び出し、利用可能なカテゴリを確認します。
2. list_tools を呼び出し、catalog_id を指定して、該当カテゴリのビジネスツールとパラメータを確認します。
3. exec_tool を呼び出し、tool_name と parameters を指定してビジネスツールを実行します。

static モードでは、クライアントは tools/list が返すビジネスツールを直接呼び出すことができ、3 つのラッパーツールを経由する必要はありません。どちらのモードを使用する場合でも、ツールのパラメータと権限要件は同じです。

ツール概要¶

Account¶

現在の API Key のワークスペースと同じ組織内の他のワークスペースを検出するために使用します。取得した workspace_uuid は、owl.data.same_org.trace.query の workspace_uuids 入力パラメータとして使用し、クロスワークスペース Trace クエリに利用できます。

注意：返却結果の workspace_uuid が後続の workspace_uuids 入力パラメータです。workspace_id はリストのページネーション専用であり、Trace クエリツールに渡さないでください。

Catalog¶

統合リソースカタログのエンティティタイプ検出、エンティティクエリ、エンティティ詳細取得、トポロジー関係クエリに使用します。

注意：ダッシュボードツール（owl.dashboard.create / owl.dashboard.replace / owl.dashboard.get）は OWL CLI でのみ提供され、MCP ツール一覧には表示されません。関連する使用方法については、OWL CLI のドキュメントを参照してください。

Data¶

認可されたクロスワークスペース DQL クエリでは、必要に応じて owl.workspace.data_authorized.list で対象を検出し、workspace_uuids と target_region を渡します。1 回のクエリは 1 サイトに限定し、範囲パラメータを省略すると現在のワークスペースをクエリします。CLI/MCP の例とページネーションはクロスワークスペースクエリを参照してください。

DQL namespace の探索、データソースとフィールドの検出、ログインデックスの検出、SLO クエリ、ログパターン分析、同一組織内クロスワークスペース Trace クエリ、および MCP クライアント向けの簡易データクエリに使用します。現在、MCP 側では簡易クエリとクエリ補助ツールのみを提供しており、完全な DQL や PromQL のカスタム実行ツールは含まれません。

owl.data.same_org.trace.query の workspace_uuids を省略するか空の配列を渡した場合、現在のワークスペースのみをクエリします。同一組織内クロスワークスペースクエリ機能が無効の場合、現在のワークスペースのみのクエリが許可されます。他のワークスペースの UUID を渡すとパラメータエラーが返ります。

Errors¶

エラーセンターの問題一覧クエリ、およびコメントの追加、クエリ、更新に使用します。

Event¶

イベントセンターの一覧クエリとイベント詳細取得に使用します。

• owl.event.list は start_time と end_time を必須とします。status の指定可能な値は fatal、critical、error、warning、nodata です。limit のデフォルト値は 20、最大値は 100 です。返却項目にはイベントディメンションタグフィールド df_dimension_tags が含まれる場合があります。
• owl.event.get の timeRange はオプションの 2 要素配列 [start, end] で、各要素は 13 桁のミリ秒タイムスタンプであり、end は start より大きい必要があります。パラメータ名は timeRange であり、time_range に書き換えないでください。

Incident¶

owl.incident.get はインシデント UUID（incident_*）を受け取り、詳細と related_event_refs を返します。参照は 1 ページあたりデフォルトおよび最大 100 件です。page_info.has_more と next_page_index に従って取得し、インシデント UUID ではなくイベント参照を使って owl.event.get を呼び出します。取得可能な参照数と報告されたイベント数は異なる場合があり、不足する証拠を明記してください。

Infrastructure¶

インフラストラクチャオブジェクトの一覧と詳細クエリに使用します。ホスト、コンテナ、プロセスなどのリソースオブジェクトをカバーします。

LLM¶

LLM 可観測アプリケーションの一覧クエリに使用します。

Workspace¶

クロスワークスペースのデータクエリ認可の検出と現在のワークスペースメンバー.

新しい workspace カテゴリには owl.workspace.data_authorized.list と owl.workspace.member.list が含まれます。旧 member カテゴリは削除されます。owl.member.list は同じパラメータと権限検証を使用する呼び出しエイリアスとして残りますが、独立したツールとしては一覧に表示されません。

Monitor¶

モニターの一覧クエリ、詳細取得、作成または更新、および外部イベント受信に使用します。

ノート¶

現在の API Key アカウントで表示可能なノートの管理に使用します。

• owl.nbook_note.list の page_index のデフォルト値は 1、page_size のデフォルト値は 20、最大値は 100 です。
• owl.nbook_note.get は Markdown 本文 content を返す唯一のノートツールですが、path、etag、version は返しません。list、add、modify はサマリーのみを返し、content、path、ETag、バージョン情報は返しません。delete の応答は、バックエンドの元の簡潔な構造を維持します。
• type は normal と runbook をサポートします。owl.nbook_note.list では type でフィルタリング可能で、省略時はタイプでフィルタリングしません。owl.nbook_note.add では type を設定可能で、省略時はバックエンドが normal ノートを作成します。get と modify の応答には type が含まれますが、get、modify、delete は type 入力パラメータを受け付けず、既存のノートタイプは変更できません。
• owl.nbook_note.add は title と content を必須とし、path は受け付けません。created_source はサーバー側で ai に固定設定され、作成アカウントは現在の API Key から取得されます。
• owl.nbook_note.modify は note_uuid に加えて、title、content、tags、tag_kv のうち少なくとも 1 つを指定する必要があります。content を省略した場合、元の本文は保持されます。
• 取得、変更、削除には、一覧で返される note_uuid を使用します。path、etag、if_match、version、creator、created_source など、バックエンドで管理されるフィールドは渡さないでください。
• tagkv_query は一覧ツールで使用する TagKV 式の文字列です。tag_kv は作成および変更ツールで使用するキーと値のオブジェクトです。両者を混同しないでください。

Pipeline¶

Pipeline 一覧のクエリとサンプル検証に使用します。

mdsearch¶

統合ドキュメントコーパスの検索、id または path による完全なドキュメントの読み取り、コーパスディレクトリ構造の閲覧に使用します。中国語、英語、および混在クエリをサポートします。

MCP 使用手順¶

以下の手順は、デフォルトの facade モードを例としています。サーバー側で static モードが有効になっている場合は、同名のビジネスツールを直接呼び出すことができ、exec_tool を経由する必要はありません。

データクエリ関連の問題¶

「メトリクス、ログ、RUM、APM、Network、Profile データをクエリする」などの問題に適しています。

1. exec_tool 経由で owl.data.show_dql_namespace を呼び出し、データ namespace を確認します。
2. データドメインに応じて、exec_tool 経由で検出系ツールを呼び出します。
3. メトリクス：owl.metric.list
4. RUM：owl.rum.list
5. APM：owl.apm.list
6. Network：owl.network.list
7. Profile：owl.profile.list
8. ログ：owl.logging.list
9. クラウド請求：owl.billing.list
10. ログインデックス：owl.log_index.list
11. フィールドカタログ：owl.field_schema.get
12. 必要な source、field、index を取得した後、exec_tool 経由で owl.data.simple_query を呼び出してクエリを実行します。

インシデント対応関連の問題¶

「インシデントをクエリする、インシデント処理の経過を追跡する、インシデントにコメントを追加する」などの問題に適しています。

1. UUID が既知なら owl.incident.get を呼び出し、不明なら先に owl.incident.list で検索します。
2. 関連イベント参照の全ページを読み取り、owl.event.get でイベント内容を取得します。
3. owl.incident_comment.list でコメント、owl.incident_operation.list で操作記録を確認します。
4. 進捗を追加する必要がある場合は owl.incident_comment.add を呼び出します。

リソースオブジェクト特定関連の問題¶

「ホスト、コンテナ、プロセスなどのインフラストラクチャオブジェクトの詳細をクエリする」などの問題に適しています。

1. exec_tool 経由で owl.infrastructure.list を呼び出し、対象オブジェクトを検索します。
2. 返却結果の識別情報に基づき、exec_tool 経由で owl.infrastructure.get を呼び出し、オブジェクトの詳細を取得します。

クロスワークスペース Trace クエリ関連の問題¶

「trace_id を指定して、同一組織内の複数のワークスペースにまたがる Trace をクエリする」などの問題に適しています。

1. 現在のワークスペースは直接クエリします。同一組織の他のワークスペースを対象にする場合、UUID が不明なときだけ owl.account.workspace.same_org.list（CLI：owl workspace same-org list）で候補を検出します。返された workspace_uuid を owl.data.same_org.trace.query に渡し、一覧のページネーション専用の workspace_id は使用しません。
2. 返却結果から workspace_uuid を取得します（workspace_id は使用しないでください）。
3. exec_tool 経由で owl.data.same_org.trace.query を呼び出し、必須の trace_id を渡し、選択した workspace_uuid を workspace_uuids として指定します。省略するか空の配列を渡した場合、現在のワークスペースのみをクエリします。
4. 追加のフィルタリングが必要な場合は、外側の中括弧を含まない where_clause を使用し、trace_id 条件を重複して追加しないでください。クロスワークスペース Trace クエリでは owl.data.simple_query にフォールバックしないでください。

ノート管理関連の問題¶

「ノートを検索、読み取り、作成、変更、削除する」などの問題に適しています。

1. exec_tool 経由で owl.nbook_note.list を呼び出し、ノートを検索して note_uuid を取得します。
2. Markdown 本文を読み取る必要がある場合、owl.nbook_note.get を呼び出します。
3. ノートを作成する場合は owl.nbook_note.add を、更新する場合は owl.nbook_note.modify を呼び出します。
4. 削除する場合は owl.nbook_note.delete を呼び出します。add、modify、delete は書き込みツールであるため、実行前にクライアント側で手動確認を行う必要があります。

モニター管理関連の問題¶

「モニターをクエリする、モニターを作成または更新する、外部イベントを送信する」などの問題に適しています。

1. exec_tool 経由で owl.monitor.list を呼び出し、モニターをクエリします。
2. 返却結果の rule_uuid に基づき、exec_tool 経由で owl.monitor.get を呼び出し、モニターの詳細を表示します。
3. モニターを作成または更新する必要がある場合、exec_tool 経由で owl.monitor.upsert を呼び出します。
4. 外部イベントを送信する必要がある場合、exec_tool 経由で owl.monitor.receive を呼び出します。