メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt

Use this file to discover all available pages before exploring further.

カスタム MCP ツールを使用すると、特定のアクションを再利用可能な確定的なステップとしてコード化し、定義どおりに毎回正確に実行させることで、エージェントの動作を精密に制御できます。ツールキット内でカスタムツールを作成し、そのツールキットのエンドポイントを AI エージェントに提供します。 例えば、Jiraカスタムツールを使用してAIエージェントを作成できます。このエージェントは、未割り当ての高優先度のJiraチケットをすべて検出し、適切なチームメンバーに割り当てます。Jiraカスタムツールはツールキット内で定義します。その後、カスタムツールを含むツールキットのエンドポイントをAIエージェントに提供します。 Connect AI のナビゲーションメニューからAI > Toolkits を選択して、Toolkits ページにアクセスします。
List of toolkits
Toolkits のホームページには、以下の情報が表示されます：
  • 利用可能なツールキットの名前。
  • 各ツールキットに含まれるカスタムツールの数。
  • 各ツールキットに含まれるデータソースのアイコン。
  • AIエージェントにURLをコピーするためのCopy URL ボタン。
  • ツールキットの編集、コピー、削除を行うためのメニューアイコン。

​
前提条件

  • MCP ツールキットは、Growth+ のお客様のみが利用可能です。
  • カスタムツールの作成および設定は、管理者ユーザーのみが行えます。
  • 接続ツールを追加するには、1 つ以上の接続を設定する必要があります。詳細については、ソースをご覧ください。
  • ワークスペースツールを追加するには、1 つ以上のワークスペースを設定する必要があります。詳細については、ワークスペースをご覧ください。

​
カスタムツールの種類

ツールキットに追加できる主なツールには、接続ツールとワークスペースツールの2種類があります。ツールキットの編集画面では、接続ツールはツールのアイコンで、ワークスペースツールはフォルダで表示されます。
Edit toolkit page
  • 接続ツール–これらのツールは、1つ以上の接続に適用されます。接続ツール内では、ユニバーサルツールやソースツールを有効化できます。また、繰り返し実行可能なSQLクエリや操作のためのカスタムツールを作成することもできます。接続ツールに接続が割り当てられると、その接続を別の接続ツールに割り当てることはできなくなる点に注意してください。
  • ワークスペースツール – これらは、ワークスペース内のアセットに対して特定のアクションを実行するツールです。ワークスペースツール内では、ユニバーサルツールを有効化できます。また、カスタムSQLツールを作成することも可能です。
接続ツールおよびワークスペースツール内で、タブを選択して、そのツールタイプで利用可能な特定のツールを有効化します。
  • Universal Tools – これらは、 Connect AI に組み込まれているデータ探索および操作機能です。getSchemas、getTables、executeProcedure などの操作を提供します。これらは接続ツールとワークスペースツールの両方で利用可能です。ツールを有効にすると、そのツールには接続内のすべてのアセット、またはワークスペース内のすべてのアセットが含まれます。個々のツールをクリックすると、そのツールの説明、注釈、およびパラメータを表示できます。注釈の詳細な説明については、情報ボタンをクリックしてください。 ユニバーサルツールには依存関係がある場合があることに注意してください。あるツールを有効にするには、別のツールの有効化が必要になる場合があります。
  • Source Tools（接続ツールのみ） – クエリを最適化するために、接続内の各アセットに対して get、search、create などのアクションを設定できます。例えば、Jira 接続がある場合、課題の検索、作成、更新、削除を行うツールを有効にできます。各ツールを編集して AI 指示を追加できます。また、必須およびオプションのパラメータを確認することもできます。
  • Custom SQL Tools – 繰り返し実行するクエリや操作のために、カスタムSQLツールを作成できます。SQLクエリに入力される必須またはオプションのパラメータを追加できます。

​
新しいツールキットの追加

1
Toolkits のメインページで、Add をクリックします。Add Toolkit ダイアログが表示されます。
2
ツールキットの名前を入力し、Confirm をクリックします。新しいツールキットがToolkits のメインページに表示されます。
3
ツールキットを選択して設定します。
4
Toolkit Name を追加します。MCP Remote Server URL は自動生成されます。これは、MCPクライアントアプリケーションにコピーして貼り付けるURLです。
5
Server Instructions をMCPサーバーに追加し、「顧客データのみを使用する。外部データは使用しない。」などの一般的なツールキットの境界を設定します。
すべてのMCPクライアントがサーバー指示をサポートしているわけではありません。
6
Save Changes をクリックします。これで、ツールキットにカスタムツールを追加できるようになります。

​
ツールキットへのカスタムツールの追加

