Klavis Strata

公式

あらゆる規模でAIエージェントがツールを確実に使用するためのMCPサーバー

Klavis Strata MCPで何ができますか?

  • 意図に基づく関連ツールの発見 — アシスタントに、discover_server_categories_or_actions を使用して自然言語クエリでサーバー全体の一致するカテゴリやアクションを検索するよう依頼します。
  • カテゴリ内のアクションの探索 — get_category_actions を使用して、特定のサービスカテゴリの全アクション名のリストを要求します。
  • アクションスキーマの検査 — get_action_details にカテゴリ名とアクション名を指定して、特定のアクションの完全なパラメータ詳細を取得します。
  • APIアクションの実行 — パス、クエリ、またはボディパラメータを使用してサーバーアクションを実行し、必要に応じて出力フィールドをフィルタリングします(execute_action を使用)。
  • サーバードキュメントの検索 — サーバー内でキーワードベースのドキュメント検索を依頼し、search_documentation を使用して関連するエンドポイントを見つけます。
  • 認証失敗の解決 — 401エラーを処理し、handle_auth_failure を使用して認証URLを取得するか、ユーザー提供の認証情報を保存します。

ドキュメント

Strata

AIエージェントが任意の規模でツールを段階的に使用できるようにするためのMCPサーバー

<img src="https://mintcdn.com/klavisai/7Siw7A5JJSHURM5d/images/concepts/strata_hero.png?fit=max&auto=format&n=7Siw7A5JJSHURM5d&q=85&s=b581fdb821699a32b260d124789396bd" alt="Strata Hero - Progressive tool discovery for AI agents" className="w-full rounded-lg" style={{ maxWidth: '100%', height: 'auto' }} width="2533" height="496" data-path="images/concepts/strata_hero.png" />

Strataとは?

Strataは、AIエージェントが複雑な環境でもツールを確実に使用できるように導く単一のMCPサーバーです。すべてを一度に提供して圧倒するのではなく、人間がツールと対話する方法を考慮して設計されており、現在AIエージェントを悩ませる3つの主要な問題を解決します:

  • ツール過多:ツールが多すぎるとLLMの選択が麻痺する
  • コンテキスト過多:長いツールリストがトークン数とコストを増大させる
  • カバレッジギャップ:ほとんどのサーバーは40〜50個のツールに留まり、構築できる範囲が制限される

Strataは、ウェブサイト、API、またはオープンソースを通じて、ご自身のデータで使用できます!

ビデオチュートリアル

Strataの仕組みを完全に理解するには、このビデオチュートリアルをご覧ください:

テキストチュートリアル

ヒント

この共有されたClaude会話をチェックして、Strataの動作を確認してください!

1. サーバーカテゴリまたはアクションを発見する

discover_server_categories_or_actions - ユーザーの意図に基づいて関連するカテゴリまたはアクションを見つけます。セマンティック検索は不要です!

**説明**: **推奨される開始ポイント**。ユーザーのクエリに基づいて利用可能なカテゴリまたはアクションを発見します。サーバー全体で利用可能なアクションを探索する際は、最初にこのツールを試してください。これは利用可能なアクションを探索するための主要なエントリポイントであり、他の検索方法よりも先に使用する必要があります。出力は、詳細レベルと詳細情報を含むサーバーのリストになります。

詳細レベルが「categories_only」の場合、詳細はカテゴリ名のリストのみになります。次のステップでは、get_category_actionsツールを使用してカテゴリのアクションを取得することをお勧めします。

詳細レベルが「full_details」の場合、詳細はカテゴリ名とそのアクションの詳細を含むリストになります。これはサーバーにアクションが少数しかない場合に発生します。次のステップでは、execute_actionツールを使用してアクションを実行することをお勧めします。

詳細レベルが「categories_and_actions」の場合、詳細はカテゴリ名とアクション名のリストになります。これは外部ツールを使用する場合に発生します。次のステップでは、get_action_detailsツールを使用してアクションの詳細を取得することをお勧めします。

パラメータ:

  • user_query (文字列、必須):結果をフィルタリングするための自然言語のユーザークエリ。
  • server_names (配列、必須):カテゴリまたはアクションを発見するサーバー名のリスト。

2. カテゴリアクションを取得する

get_category_actions - 指定されたカテゴリ内のすべてのアクション名を取得します。

**説明**:特定のカテゴリ内で利用可能なAPIアクションの包括的な概要を取得します。特定のサービスカテゴリで利用可能なアクションを探索したい場合や、カテゴリの機能の詳細なビューを取得したい場合は、このツールを使用してください。**重要**:このツールは、discover_server_categoriesツールからサーバーカテゴリを取得した後にのみ呼び出す必要があります。

パラメータ:

  • category_names (配列、必須):アクションを取得するカテゴリのリスト

3. アクションの詳細を取得する

get_action_details - 特定のアクションの完全なスキーマとパラメータを取得します。

**説明**:特定のアクションに関する詳細情報(必須およびオプションのパラメータを含む)を取得します。カテゴリ名とアクション名を指定する必要があります。**重要**:このツールは、以前のツール呼び出しからサーバーカテゴリを取得した後にのみ呼び出す必要があります。

