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

​
認証

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

​
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 ツールキットの内容をすべて表示してください。含まれるコネクションと有効な操作もあわせて教えてください。」