1
ツールを追加したいツールキットを開きます。
2
ツールが接続ツールかワークスペースツールかを選択します。
3
ウィザードの手順に従って、ツールを配置する接続またはワークスペースを追加します。Confirm をクリックします。ツールがツールキットエディタに表示されます。
4
ツールを編集するには、そのツールを選択します。ツールエディタには、以下のタブがあります：Universal Tools、Source Tools（接続ツールのみ）、およびCustom Tools。
5
Universal Tools タブで、接続またはワークスペースのユニバーサルツールを有効にします。ツールを選択すると、ツールの説明、注釈、およびパラメータが表示されます。一部のツールは他のツールに依存しており、一緒に有効にする必要があります。
6
（接続ツールのみ）Source Tools タブで、ソースに使用するツールを有効にします。ツールを選択すると、ツールの説明と、オプションおよび必須のパラメータが表示されます。 必要に応じて、AI Instructions (MCP Context) を追加してください。ここでは、境界を設定し、ツールの意図を定義できます。カスタムツール向けの効果的なAI指示を作成するためのガイドラインを以下に示します：
  • ツールの目的を明確かつ具体的に記述してください。ツールが何を行うか、どのような入力を受け付けるかを定義します。
  • 明確な境界を設定してください。ツールがすべきこと、すべきでないことを明示的に記述します。
  • さまざまな入力に対して指示をテストしてください。
7
Custom Tools タブは上級ユーザー向けです。ツールキット用のカスタムSQLツールの作成方法の詳細については、Add a Custom SQL Tool を参照してください。
8
カスタムツールの設定に問題がなければ、Save Changes をクリックします。

​
カスタムSQLツールの追加

カスタムツールを使用すると、AIエージェントの応答精度を向上させることができます。カスタムSQLツールを追加するには：
1
ツールキット内で、カスタムツールを作成する接続またはワークスペースツールを選択します。
2
ツールエディタで、Custom Tools タブをクリックします。
Add a custom tool
3
Add をクリックします。カスタムツールエディタが表示されます。
4
カスタムSQLエディタでは、ツール名の編集やAI指示の追加が可能です。返されるデータのタイプに対する制限を設定することもできます。
5
SQL文を作成します。ドキュメントには、ガイドとなる完全なSQLリファレンスが含まれています。
6
必要に応じて、SQL文にパラメータを追加します。SQL文にパラメータを追加する場合は、ツールの定義にあるParameters セクションにパラメータ名を追加する必要があります。
Custom SQL tool
SQL文に標準SQLを使用する場合、追加するパラメータはすべてrequired パラメータでなければならず、そうでない場合はクエリが失敗します。オプションのパラメータを含むクエリの作成方法については、SQLカスタムテンプレートの使用を参照してください。
7
Validate SQL をクリックします。また、Open in Data Explorer をクリックして、SQL文の結果を確認することもできます。
8
Save Changes をクリックして、カスタム SQL ツールを保存します。
9
ツールがツールキットに表示されます。ツールの設定に問題がなければ、ツールを有効にします。

​
カスタム SQL テンプレートの使用

標準の SQL の代わりに、カスタム SQL テンプレートを使用して、カスタム SQL ツール内で SQL ステートメントを作成できます。カスタムテンプレートを使用すると、オプションのパラメータ、またはオプションと必須のパラメータを組み合わせることができます。 以下の 2 つの例は、SELECT ステートメント用の Bullhorn CRM 向け SQL テンプレートに基づいています。データソースで受け入れられるパラメータについては、データソースのデータモデルを参照してください。 次の例は、必須パラメータとオプションパラメータの両方を含むカスタムSQLテンプレートを示しています： 
SELECT * FROM {{catalog_name}}.BullhornCRM.Candidate
WHERE FirstName = @first_name
AND LastName = @last_name
{% if address %} AND AddressAddress = @address {% endif %}
{% if city %} AND AddressCity = @city {% endif %}
{% if state %} AND AddressState = @state {% endif %}
{% if zip %} AND AddressZip = @zip {% endif %}
{% if country_name %} AND AddresscountryName = @country_name {% endif %}
{% if email %} AND Email1 = @email {% endif %}
{% if mobile_phone %} AND MobilePhone = @mobile_phone {% endif %}
@first_name および@last_name は必須です。残りのパラメータはオプションです。クエリでは、オプションパラメータを任意の数含めることも、一切含めないことも可能です。 このSQLテンプレートの例では、すべてのパラメータは個別に省略可能ですが、テンプレートでは少なくとも1つのパラメータを指定する必要があります。 
{% if first_name == blank and last_name == blank and email == blank and mobile_phone == blank and city == blank and state == blank %}
SELECT 'Error: at least one search parameter is required' AS ErrorMessage
{% else %}
SELECT * FROM {{catalog_name}}.BullhornCRM.Candidate
WHERE 1=1
{% if first_name %} AND FirstName = @first_name {% endif %}
{% if last_name %} AND LastName = @last_name {% endif %}
{% if email %} AND Email1 = @email {% endif %}
{% if mobile_phone %} AND MobilePhone = @mobile_phone {% endif %}
{% if city %} AND AddressCity = @city {% endif %}
{% if state %} AND AddressState = @state {% endif %}
{% endif %}
このクエリは、1 つのパラメータが含まれていれば成功します。WHERE 1=1 を使用すると、その前に条件があるかどうかを気にすることなく、AND 句を安全に追加できます。

​
エージェントへのエンドポイントの追加

Connect AI は、各ツールキットにエンドポイントを提供します。メインのToolkits ページで、目的のツールキットのCopy URL をクリックします。実際の URL を確認したい場合は、ツールキットエディタページを開くことができます。MCP Remote Server URL をコピーし、AI エージェントにカスタムコネクタとして貼り付けます。