CData Sync V26.4 新機能:リモート MCP サーバーで AI クライアントから Sync の状態を調べる

カバー画像

CData Sync v26.4 では、Sync 本体にリモート MCP サーバーが組み込まれました。Claude Desktop などの AI クライアントを実行中の Sync に接続すると、ジョブ、接続、ログ、ヘルス状態を自然言語で聞けます。

この記事では、使えるツールと認証トークンの用意、Claude Desktop での接続設定、質問の例、使うときの注意点を順に紹介します。

MCP とは

MCP(Model Context Protocol)は、AI クライアントが外部のシステムやデータとやり取りするための共通の規格です。規格が共通なので、MCP に対応した AI クライアントなら、同じ方法でさまざまなシステムにつなげます。

MCP の接続先になる側を、MCP サーバーと呼びます。MCP サーバーは、そのシステムでできることを「ツール」として公開します。AI クライアントは、ユーザーの質問に応じて必要なツールを選んで呼び出し、返ってきた情報をもとに回答します。

Sync v26.4 のリモート MCP サーバーは、この規格に沿って、Sync のジョブや接続、ログなどの情報を参照するツールを公開するものです。「リモート」とあるとおり、AI クライアントは Sync のエンドポイントに、ネットワーク越しに接続することができます。

全体構成

AI クライアントは、エンドポイントに認証トークンを付けて接続します。
接続後は、ユーザーの質問に応じて AI クライアントが必要なツールを呼び出し、Sync から返された情報をもとに回答します。

リモート MCP サーバーの概要

リモート MCP サーバーは Sync に組み込まれており、管理コンソールで設定する必要はありません。接続できる AI クライアントには、Claude Desktop、GitHub Copilot CLI、OpenAI Codex のほか、MCP に対応した各種クライアントがあります。

項目

内容

エンドポイント

https://<BaseURL>:<Port>/mcp.rsc

認証

有効なユーザーの認証トークンを x-cdata-authtoken ヘッダーで指定

公開ツール

読み取り専用のツール 10 個

利用可能なツール

公開されているツールは、次の 10 個です。

ツール

内容

find_workspaces

アクセス可能なワークスペースの一覧、または 1 つのワークスペースの詳細(接続、ジョブ、変換、パイプラインの概要を含む)

find_connections

接続の一覧、または 1 つの接続の完全な構成とランタイムステータス。シークレットフィールドはマスクされる

find_jobs

ジョブの一覧、または 1 つのジョブのタスクリスト(実行順)と現在の実行ステータス

find_transformations

変換の一覧、または 1 つの変換の構成、トリガー設定、タスクリスト

find_pipelines

パイプラインの一覧、または 1 つのパイプラインのステップ、イベント、参照されているジョブと変換。スクリプトの内容は秘匿化される

find_connection_logs

接続のログファイルの概要一覧、または 1 つのログファイルを分割してダウンロード

find_job_logs

ジョブの実行履歴、または 1 回の実行の詳細(タスクの結果やロググループ)。ログファイルを分割してダウンロードできる

find_transformation_logs

変換の実行履歴、またはタスクごとの結果とともに 1 回の実行を確認。ログファイルを分割してダウンロードできる

find_pipeline_logs

パイプラインの実行履歴、またはステップごとの結果とともに 1 回の実行の詳細を確認。ログファイルを分割してダウンロードできる

check_health

Sync アプリケーションと、呼び出し元のユーザーがアクセスできるすべてのリソースの統合ヘルススナップショット

接続の設定

認証トークンを準備する

リモート MCP サーバーへの接続には、有効なユーザーの API 認証トークンが必要です。認証トークンは、Sync の管理コンソールで確認できます。

ユーザーを追加する場合は、「システム設定」>「ユーザー」を開き、自身のユーザーををクリックします。ダイアログの「オプション」で「API 接続」チェックボックスをオンにすると、認証トークンが入った「認証トークン」テキストボックスが表示されます。

取得したトークンは、MCP 接続の x-cdata-authtoken ヘッダーに指定します。トークンの持ち主であるユーザーの権限で動作するため、扱いには注意してください。

以降の設定例では、<BaseURL>、<Port>、<Your-Auth-Token> を環境に合わせて置き換えてください。

AI クライアントを接続する

