MCPツールセットの作成

「モデル・コンテキスト・プロトコル・サーバー」ページで、目的のMCPサーバーを選択します。

特定のMCPサーバー・ページで、「ツールセット」タブを選択します。

「モデル・コンテキスト・プロトコル・ツールセットの作成」をクリックします。

ツールセットを作成するための次の詳細を入力します。

• 名前: ツールセットの名前を入力します。

• 説明: ツールセットの説明を入力します。

• コンパートメント: ツールセットのコンパートメントを選択してください。

• タイプ: 次のオプションから選択します。

  • カスタムSQLツール: 入力パラメータを取得できるユーザー定義のSQLまたはPL/SQLスクリプトを実行できます。

  • 組込みSQLツール: アドホックSQLまたはPL/SQLスクリプトを実行したり、一般的なデータベース操作を実行したりできます。

    ノート
    
    データベース・ユーザー権限は、意図しない変更や認可されていない変更を防ぐために必要な最小限に制限します。

  • カスタマイズ可能なレポート・ツール: 事前作成済のパラメータ駆動型SQLレポートを検索して実行できます。

    ノート
    
    SQLレポートは、カスタマイズ可能なレポート・ツール・リストに表示される前に、データベース・ツールのSQLレポートを使用して最初に作成する必要があります。

    • dbtools_list_reports: 実行可能なすべての事前定義済レポートのリストを取得します。

    • dbtools_execute_report: 事前定義済レポートを実行し、その結果を返します。

    • dbtools_get_report_sql: 事前定義済レポートの基礎となるSQL問合せを取得します。

    • dbtools_get_tool_request: 現在のステータスと、以前に送信された非同期ツール・コールの最終結果を取得します。

• デフォルト実行タイプ: ツール・リクエストの実行方法を指定します。即時レスポンスには「同期」を、長時間実行される操作には「非同期」を使用し、後でリクエスト識別子を使用して結果を取得できます。デフォルトは「同期」です。

  ツールセットに対して非同期実行が有効になっている場合、ツール・リクエストは即時の結果を返すか、リクエストが処理中であることを示すレスポンスを返すことができます。このような場合、レスポンスには、リクエストが完了して最終結果を取得するまで、MCPクライアントがステータスを確認するために使用できる情報が含まれます。

  非同期実行では、MCPサーバー用に記憶域オプションを構成する必要があります。サポートされている記憶域オプションには、NONEおよびOBJECT_STORAGEがあります。

  ツールタイプの詳細は、「組み込みツールとカスタムツール」を参照してください。

• カスタムSQLの場合は、次のように入力します。

  • ツール名: MCPクライアントに表示するツール名を入力します。

  • ツールの説明: MCPクライアントに表示するツールの説明を入力します。

    ノート
    
    Tool nameおよびTool descriptionは、大規模言語モデル(LLM)がツールの目的と機能を理解するのに役立ちます。明確で詳細な説明を提供することで、結果の品質を向上させることができます。

    LLMは、ツールの説明を使用して、各レポート・ツールの動作を理解し、それらを使用するタイミングを決定します。

  • 許可されたロール: リストから許可されたロールを選択します。役割の詳細は、「アプリケーション役割」を参照してください。

  • SQLソース: SQLソース・コードを入力またはアップロードします。

  • 変数: 追加される各変数の名前、タイプおよび説明を入力します。明確で詳細な説明を提供して、結果の品質を向上させます。

「作成」をクリックします。「ツールセット」ページに新しいツールセットが表示されます。