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

# Management MCP

> Management MCP サーバーは、MCP 対応クライアントを介して利用可能なデータソースの確認やコネクションの管理を行うための管理ツールを公開します。Connect AI UI を介さずに、プログラムからコネクションの一覧表示、作成、テストを行うために使用します。

<Note>
  Management MCP は Connect AI Developer edition でのみ利用可能です。
</Note>

サポートされているクライアントツールから Management MCP を使用するには、**Remote MCP Server URL** フィールドに次の URL を追加します： *[https://mcp.cloud.cdata.com/mcp/mgmt](https://mcp.cloud.cdata.com/mcp/mgmt)* 。接続後、管理ツールを実行する自然言語の質問を行うか、`tools/call` を介してツールを直接呼び出すことができます。

## 認証

Management MCP サーバーは、データ MCP サーバーと同じ認証オプションを使用します。詳細については [認証](/ja/API/Authentication) を参照してください。

## Management MCP ツール

Management MCP サーバーは以下のツールを公開しています。ツール名と、下記の入力パラメータに対応する `arguments` オブジェクトを指定して `tools/call` で呼び出します。

### コネクション管理

#### create\_connection

新しいデータソースのコネクションを保存します。必須プロパティ名はソースによって異なり、`get_source_properties` から取得します。ソースが OAuth を使用する場合（例：Google Sheets や Salesforce）、レスポンスにはユーザーがブラウザで開いてサインインとセットアップを完了するためのリンクが含まれます。

**パラメータ**

* `name`（string、必須）—ユーザーのコネクション一覧に表示される短く分かりやすい名前。
* `source`（string、必須）—`list_available_sources` で取得した内部ソース名。
* `properties`（object、必須）—`get_source_properties` で取得したフィールド名をキーとする、設定値の string/string マップ。

**戻り値：** 作成されたコネクションオブジェクト（新しい `id` を含む）。OAuth ソースの場合、ユーザーが開く必要のあるサインイン URL も含まれます。

***

#### get\_source\_properties

指定されたデータソースが受け入れる設定フィールド（URL、認証情報、オプションなど）を記述します。レスポンスは `basic` フィールド（最初に表示）と、カテゴリごとにグループ化された `advanced` フィールドに分割されます。固定値セットを持つフィールド（認証方式など）の場合、レスポンスには許容値と各値で表示される追加フィールドが含まれます。`create_connection` の前にこれを呼び出します。

**パラメータ**

* `source`（string、必須）—`list_available_sources` から返される内部ソース名（例：`"JIRA"`、`"Salesforce"`、`"Snowflake"`）。

**戻り値：** 各フィールドの名前、型、必須フラグ、許容値、条件付き追加フィールドを含む `basic` と `advanced` のフィールド記述子のオブジェクト。

***

#### list\_available\_sources

ユーザーが接続できるデータソース（例：Salesforce、Snowflake、Jira）を一覧表示します。ソースが利用可能であることを確認するため、`create_connection` の前に呼び出します。

**パラメータ：** なし

**戻り値：** 内部 `source` 名（他のツールに渡す値）、表示名、バージョン、カテゴリを持つソースエントリの配列。

***

#### list\_connections

ユーザーが既に保存しているデータソースのコネクションを一覧表示します。`test_connection` または `add_tool_to_toolkit` で必要なコネクション `id` を確認するために使用します。

**パラメータ：** なし

**戻り値：** `id`、`name`、ソースタイプを持つコネクションオブジェクトの配列。

***

#### test\_connection

データソースへの接続を試みて、保存済みのコネクションが実際に動作するかを検証します。`create_connection` の後、ユーザーが OAuth サインインを完了した後、または以前に動作していたコネクションが失敗するようになったときに使用します。

**パラメータ**

* `id`（string、必須）—`list_connections` から返されたコネクション `id`。

**戻り値：** 成功メッセージ、またはユーザーが対処できる具体的なエラー。

***

### ツールキット管理

#### add\_tool\_to\_toolkit

既存のコネクションをツールキットにアタッチし、そのデータ操作をツールキットの MCP サーバーで利用できるようにします。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `connection_id`（string、必須）—`list_connections` から取得した、追加するコネクションの `id`。

**戻り値：** コネクション名、ソースタイプ、デフォルトで有効な操作を含む、新しいツールキットツールエントリ。

***

#### create\_toolkit

空の新しいツールキットを作成します。作成後、`add_tool_to_toolkit` を使用してコネクションを追加します。

**パラメータ**

* `name`（string、必須）—ツールキットの短く分かりやすい名前。
* `server_instructions`（string、オプション）—このツールキットに接続する MCP クライアントに提示される、自然言語のガードレール。

**戻り値：** 作成されたツールキットオブジェクト（新しい `id` を含む）。

***

#### get\_toolkit

ツールキットの完全な状態（名前、サーバーインストラクション、isActive ステータス、MCP リモート接続情報）を取得します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。

**戻り値：** `id`、`name`、`serverInstructions`、`isActive`、MCP リモート情報を持つツールキットオブジェクト。

***

#### get\_toolkit\_tool

ツールキット内の 1 つのコネクションの完全な状態（コネクション名、有効な操作、操作ごとの指示）を取得します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `tool_id`（string、必須）—`list_toolkit_tools` から取得したツールキットツールの `id`。

**戻り値：** コネクション名、ソースタイプ、有効な操作、指示を持つツールキットツールオブジェクト。

***

#### list\_custom\_tools

ツールキット内のすべてのコネクションにわたるカスタム SQL ツールを一覧表示します。オプションで 1 つのコネクションにフィルタできます。SQL 本文は含まれません。ツールの SQL を編集するには管理 UI を使用します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `tool_id`（string、オプション）—`list_toolkit_tools` から取得した、ツールキット内のコネクションの `id`。省略するとすべてのコネクションのカスタムツールが返されます。

**戻り値：** `id`、名前、説明、アクティブステータス、パラメータ数を持つカスタム SQL ツールオブジェクトの配列。

***

#### list\_toolkit\_tools

ツールキット内に現在含まれているコネクションを一覧表示します。`get_toolkit_tool`、`set_tool_op_enabled` などの操作で必要な `tool_id` の値を確認するために使用します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。

**戻り値：** `id`、コネクション名、ソースタイプ、有効な操作を持つツールキットツールエントリの配列。

***

#### list\_toolkits

ユーザーが保存しているツールキットを一覧表示します。他のツールキット操作で必要な `toolkit_id` の値を確認するために使用します。

**パラメータ：** なし

**戻り値：** `id`、`name`、`isActive` ステータスを持つツールキットオブジェクトの配列。

***

#### rename\_toolkit

ツールキットの表示名を変更します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `name`（string、必須）—新しい表示名。

**戻り値：** 新しい名前を反映した更新後のツールキットオブジェクト。

***

#### set\_all\_tool\_ops\_enabled

ツールキット内のコネクションについて、ある種類のすべての操作を一括で有効化または無効化します。単一の操作を切り替える場合は `set_tool_op_enabled` を使用します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `tool_id`（string、必須）—`list_toolkit_tools` から取得したツールキットツールの `id`。
* `kind`（string、必須）—組み込みの SQL 操作の場合は `"universal"`、ドライバー固有の操作の場合は `"source"`。
* `enabled`（Boolean、必須）—その種類のすべての操作を有効にするには `true`、無効にするには `false`。

**戻り値：** 新しい操作状態を反映した更新後のツールキットツールオブジェクト。

***

#### set\_custom\_tool\_active

ツールキット内の 1 つのカスタム SQL ツールをアクティブ化または非アクティブ化します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `custom_tool_id`（string、必須）—`list_custom_tools` から取得したカスタムツールの `id`。
* `active`（Boolean、必須）—アクティブ化するには `true`、非アクティブ化するには `false`。

**戻り値：** 新しいアクティブステータスを持つ更新後のカスタムツールオブジェクト。

***

#### set\_tool\_op\_enabled

ツールキット内の 1 つのコネクションで、単一の操作を有効化または無効化します。ある種類のすべての操作を一度に切り替える場合は `set_all_tool_ops_enabled` を使用します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `tool_id`（string、必須）—`list_toolkit_tools` から取得したツールキットツールの `id`。
* `kind`（string、必須）—組み込みの SQL 操作（例：`execute_select`）の場合は `"universal"`、ドライバー固有の操作（例：`get_issue`）の場合は `"source"`。各操作がどちらの種類に属するかを確認するには `get_toolkit_tool` を使用します。
* `op_name`（string、必須）—`get_toolkit_tool` に表示される操作名。
* `enabled`（Boolean、必須）—有効にするには `true`、無効にするには `false`。

**戻り値：** 更新後のツールキットツールオブジェクト。

***

#### set\_toolkit\_active

ツールキットをアクティブ化または非アクティブ化します。非アクティブ化するとツールキットは MCP クライアントから非表示になります（リクエストは 423 エラーを返します）が、削除はされません。ツールキットを完全に削除するには管理 UI を使用します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `active`（Boolean、必須）—アクティブ化するには `true`、非アクティブ化するには `false`。

**戻り値：** 新しい `isActive` ステータスを持つ更新後のツールキットオブジェクト。

***

#### update\_source\_tool\_instructions

ソースツールが呼び出されたときに LLM に提示される、ソース操作ごとの AI 指示を置き換えます。ソース操作のみが対象です。ユニバーサル操作には操作ごとの指示はありません。クリアするには空文字列を渡します。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `tool_id`（string、必須）—`list_toolkit_tools` から取得したツールキットツールの `id`。
* `source_op_name`（string、必須）—`get_toolkit_tool` に表示されるソース操作名（例：`"get_issue"`）。
* `instructions`（string、必須）—置き換える指示テキスト。クリアするには空文字列を渡します。

**戻り値：** 新しい指示を持つ更新後のツールキットツールオブジェクト。

***

#### update\_toolkit\_server\_instructions

ツールキットの自然言語によるサーバーインストラクションテキストを置き換えます。LLM はツールキットの MCP サーバーに最初に接続した際にこれらの指示を読み取ります。

**パラメータ**

* `toolkit_id`（string、必須）—`list_toolkits` から取得したツールキットの `id`。
* `server_instructions`（string、必須）—このツールキットに接続する MCP クライアントに提示される、自然言語のガードレール。

**戻り値：** 新しいサーバーインストラクションを持つ更新後のツールキットオブジェクト。

## おすすめのプロンプト

Management MCP を最大限活用するには、操作したいソースやコネクションを名指しした具体的なプロンプトを使用します。例：

* 「すべてのコネクションを一覧表示し、ソースタイプごとにグループ化してください。」
* 「今接続できるデータソースは何ですか？」
* 「Salesforce に接続するために必要なプロパティを表示してください。」
* 「*Sales Prod* という名前の Salesforce コネクションを OAuth で新規作成してください。」
* 「*Sales Prod* コネクションをテストして、何か問題が発生していないか教えてください。」
* 「*Sales Tools* という名前の新しいツールキットを作成し、Salesforce コネクションを追加して、MCP クライアントの接続用 URL を教えてください。」
* 「*Sales Tools* のサーバーインストラクションを『営業データへの読み取り専用アクセス。レコードは変更しないでください。』に設定してください。」
* 「*Sales Tools* ツールキットの内容をすべて表示してください。含まれるコネクションと有効な操作もあわせて教えてください。」