Cline を使用して Visual Studio Code からリアルタイム SharePoint Excel Services のデータにアクセスする方法
Cline は IDE 上で動作する自律型コーディングエージェントです。ユーザーの許可を得ながら、ファイルの作成や編集、コマンドの実行、ブラウザの操作などを実行できます。CData MCP Server for SharePoint Excel Services と組み合わせることで、IDE から直接 CRM データにリアルタイムでアクセスでき、開発環境を離れることなくリアルタイムのスキーマとレコードを使用してデータ駆動型機能の構築、テスト、検証が行えます。
この記事では、CData MCP Server for SharePoint Excel Services を 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 SharePoint Excel Services がインストールされていること
ステップ 1: SharePoint Excel Services で認証(Windows 上)
WSL で MCP Server を実行する前に、Windows 環境で認証フローを完了する必要があります。これにより、必要な資格情報がすべて生成され、適切に保存されます。「CData MCP Server for SharePoint Excel Services」を見つけて実行するか、MCP Server JAR ファイルを実行して設定ウィザードを開きます。
java -jar "C:\Program Files\CData\CData MCP Server for SharePoint Excel Services 2024\lib\cdata.mcp.excelservices.jar"
SharePoint Excel Services への接続
ワークブックへの接続
どちらのSharePoint エディションをお使いでも、File を Excel ワークブックに設定してください。このパスは以下のプロパティからの相対パスになります。
- Library:デフォルトではShared Documents ライブラリが使用されます。このプロパティを使って、組織内の別のドキュメントライブラリを指定してみてください。例えば、OneDrive for Business に接続する場合は、このプロパティを"Documents" に設定します。
- Folder:このプロパティを使って、ライブラリ内のサブフォルダへのパスを指定できます。パスはLibrary で指定されたライブラリ名に関連します。
テーブルとしてのスプレッドシートデータへの接続
CData 製品では、基底API で利用可能なオブジェクトに基づいて、使用可能なテーブルを検出していきます。
API では異なるAPI オブジェクトを表示します。スプレッドシートの構成とSharePoint のバージョンに基づいてAPI を選択しましょう。
- OData: OData API を使用すると、Excel で[挿入]->[テーブル]をクリックして作成されたExcel テーブルオブジェクト(範囲やスプレッドシートではありません)から定義されたテーブルにアクセスできます。OData API に接続する際、ワークブックにテーブルオブジェクトが定義されていない場合は、CData 製品がテーブルを返さないことがあります。テーブルとしてスプレッドシートまたは範囲に接続するには、UseRESTAPI をtrue に設定してください。
- REST: REST API を使用すると、Excel テーブルオブジェクト、範囲、およびスプレッドシートから定義されたテーブルへアクセスできます。これがデフォルトの API です。範囲およびスプレッドシートから多数の行をリクエストすることは REST API によって制限されており、CData 製品では返される行数をデフォルトで 100 に制限しています。また CData 製品では、デフォルトで1行目からカラム名を検出します。これを無効にするには、Header を設定してください。
DefineTables を追加設定すると、Excel の範囲の構文を使用して、範囲に基づいてテーブルを定義できます。大きすぎる範囲は、API によって制限されます。
SharePoint オンプレミスへの接続
URL をサーバー名もしくはIP アドレスに設定しましょう。さらに、SharePointVersion と認証値を設定します。
SharePoint OnPremises を認証するには、AuthScheme を認証タイプに設定し、必要に応じてUser と Password を設定してください。
Note:SharePoint On-Premises 2010 に接続する場合は、 UseRESTAPI をtrue に設定する必要があります。
Windows(NTLM)
最も一般的な認証タイプです。CData 製品では NTLM をデフォルトとして使用するよう事前設定されています。Windows のUser と Password を設定して接続してください。
その他の認証方法については、ヘルプドキュメントの「はじめに」をご覧ください。
CData MCP Server の設定
MCP Server に名前を付け(例: cdataexcelservices)、必要な接続プロパティを入力して「Connect」をクリックします。
接続に成功すると、以下のディレクトリとファイルが作成されます:
C:\Users\<username>\AppData\Roaming\CData\excelservices Provider\ |-- cdataexcelservices.mcp |-- (その他のサポート設定ファイル)
ステップ 2: MCP Server 設定を WSL にコピー
次に、設定フォルダ全体を Windows から WSL 環境にコピーします。
mkdir -p ~/.config/CData/ cp -r /mnt/c/Users/<username>/AppData/Roaming/CData/"excelservices Provider" ~/.config/CData/
コピー先のパスが正確に ~/.config/CData/excelservices 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_excelservices/lib sudo cp /mnt/c/Program\ Files/CData/CData\ MCP\ Server\ for\ SharePoint Excel Services\ 2024/lib/cdata.mcp.excelservices.jar /opt/cdata/mcp_excelservices/lib/
ステップ 4: Cline の設定
次に、wsl コマンドを使用して WSL 内で MCP Server を起動するように Cline 拡張機能を設定します。
以下の内容で cline_mcp_settings.json を作成または更新します:
{
"mcpServers": {
"cdataexcelservices": {
"autoApprove": ["*"],
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "wsl",
"args": [
"-d",
"Ubuntu", // インストールされている WSL ディストリビューション名に置き換えてください
"--",
"/usr/bin/java",
"-jar",
"/opt/cdata/mcp_excelservices/lib/cdata.mcp.excelservices.jar",
"cdataexcelservices"
],
"env": {
"JAVA_TOOL_OPTIONS": "-Xmx2g"
}
}
}
}
注意: Ubuntu を実際の WSL ディストリビューション名(例: Ubuntu-22.04)に置き換えてください。PowerShell または CMD で wsl -l を実行して確認できます。
ステップ 5: Cline でリアルタイムデータを操作
Visual Studio Code 内から、Cline 拡張機能を通じて MCP コマンドを実行できるようになりました。
cdataexcelservices_get_tables cdataexcelservices_get_columns Account
正しく設定されていれば、これらのコマンドは利用可能な SharePoint Excel Services オブジェクトとメタデータのリストを返し、CRM スキーマをリアルタイムで操作できます。
以下のような自然言語プロンプトを試してみてください:
- 「新しい SharePoint Excel Services Lead を作成する React フォームを生成してください。」
- 「今四半期にクローズした Opportunities を取得する Python 関数を作成してください。」
AI とデータを今すぐ接続しましょう!
CData MCP Server を使用すると、LLM からリアルタイムのエンタープライズデータをこれまで以上に簡単に操作できます。この技術を実際に体験するには、30 日間の無料トライアルをダウンロードするか、CData コミュニティにアクセスして、洞察を共有したり、質問したり、エンタープライズ対応 AI の未来を一緒に形作りましょう。