Cohesity Gaia MCP (プレビュー)

モデル コンテキスト プロトコル (MCP) サーバーを使用して、Copilot Studioエージェントを Cohesity Gaia Data Insights に接続します。 エージェントは、実行時にツールを検出し、データセットにクエリを実行し、LLM Q&A を実行し、Gaia API キーを使用してインデックス付きドキュメントを検索します。

このコネクタは、次の製品とリージョンで使用できます。

アーキテクチャの概要

Gaia MCP サーバーは、Copilot Studioや Gaia REST API などの MCP クライアント間のブリッジとして機能します。 MCP クライアントは、/mcp エンドポイントで Streamable HTTP 経由でモデル コンテキスト プロトコルを使用してサーバーと通信します。 サーバーは FastMCP で実装され、stateless_http=True で実行されます。

各 MCP ツールは、x-mcp-tool で明示的にマークされた特定の Gaia REST 操作にマップされます。Gaia OpenAPI 仕様では true です。 ツールの名前と説明は、x-mcp-config を使用してカスタマイズできます。

クライアントがツールを呼び出すと、MCP サーバーは JSON-RPC 要求を処理し、構成されたapi.base_urlを使用して対応する Gaia REST API を呼び出します。 サーバーは、MCP ベースのアクセスと直接 REST API の使用の間で認証と承認が一貫するように、ほとんどの受信 HTTP ヘッダーを転送します。

使用可能な MCP ツール

MCP サーバーは、x-mcp-tool: true でマークされた OpenAPI 操作に対してのみツールを生成します。

|MCP ツール |OpenAPI operationId |メソッド |Gaia Path | |---------------------|---------------------------|--------|-------------------------| |gaia_datasets |GetDatasets |GET |/datasets | |gaia_dataset_topics |GetDatasetDiscoveryResults|GET |/dataset/{id}/discovery |gaia_ask |QueryLlm |POST |/ask | |gaia_search |完全検索 |PUT |/ask/完全 |注: すべてのツールには、GAIA_VIEW特権が必要です。

認証とヘッダー

Gaia で必須

Gaia では、OpenAPI 仕様で定義されている API キーベースのセキュリティ スキーム (ApiKeyAuth) が使用されます。

クライアントには、次のヘッダーを含める必要があります。

• apiKey: Gaia API キー

gaia_datasets

• 目的: データセットを一覧表示し、他の Gaia ツールのエントリ ポイントとして機能します。
• Visible Parameters: x-mcp-config.hidden-params (statuses, sortField, sortOrder) で非表示にされているものを除く、OpenAPI 仕様のすべてのクエリ パラメーター。
• 既定値: pageSize: 20 は、指定されていない場合はクエリの既定値によって適用されます。
• 応答: GetDatasetsResponse モデルにトリミングされます。

gaia_dataset_topics

• 目的: データセットの階層トピックを返します。
• Path パラメーター: id は、表示名ではなく、gaia_datasetsによって返されるデータセットの 16 進 ID である必要があります。
• 既定値: レベル: 1、numLevels: 2。
• 非表示のパラメーター: uuid。
• 依存関係 (情報): GetDatasets、GetDatasetDetails。

gaia_ask

• 目的: 1 つ以上のデータセットにわたって LLM クエリを実行します
• 要求本文: 必須フィールドを持つ LlmQueryParams:
  • datasetNames (配列)
  • クエリ文字列
• 非表示フィールド: llmId、llmName、llm、conversationId、queryLanguageCode、history、metadata。
• 応答: QueryLlmResponse スキーマ (応答テキスト、サポート ドキュメント、進行状況、識別子) にフィルター処理されます。

gaia_search

• 目的: データセット内で完全な検索を実行します。
• 要求本文: 必要なフィールドを含む完全なSearchParams:
  • datasetName
  • クエリ文字列
  • pageSize (クエリの既定値を使用して挿入される既定の 10)
• 非表示フィールド: conversationId。
• 応答: ExhaustiveSearchResponse スキーマ (ドキュメント、改ページトークン、ID) にフィルター処理されます。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

アクション

Cohesity Gaia MCP