MCP ツール一覧¶

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

ツールの可視範囲と呼び出し結果は、現在使用している API Key の権限に依存します。API Key に関連リソースや操作権限がない場合、対応するツールの呼び出しは失敗するか、空の結果を返す可能性があります。

ツールの範囲¶

OWL MCP Server で実行可能な業務ツールは、プラットフォーム機能の拡充に伴い随時更新されます。実際に実行可能なツールは、list_catalogs と list_tools が返すツールカタログを基準としてください。

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

権限タイプ¶

使用上のルール¶

MCP クライアントは以下の順序で呼び出しを行ってください。

1. list_catalogs を呼び出して利用可能なカテゴリを確認する。
2. list_tools を呼び出し、catalog_id を指定して、そのカテゴリの業務ツールとパラメータを確認する。
3. exec_tool を呼び出し、tool_name と parameters を指定して業務ツールを実行する。

ツール概要¶

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 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¶

インシデント一覧、インシデントコメント、操作記録、オンコールスケジュールのクエリに使用します。

Infrastructure¶

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

LLM¶

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

Member¶

ワークスペースメンバーの一覧クエリと、名前やメールアドレスキーワードによる検索に使用します。

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 使用パス¶

データクエリ系の問題¶

「メトリクス、ログ、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. exec_tool で owl.incident.list を呼び出し、インシデントをクエリする。
2. インシデントの incident_uuid を使用して exec_tool で以下を呼び出す：
3. owl.incident_comment.list でコメントを表示
4. owl.incident_operation.list で操作記録を表示
5. 対応情報を追加する必要がある場合、exec_tool で owl.incident_comment.add を呼び出す。

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

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

1. exec_tool で owl.infrastructure.list を呼び出し、対象オブジェクトを検索する。
2. 戻り値の識別情報を使用して、exec_tool で owl.infrastructure.get を呼び出し、オブジェクトの詳細を取得する。

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

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

1. exec_tool で owl.account.workspace.same_org.list を呼び出し、同一組織内の候補ワークスペースを検出する。
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 を呼び出す。