パラメータ:

  • category_name (文字列、必須):カテゴリの名前
  • action_name (文字列、必須):カテゴリ内のアクション/操作の名前

4. アクションを実行する

execute_action - パラメータを使用してアクションを実行し、結果を取得します。

**説明**:提供されたパラメータを使用して特定のアクションを実行します。サーバー名、アクション名、およびアクションパラメータを指定する必要があります。**重要**:このツールは、get_action_detailsツールからアクションの詳細を取得した後にのみ呼び出す必要があります。

パラメータ:

  • server_name (文字列、必須):サーバーの名前
  • category_name (文字列、必須):アクションを実行するカテゴリの名前
  • action_name (文字列、必須):実行するアクション/操作の名前
  • path_params (文字列、オプション):アクションのパスパラメータを含むJSON文字列
  • query_params (文字列、オプション):アクションのクエリパラメータを含むJSON文字列
  • body_schema (文字列、オプション、デフォルト:"{}"):アクションのリクエストボディを含むJSON文字列
  • include_output_fields (配列、オプション):以前のツール呼び出しでこのアクションのresponse_schemaを知っている場合に強く推奨されるオプション:レスポンスに含めるフィールドパスの配列。これらのフィールドのみが返されます。ネストされたフィールドにはドット表記を使用します(例:"author.displayName")。
  • maximum_output_characters (整数、オプション):オプション:レスポンスで返す最大文字数。レスポンスがこの制限を超える場合は切り詰められます。これよりもinclude_output_fieldsを優先してください。

5. ドキュメントを検索する

search_documentation - 必要な場合にのみ関連情報を見つけます。

**説明**:**セカンダリオプション**:このツールは、discover_server_categoriesが十分な詳細を提供しない場合、または特定のサーバーのドキュメント内を検索する必要がある場合にのみ使用してください。キーワードマッチングを使用して、カテゴリ、操作、タグ、または機能別にサーバーアクションのドキュメントを検索します。これは自然言語検索ではなく、正確なキーワードとフレーズを照合します。関連性でランク付けされたエンドポイントを返します。最適な一致を見つけるには、いくつかのターゲットを絞ったキーワードを使用してください。一般的なパターン:カテゴリ名(「projects」、「users」、「pipelines」)、アクション(「create」、「delete」、「list」、「get」)、または組み合わせ(「create user」、「list projects」)。検索アルゴリズムはスマートスコアリングを使用して、冗長な説明フィールドが結果を圧倒しないようにします。

パラメータ:

  • query (文字列、必須):APIドキュメントの用語に一致する検索キーワード。ベストプラクティス:(1)「users」、「projects」、「files」などのリソース名を使用する、(2)精度を高めるために「user create」や「project delete」などのアクションを追加する、(3)「how to」、「show me」、「all the」などの冗長な単語を避け、エンドポイント名と説明に現れる核心的な用語に焦点を当てる。
  • server_name (文字列、必須):検索するサーバーの名前。
  • max_results (整数、オプション、デフォルト:10、最小:1、最大:50):返す結果の数。デフォルト:10

6. 認証失敗を処理する

handle_auth_failure - 必要な場合にのみ認証を処理します。

**説明**:アクションの実行中に発生する認証失敗を処理します。重要:このツールは、execute_actionが認証の問題(401 Unauthorized、無効な資格情報、期限切れのトークンなど)によって特に失敗した場合にのみ呼び出す必要があります。認証ステータスを確認するためやその他の目的でこのツールを呼び出さないでください。使用方法:(1) execute_actionが認証エラーを返した場合、「get_auth_url」を指定してこのツールを呼び出し、認証手順を取得します。(2) 失敗後にユーザーが認証データを提供した場合、「save_auth_data」を指定してこのツールを呼び出し、資格情報を保存します。失敗が認証失敗でない場合(例:404 Not Found、500 Internal Server Errorなど)は、このツールを絶対に呼び出さないでください。

パラメータ:

  • server_name (文字列、必須):execute_action中に認証に失敗したサーバーの名前
  • intention (文字列、必須、enum:["get_auth_url", "save_auth_data"]):execute_actionが認証エラーで失敗した場合は「get_auth_url」を使用して認証手順を取得します。認証失敗後にユーザーが認証資格情報を提供した場合は「save_auth_data」を使用します。
  • auth_data (オブジェクト、オプション):認証失敗後にユーザーが提供した認証データ(例:{"token": "...", "api_key": "..."})。認証失敗を解決する際に「save_auth_data」の意図でのみ使用されます。

評価

Strataは実際の結果を提供します:

  • MCPMarkベンチマーク:公式のGitHubサーバーと比較して**+15.2%高いpass@1率**、公式のNotionサーバーと比較して**+13.4%高いpass@1率**を達成。(ソース)
  • 人間による評価:2,000件以上の実世界のクエリ評価セットで83%以上の精度を達成

次のステップ

数分で最初のStrataサーバーを作成 完全なStrata APIを探索

このドキュメントは、開発者ドキュメントプラットフォームであるMintlify上で構築およびホストされています。