Cline を使用して Visual Studio Code からリアルタイム Zendesk のデータにアクセスする方法

Cline は IDE 上で動作する自律型コーディングエージェントです。ユーザーの許可を得ながら、ファイルの作成や編集、コマンドの実行、ブラウザの操作などを実行できます。CData MCP Server for Zendesk と組み合わせることで、IDE から直接 CRM データにリアルタイムでアクセスでき、開発環境を離れることなくリアルタイムのスキーマとレコードを使用してデータ駆動型機能の構築、テスト、検証が行えます。

この記事では、CData MCP Server for Zendesk を 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 Zendesk がインストールされていること

ステップ 1: Zendesk で認証（Windows 上）

WSL で MCP Server を実行する前に、Windows 環境で認証フローを完了する必要があります。これにより、必要な資格情報がすべて生成され、適切に保存されます。「CData MCP Server for Zendesk」を見つけて実行するか、MCP Server JAR ファイルを実行して設定ウィザードを開きます。

java -jar "C:\Program Files\CData\CData MCP Server for Zendesk 2024\lib\cdata.mcp.zendesk.jar"

Zendesk への接続

Zendesk 接続プロパティの取得・設定方法

Zendesk に接続するには、https://{subdomain}.zendesk.com の形式でURL（Zendesk Support URL）を設定します。接続後、次のセクションの説明に従ってユーザー認証を行います。

また、TicketMetrics テーブルのアーカイブデータを扱うユーザーは、UseIncrementalAPI プロパティをTrue に設定する必要があります。

Zendesk への認証

Zendesk は、Zendesk インスタンスの設定に応じて、3種類の認証をサポートします。API トークン認証、OAuth 認証、Basic 認証（レガシー）です。

API トークン認証

API トークン認証を使用する場合は、E メールアドレスとApiToken を指定します。 AuthScheme をAPIToken に、User をE メールアドレスに設定し、Zendesk Support の管理画面で以下の設定を行います。

1. Token アクセスを有効にします。
2. Admin -> Channels-> API で、API トークンを管理します。一度にアクティブにできるトークンは1つだけです。トークンを削除すると、そのトークンは永久に無効化されます。

その他の認証方法についてはヘルプドキュメントを参照してください。

CData MCP Server の設定

MCP Server に名前を付け（例: cdatazendesk）、必要な接続プロパティを入力して「Connect」をクリックします。

接続に成功すると、以下のディレクトリとファイルが作成されます：

C:\Users\<username>\AppData\Roaming\CData\zendesk Provider\
 |-- cdatazendesk.mcp
 |-- (その他のサポート設定ファイル)

ステップ 2: MCP Server 設定を WSL にコピー

次に、設定フォルダ全体を Windows から WSL 環境にコピーします。

mkdir -p ~/.config/CData/
cp -r /mnt/c/Users/<username>/AppData/Roaming/CData/"zendesk Provider" ~/.config/CData/

コピー先のパスが正確に ~/.config/CData/zendesk 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_zendesk/lib
sudo cp /mnt/c/Program\ Files/CData/CData\ MCP\ Server\ for\ Zendesk\ 2024/lib/cdata.mcp.zendesk.jar /opt/cdata/mcp_zendesk/lib/

ステップ 4: Cline の設定

次に、wsl コマンドを使用して WSL 内で MCP Server を起動するように Cline 拡張機能を設定します。

以下の内容で cline_mcp_settings.json を作成または更新します：

{
  "mcpServers": {
    "cdatazendesk": {
      "autoApprove": ["*"],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "wsl",
      "args": [
        "-d",
        "Ubuntu", // インストールされている WSL ディストリビューション名に置き換えてください
        "--",
        "/usr/bin/java",
        "-jar",
        "/opt/cdata/mcp_zendesk/lib/cdata.mcp.zendesk.jar",
        "cdatazendesk"
      ],
      "env": {
        "JAVA_TOOL_OPTIONS": "-Xmx2g"
      }
    }
  }
}

注意: Ubuntu を実際の WSL ディストリビューション名（例: Ubuntu-22.04）に置き換えてください。PowerShell または CMD で wsl -l を実行して確認できます。

ステップ 5: Cline でリアルタイムデータを操作

Visual Studio Code 内から、Cline 拡張機能を通じて MCP コマンドを実行できるようになりました。

cdatazendesk_get_tables
cdatazendesk_get_columns Tickets

正しく設定されていれば、これらのコマンドは利用可能な Zendesk オブジェクトとメタデータのリストを返し、CRM スキーマをリアルタイムで操作できます。

以下のような自然言語プロンプトを試してみてください：

• 「新しい Zendesk Lead を作成する React フォームを生成してください。」
• 「今四半期にクローズした Opportunities を取得する Python 関数を作成してください。」

AI とデータを今すぐ接続しましょう！

CData MCP Server を使用すると、LLM からリアルタイムのエンタープライズデータをこれまで以上に簡単に操作できます。この技術を実際に体験するには、30 日間の無料トライアルをダウンロードするか、CData コミュニティにアクセスして、洞察を共有したり、質問したり、エンタープライズ対応 AI の未来を一緒に形作りましょう。