Cline を使用して Visual Studio Code からリアルタイム JSON Servicesにアクセスする方法
Cline は IDE 上で動作する自律型コーディングエージェントです。ユーザーの許可を得ながら、ファイルの作成や編集、コマンドの実行、ブラウザの操作などを実行できます。CData MCP Server for JSON と組み合わせることで、IDE から直接 CRM データにリアルタイムでアクセスでき、開発環境を離れることなくリアルタイムのスキーマとレコードを使用してデータ駆動型機能の構築、テスト、検証が行えます。
この記事では、CData MCP Server for JSON を WSL(Windows Subsystem for Linux)で実行し、Windows 上の Visual Studio Code の Cline 拡張機能から接続する方法について説明します。
背景
CData MCP Server は通常、Claude Desktop などのクライアント向けに設計されています。しかし、Windows の VS Code で Cline 拡張機能を使用してサーバーに接続しようとすると、以下のエラーが発生しました:
MCP error -32000: Connection closed
この問題は、Cline 拡張機能の Windows 版における stdio トランスポート実装の I/O 処理に起因していると考えられます。
- 関連する GitHub Issue: https://github.com/cline/cline/issues/3464
- また、Java や Node などのプロセスを起動する際に、PATH などの環境変数が正しく継承されない場合があります。
前提条件
- Windows に Visual Studio Code がインストールされていること
- VS Code に Cline 拡張機能がインストールおよび設定されていること
- Windows Subsystem for Linux (WSL) がインストールされ、Linux ディストリビューション(Ubuntu など)が動作していること
- WSL に Java 21 以上の JRE がインストールされていること
- Windows に CData MCP Server for JSON がインストールされていること
ステップ 1: JSON で認証(Windows 上)
WSL で MCP Server を実行する前に、Windows 環境で認証フローを完了する必要があります。これにより、必要な資格情報がすべて生成され、適切に保存されます。「CData MCP Server for JSON」を見つけて実行するか、MCP Server JAR ファイルを実行して設定ウィザードを開きます。
java -jar "C:\Program Files\CData\CData MCP Server for JSON 2024\lib\cdata.mcp.json.jar"
JSON への接続
データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。CData 製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー(ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー)としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。
URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。
DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。
- Document(デフォルト):JSON データのトップレベルのドキュメントビューをモデル化します。CData 製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
- FlattenedDocuments:ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
- Relational:階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。
リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。
Amazon S3 内のJSON への接続
URI をバケット内のJSON ドキュメントに設定します。さらに、次のプロパティを設定して認証します。
- AWSAccessKey:AWS アクセスキー(username)に設定。
- AWSSecretKey:AWS シークレットキーに設定。
Box 内のJSON への接続
URI をJSON ファイルへのパスに設定します。Box へ認証するには、OAuth 認証標準を使います。 認証方法については、Box への接続 を参照してください。
Dropbox 内のJSON への接続
URI をJSON ファイルへのパスに設定します。Dropbox へ認証するには、OAuth 認証標準を使います。 認証方法については、Dropbox への接続 を参照してください。ユーザーアカウントまたはサービスアカウントで認証できます。ユーザーアカウントフローでは、以下の接続文字列で示すように、ユーザー資格情報の接続プロパティを設定する必要はありません。 URI=dropbox://folder1/file.json; InitiateOAuth=GETANDREFRESH; OAuthClientId=oauthclientid1; OAuthClientSecret=oauthcliensecret1; CallbackUrl=http://localhost:12345;
SharePoint Online SOAP 内のJSON への接続
URI をJSON ファイルを含むドキュメントライブラリに設定します。認証するには、User、Password、およびStorageBaseURL を設定します。
SharePoint Online REST 内のJSON への接続
URI をJSON ファイルを含むドキュメントライブラリに設定します。StorageBaseURL は任意です。指定しない場合、ドライバーはルートドライブで動作します。 認証するには、OAuth 認証標準を使用します。
FTP 内のJSON への接続
URI をJSON ファイルへのパスが付いたサーバーのアドレスに設定します。認証するには、User およびPassword を設定します。
Google Drive 内のJSON への接続
デスクトップアプリケーションからのGoogle への認証には、InitiateOAuth をGETANDREFRESH に設定して、接続してください。詳細はドキュメントの「Google Drive への接続」を参照してください。
CData MCP Server の設定
MCP Server に名前を付け(例: cdatajson)、必要な接続プロパティを入力して「Connect」をクリックします。
接続に成功すると、以下のディレクトリとファイルが作成されます:
C:\Users\<username>\AppData\Roaming\CData\json Provider\ |-- cdatajson.mcp |-- (その他のサポート設定ファイル)
ステップ 2: MCP Server 設定を WSL にコピー
次に、設定フォルダ全体を Windows から WSL 環境にコピーします。
mkdir -p ~/.config/CData/ cp -r /mnt/c/Users/<username>/AppData/Roaming/CData/"json Provider" ~/.config/CData/
コピー先のパスが正確に ~/.config/CData/json Provider/ と一致していることを確認してください。
ステップ 3: WSL に MCP Server をインストール
Java をインストールし、MCP Server JAR を WSL 内の目的の場所に配置します:
sudo apt update sudo apt install openjdk-21-jre-headless sudo mkdir -p /opt/cdata/mcp_json/lib sudo cp /mnt/c/Program\ Files/CData/CData\ MCP\ Server\ for\ JSON\ 2024/lib/cdata.mcp.json.jar /opt/cdata/mcp_json/lib/
ステップ 4: Cline の設定
次に、wsl コマンドを使用して WSL 内で MCP Server を起動するように Cline 拡張機能を設定します。
以下の内容で cline_mcp_settings.json を作成または更新します:
{
"mcpServers": {
"cdatajson": {
"autoApprove": ["*"],
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "wsl",
"args": [
"-d",
"Ubuntu", // インストールされている WSL ディストリビューション名に置き換えてください
"--",
"/usr/bin/java",
"-jar",
"/opt/cdata/mcp_json/lib/cdata.mcp.json.jar",
"cdatajson"
],
"env": {
"JAVA_TOOL_OPTIONS": "-Xmx2g"
}
}
}
}
注意: Ubuntu を実際の WSL ディストリビューション名(例: Ubuntu-22.04)に置き換えてください。PowerShell または CMD で wsl -l を実行して確認できます。
ステップ 5: Cline でリアルタイムデータを操作
Visual Studio Code 内から、Cline 拡張機能を通じて MCP コマンドを実行できるようになりました。
cdatajson_get_tables cdatajson_get_columns people
正しく設定されていれば、これらのコマンドは利用可能な JSON オブジェクトとメタデータのリストを返し、CRM スキーマをリアルタイムで操作できます。
以下のような自然言語プロンプトを試してみてください:
- 「新しい JSON Lead を作成する React フォームを生成してください。」
- 「今四半期にクローズした Opportunities を取得する Python 関数を作成してください。」
AI とデータを今すぐ接続しましょう!
CData MCP Server を使用すると、LLM からリアルタイムのエンタープライズデータをこれまで以上に簡単に操作できます。この技術を実際に体験するには、30 日間の無料トライアルをダウンロードするか、CData コミュニティにアクセスして、洞察を共有したり、質問したり、エンタープライズ対応 AI の未来を一緒に形作りましょう。