> ## 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.

# Toolkits

> Connect AI を使用すると、管理者ユーザーは、AI 駆動のワークフロー内で繰り返し実行可能な操作を行うためのカスタムMCP ツールを含むツールキットを定義できます。

カスタムMCP ツールを使用すると、特定のアクションを再利用可能な確定的なステップとしてコード化し、定義どおりに毎回正確に実行させることで、エージェントの動作を精密に制御できます。ツールキット内でカスタムツールを作成し、そのツールキットのエンドポイントをAI エージェントに提供します。

例えば、Jiraカスタムツールを使用してAIエージェントを作成できます。このエージェントは、未割り当ての高優先度のJiraチケットをすべて検出し、適切なチームメンバーに割り当てます。Jiraカスタムツールはツールキット内で定義します。その後、カスタムツールを含むツールキットのエンドポイントをAIエージェントに提供します。

> [!NOTE]
>
> [Tool Servers](https://docs.cloud.cdata.com/ja/MCP-Gateway.md) は、AI クライアントにツールへのアクセスを提供する新しい方法です。既存のツールキットとそのMCP URL は引き続き動作し、再接続は不要です。新規セットアップでは、MCP Gateway のTool Servers を使用してください。カスタムSQLツール、公開するツールの選択、およびAI 指示は、現時点ではToolkits でのみ利用できます。

Connect AI のナビゲーションメニューから**MCP Gateway > Toolkits** を選択して、**Toolkits** ページにアクセスします。**Toolkits** は、すでに1 つ以上のツールキットがあるアカウントにのみ表示されます。

![List of toolkits](https://mintcdn.com/cdata/gjKECZxsn2dVBOYJ/ja/images/toolkits_home.png?fit=max\&auto=format\&n=gjKECZxsn2dVBOYJ\&q=85\&s=d0864cdeccfae08fbc311e58da98fa90)

**Toolkits** のホームページには、以下の情報が表示されます：

* 利用可能なツールキットの名前。
* 各ツールキットに含まれるカスタムツールの数。
* 各ツールキットに含まれるデータソースのアイコン。
* AIエージェントにURLをコピーするための**Copy URL** ボタン。
* ツールキットの編集、コピー、削除を行うためのメニューアイコン。

## 前提条件

* MCP ツールキットは、Growth+ のお客様のみが利用可能です。
* カスタムツールの作成および設定は、管理者ユーザーのみが行えます。
* 接続ツールを追加するには、1 つ以上の接続を設定する必要があります。詳細については、[ソース](https://docs.cloud.cdata.com/ja/Sources.md)をご覧ください。
* 仮想スキーマツールを追加するには、1 つ以上の仮想スキーマを設定する必要があります。詳細については、[Virtual Schemas](https://docs.cloud.cdata.com/ja/Virtual-Schemas.md)をご覧ください。

## カスタムツールの種類

ツールキットに追加できる主なツールには、**接続ツール**と**仮想スキーマツール**の2種類があります。ツールキットの編集画面では、接続ツールはツールのアイコンで、仮想スキーマツールはフォルダで表示されます。

![Edit toolkit page](https://mintcdn.com/cdata/gjKECZxsn2dVBOYJ/ja/images/toolkits_edit_toolkit.png?fit=max\&auto=format\&n=gjKECZxsn2dVBOYJ\&q=85\&s=b46037508cad23e05083de4f5404e615)

* **接続ツール**–これらのツールは、1つ以上の接続に適用されます。接続ツール内では、ユニバーサルツールやソースツールを有効化できます。また、繰り返し実行可能なSQLクエリや操作のためのカスタムツールを作成することもできます。接続ツールに接続が割り当てられると、その接続を別の接続ツールに割り当てることはできなくなる点に注意してください。
* **仮想スキーマツール** – これらは、仮想スキーマ内のアセットに対して特定のアクションを実行するツールです。仮想スキーマツール内では、ユニバーサルツールを有効化できます。また、カスタムSQLツールを作成することも可能です。

接続ツールおよび仮想スキーマツール内で、タブを選択して、そのツールタイプで利用可能な特定のツールを有効化します。

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

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

**Step 1**

**Toolkits** のメインページで、**Add** をクリックします。**Add Toolkit** ダイアログが表示されます。

**Step 2**

ツールキットの名前を入力し、**Confirm** をクリックします。新しいツールキットが**Toolkits** のメインページに表示されます。

**Step 3**

ツールキットを選択して設定します。

**Step 4**

**Toolkit Name** を追加します。**MCP Remote Server URL** は自動生成されます。これは、MCPクライアントアプリケーションにコピーして貼り付けるURLです。URL には、アクティブなワークスペースのID が含まれます。詳細は、[ツールキットのURL とワークスペース](#ツールキットのurl-とワークスペース) を参照してください。

**Step 5**

**Server Instructions** をMCPサーバーに追加し、「顧客データのみを使用する。外部データは使用しない。」などの一般的なツールキットの境界を設定します。
\[!NOTE] すべてのMCPクライアントがサーバーインストラクションをサポートしているわけではありません。

**Step 6**

**Save Changes** をクリックします。これで、ツールキットにカスタムツールを追加できるようになります。

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

**Step 1**

ツールを追加したいツールキットを開きます。

**Step 2**

ツールが接続ツールか仮想スキーマツールかを選択します。

**Step 3**

ウィザードの手順に従って、ツールを配置する接続または仮想スキーマを追加します。**Confirm** をクリックします。ツールがツールキットエディタに表示されます。

**Step 4**

ツールを編集するには、そのツールを選択します。ツールエディタには、以下のタブがあります：**Universal Tools**、**Source Tools**（接続ツールのみ）、および**Custom Tools**。

**Step 5**

**Universal Tools** タブで、接続または仮想スキーマのユニバーサルツールを有効にします。ツールを選択すると、ツールの説明、注釈、およびパラメータが表示されます。一部のツールは他のツールに依存しており、一緒に有効にする必要があります。

**Step 6**

（接続ツールのみ）**Source Tools** タブで、ソースに使用するツールを有効にします。ツールを選択すると、ツールの説明と、オプションおよび必須のパラメータが表示されます。 必要に応じて、**AI Instructions (MCP Context)** を追加してください。ここでは、境界を設定し、ツールの意図を定義できます。カスタムツール向けの効果的なAI指示を作成するためのガイドラインを以下に示します：

* ツールの目的を明確かつ具体的に記述してください。ツールが何を行うか、どのような入力を受け付けるかを定義します。
* 明確な境界を設定してください。ツールがすべきこと、すべきでないことを明示的に記述します。
* さまざまな入力に対して指示をテストしてください。

**Step 7**

**Custom Tools** タブは上級ユーザー向けです。ツールキット用のカスタムSQLツールの作成方法の詳細については、[Add a Custom SQL Tool](#カスタムsqlツールの追加) を参照してください。

**Step 8**

カスタムツールの設定に問題がなければ、**Save Changes** をクリックします。

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

カスタムツールを使用すると、AIエージェントの応答精度を向上させることができます。カスタムSQLツールを追加するには：

**Step 1**

ツールキット内で、カスタムツールを作成する接続または仮想スキーマツールを選択します。

**Step 2**

ツールエディタで、**Custom Tools** タブをクリックします。

![Add a custom tool](https://mintcdn.com/cdata/gjKECZxsn2dVBOYJ/ja/images/toolkits_add_custom.png?fit=max\&auto=format\&n=gjKECZxsn2dVBOYJ\&q=85\&s=baa2bc0dcf02f6b669e336da47033f3c)

**Step 3**

**Add** をクリックします。カスタムツールエディタが表示されます。

**Step 4**

カスタムSQLエディタでは、ツール名の編集やAI指示の追加が可能です。返されるデータのタイプに対する制限を設定することもできます。

**Step 5**

SQL文を作成します。ドキュメントには、ガイドとなる完全な[SQLリファレンス](https://docs.cloud.cdata.com/ja/SQL-Reference/SQL-Reference.md)が含まれています。

**Step 6**

必要に応じて、SQL文にパラメータを追加します。SQL文にパラメータを追加する場合は、ツールの定義にある**Parameters** セクションにパラメータ名を追加する必要があります。

![Custom SQL tool](https://mintcdn.com/cdata/CqVOVRNVpsH9Gkun/ja/images/customtools_sqltool.png?fit=max\&auto=format\&n=CqVOVRNVpsH9Gkun\&q=85\&s=6467a2fbefc0641eb8ae6e87c6786dbd)

> [!NOTE]
>
> パラメータに**Required** を選択しない場合は、**Default** 列に値を入力できます。エージェントがそのパラメータを省略すると、ツールはこの値で実行されます。エージェントには、ツールの説明にもデフォルト値が表示されます。オプションのパラメータを含むクエリの作成方法については、[SQLカスタムテンプレートの使用](#カスタムsql-テンプレートの使用)も参照してください。

**Step 7**

**Validate SQL** をクリックします。また、**Open in Data Explorer** をクリックして、SQL文の結果を確認することもできます。

**Step 8**

**Save Changes** をクリックして、カスタムSQL ツールを保存します。

**Step 9**

ツールがツールキットに表示されます。ツールの設定に問題がなければ、ツールを有効にします。

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

標準のSQL の代わりに、カスタムSQL テンプレートを使用して、カスタムSQL ツール内でSQL ステートメントを作成できます。カスタムテンプレートを使用すると、オプションのパラメータ、またはオプションと必須のパラメータを組み合わせることができます。

以下の 2 つの例は、`SELECT` ステートメント用のBullhorn CRM 向けSQL テンプレートに基づいています。データソースで受け入れられるパラメータについては、データソースのデータモデルを参照してください。

次の例は、必須パラメータとオプションパラメータの両方を含むカスタムSQLテンプレートを示しています：

```sql wrap theme={null}
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` は必須です。残りのパラメータはオプションです。クエリでは、オプションパラメータを任意の数含めることも、一切含めないことも可能です。

> [!WARNING]
>
> Jinja テンプレートでは、パラメータの値をSQL ステートメントに挿入するには`@param` を使用します。`{{ param }}` は、値の代わりに`true` という語が出力されるため、使用しないでください。テンプレートでパラメータに`{{ param }}` を使用している場合、カスタムSQLエディタに警告が表示されます。`{{ }}` は、`{{catalog_name}}` など、Connect AI が提供する値にのみ使用してください。
>
> ```sql wrap theme={null}
> -- Correct
> {% if city %} AND AddressCity = @city {% endif %}
>
> -- Incorrect: renders AddressCity = true
> {% if city %} AND AddressCity = {{ city }} {% endif %}
> ```

このSQLテンプレートの例では、すべてのパラメータは個別に省略可能ですが、テンプレートでは少なくとも1つのパラメータを指定する必要があります。

```sql wrap theme={null}
{% 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 エージェントにカスタムコネクタとして貼り付けます。

## ツールキットのURL とワークスペース

各ツールキットはワークスペースに属しており、**MCP Remote Server URL** にはそのワークスペースのID が含まれます：

```text theme={null}
https://mcp.cloud.cdata.com/mcp/workspace/{workspaceId}/toolkits/{toolkitId}
```

Admin UI には、**General** ワークスペース内のツールキットを含め、すべてのツールキットについて、このワークスペース単位のURL が表示されます。**General** 以外のワークスペースのツールキットでは、ワークスペース単位のURL を使用する必要があります。詳細は [Workspace](https://docs.cloud.cdata.com/ja/Workspaces.md) を参照してください。

ワークスペースを含まない既存のツールキットURL も引き続き動作します。これらのURL は、ワークスペースが有効になっているアカウントで既存のすべてのツールキットを含む**General** ワークスペースに解決されます。すでにこれらのURL を使用しているAI クライアントを更新する必要はありません。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.