MCP

Connect AI は、AI アプリケーションを外部システムに接続するためのオープンソース標準である Model Context Protocol (MCP) への接続をサポートしています。MCP は Anthropic によって開発され、構造化データと大規模言語モデル (LLM) の橋渡しをします。MCP は Claude、Microsoft Copilot Studio、n8n など、MCP をサポートする任意のクライアントインテグレーションから使用できます。AI インテグレーションの完全なリストについては、AI ツール を参照してください。

MCP をサポートされているクライアントツールから使用するには、Remote MCP Server URL field に次の URL を追加してください: https://mcp.cloud.cdata.com/mcp 。MCP サーバーに接続したら、データについて自然言語で質問できます。

Connect AI で MCP を初めて使用しますか？クイックスタートガイド では、公開されている サンプルファイルを使用して、エージェントの接続とクエリの実行を約5分で行う手順を説明しています。 ご自身の認証情報は必要ありません。

​

認証

MCP への認証はクライアントインテグレーションツールによって異なります。Connect AI は OAuth と基本認証の両方をサポートしています。基本認証には、Connect AI ユーザー ID と Connect AI の Personal Access Tokens ページで生成した PAT が必要です。

詳細については、認証 を参照してください。

​

MCP ツール

LLM はデータを返すためにデータリソースの使用に依存しています。Connect AI MCP サーバーは、自然言語の質問に応答してデータを提供するために以下のツールを使用します。

• getCatalogs — Connect AI から利用可能なコネクションの一覧を取得します。
• getSchemas — 特定のカタログの Connect AI からデータベーススキーマを取得します。スキーマはカタログ内のテーブルとストアドプロシージャを整理します。
• getTables — 特定のカタログとスキーマの Connect AI からデータベーステーブルを取得します。
• getColumns — 特定のカタログ、スキーマ、テーブルの Connect AI から利用可能なデータベースカラムの一覧を取得します。このリソースはテーブル構造とカラム定義を調べます。
• getInstructions — データソースのコネクタ固有のガイダンスとベストプラクティス（構文要件、データ型のマッピング、既知の制限事項を含む）を取得します。
• getProcedures — 特定のカタログとスキーマの Connect AI からストアドプロシージャを取得します。ストアドプロシージャにはスキーマ内で実行可能な SQL ロジックが含まれます。
• getProcedureParameters — 特定のカタログ、スキーマ、プロシージャのストアドプロシージャのパラメータメタデータを Connect AI から取得します。パラメータメタデータには、適切なプロシージャ実行に必要な名前、データ型、方向が含まれます。
• executeProcedure — 選択したカタログとスキーマのストアドプロシージャを実行します。
• queryData — 接続されたデータソースに対して SQL クエリを実行し、結果を取得します。
• execute_insert — テーブルに行を挿入します。queryData ツールは SELECT ステートメントのみを受け付けるため、書き込みにはこのツールを使用します。
• execute_update — テーブル内の既存の行を更新します。

queryData によるクエリでは、[Catalog].[Schema].[Table] の形式で完全修飾テーブル名を使用する必要があります。ハイフンなどの文字を含む名前には角括弧が必要です。結果は CSV 形式で返されます。

​

エージェントができることを制限する

サーバー URL に ops クエリパラメータを追加すると、サーバーが tools/list レスポンスで通知するツールを絞り込むことができます。このパラメータは絞り込み専用であり、サーバー側ですでに無効になっているツールを有効にすることはできません。

使用可能な値：

値	制御対象のツール
get_catalogs	getCatalogs
get_schemas	getSchemas
get_tables	getTables
get_columns	getColumns
get_instructions	getInstructions
get_procedures	getProcedures
get_procedure_parameters	getProcedureParameters
execute_procedure	executeProcedure
queryData	queryData（データの読み取り）
execute_insert	execute_insert（行の追加）
execute_update	execute_update（行の変更）
execute_sql	queryData の非推奨のエイリアス

エージェントに読み取り専用アクセスのみを許可するには、メタデータ操作と queryData を指定し、書き込みを行う3つを除外します：

https://mcp.cloud.cdata.com/mcp?ops=get_catalogs,get_schemas,get_tables,get_columns,get_instructions,queryData

この場合、サーバーは11個ではなく6個のツール（getCatalogs、getSchemas、getTables、getColumns、getInstructions、queryData）を通知します。

値が空、または認識されない場合、HTTP 400 と JSON-RPC エラーコード -32602 が返されます。エラーメッセージにはすべての使用可能な値が一覧表示されるため、入力ミスがあっても正しい値を確認できます。

エージェントを制限するために tools クエリパラメータを使用しないでください。universal、sql、source を受け付けますが、ツールリストを絞り込むことはできません。universal はすべてのツールを返し、sql と source は tools/list が -32601 Method not found で失敗する原因になります。代わりに ops を使用してください。

URL ではなくインターフェース上で管理する、永続的な名前付き制限が必要な場合は、Toolkits を使用してください。選択したテーブルと操作のみを公開できます。

​

サーバーの応答を確認する

MCP サーバーに到達可能であることを確認し、アカウントで利用可能なツールを一覧表示するには、tools/list リクエストを送信します。これはクライアントを設定する前でも機能するため、Connect AI 側の問題なのかクライアント設定の問題なのかを切り分けられます。Personal Access Tokens ページでパーソナルアクセストークンを作成し、次のコマンドを実行します：

curl -X POST https://mcp.cloud.cdata.com/mcp \
  -u "<YOUR_EMAIL>:<YOUR_PAT>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

レスポンスは、上記の各ツールのエントリを含む JSON-RPC の結果です。リクエストが認証エラーを返す場合は、Settings の Security タブでトークンが期限切れになっていないか確認してください。

​

おすすめのプロンプト

MCP インテグレーションツールを最大限に活用するには、具体的で詳細なプロンプトを使用してください。プロンプトが曖昧な場合、Microsoft Copilot Studio や Claude などのクライアントツールが取得したいデータを明確にするためのフォローアップの質問をする場合があります。具体的なプロンプトの例については、CData の プロンプトライブラリ を参照してください。