この記事では、Claude Desktop を例に設定を説明します。GitHub Copilot CLI や OpenAI Codex など、ほかの AI クライアントの設定は、Sync のドキュメントのリモートMCP サーバーのページを参照してください。

Claude Desktop は stdio で通信するため、HTTP のエンドポイントへ直接接続できません。
そこで、mcp-remote という npm パッケージをローカルの stdio プロセスとして使い、橋渡しをします。このため、Node.js が必要です。 Node.js が未インストールの場合は、Node.js の公式サイトなどから予めインストールしてください。

設定ファイル (claude_desktop_config.json)は、Claude Desktop の「設定」>「開発者」>「設定を編集」から開くことができます。

Windows の場合は、次の内容を記述します。

{
  "mcpServers": {
    "sync-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-remote",
        "https://<BaseURL>:<Port>/mcp.rsc",
        "--transport", "http-only",
        "--header", "x-cdata-authtoken:<Your-Auth-Token>"]
    }
  }
}

macOS と Linux の場合は、"command": "cmd" を "command": "npx" に置き換え、args から "/c" と "npx" を削除します。

{
  "mcpServers": {
    "sync-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
        "https://<BaseURL>:<Port>/mcp.rsc",
        "--transport", "http-only",
        "--header", "x-cdata-authtoken:<Your-Auth-Token>"]
    }
  }
}

設定後は Claude Desktop を再起動します。新しいチャットを開き、ツールのメニューで sync-mcp を有効にしてください。

ヘルスチェックと原因調査を頼んでみる

接続できたら、AI クライアントに Sync のヘルスチェックや、失敗したジョブの原因調査を頼んでみましょう。Sync の状態確認と失敗時の原因調査を AI クライアントに任せて、トラブルシュートに使えます。

ヘルスチェック

まず、「Sync インスタンス正常に動いてるか確認して」と頼みます。

初回は、ツールの実行に Claude Desktop 側の承認が求められます。「今回のみ許可」と「常に許可」のどちらかを選ぶと実行され、「拒否」を選ぶと実行されません。

承認すると、check_health が呼び出され、Sync 全体の状況が表でまとまって返ってきます。表には、アプリケーションエラーログ、ライセンス、接続、パイプライン、変換、ジョブの件数が並びます。失敗したジョブがある場合は、その一覧も示されます。

どのツールを呼び出すかは AI クライアントが判断します。多くのクライアントでは、どのツールが呼び出されたかが会話の中に表示されます。

失敗の原因調査

次に、失敗したジョブの原因を調べます。「「PostgreSQL-Snowflake」のジョブの失敗原因を調べて」と頼みます。

AI クライアントは、ジョブの実行結果とソースのログからエラーメッセージ(接続エラー)を拾い、接続設定と原因の見立てを説明してくれます。管理コンソールで一覧を見てログをダウンロードする、という行き来を減らせます。

セキュリティと運用上の注意

権限

リモート MCP サーバーは、Sync の既存の認証と認可に従って動作します。
ツールが返すのは、トークンの持ち主であるユーザーがアクセス権限を持つデータだけです。
AI クライアントに渡すトークンは、調べさせたい範囲に見合う権限を持つユーザーを使用してください。

機密値のマスク

パスワード、トークン、接続文字列などの機密値は、レスポンスではマスクされます。パイプラインイベント内のスクリプトも秘匿化されます。

AI の回答の扱い

AI の回答は、不完全または不正確な場合があります。診断や提案は出発点として扱い、重要な事項は Sync の管理コンソールで直接確認してください。

まとめ

Sync v26.4 では、読み取り専用のツールを通じて、AI クライアントから Sync の構成、実行履歴、ログを調べられるようになりました。

導入にあたっては、まず管理コンソールで認証トークンを取得し、普段使っている AI クライアントに設定してみてください。
最初は「Sync インスタンスのヘルスを確認して」のような簡単な質問から試し、日々の確認作業にどこまで使えるかを見るとよいでしょう。

ぜひ CData Sync V26.4 をお試しいただき、日々の Sync の運用にお役立てください。CData Sync の 30 日間無償トライアルはこちらからダウンロードいただけます。

また、使っていて気になった点やご不明な点があれば、お気軽にテクニカルサポートまでお問い合わせください。