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

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

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

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

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

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

Bitbucket への接続

ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、Workspacesテーブルです。このテーブルはこのプロパティの設定を必要とせず、クエリを実行すると、Workspaceの設定に使用できるワークスペーススラッグのリストが提供されます。このテーブルにクエリを実行するには、スキーマを'Information'に設定し、SELECT * FROM Workspacesクエリを実行する必要があります。

Schemaを'Information'に設定すると、一般的な情報が表示されます。Bitbucketに接続するには、以下のパラメータを設定してください。

• Schema: ワークスペースのユーザー、リポジトリ、プロジェクトなどの一般的な情報を表示するには、これを'Information'に設定します。それ以外の場合は、クエリを実行するリポジトリまたはプロジェクトのスキーマに設定します。利用可能なスキーマの完全なセットを取得するには、sys_schemasテーブルにクエリを実行してください。
• Workspace: Workspacesテーブルにクエリを実行する場合を除き、必須です。Workspacesテーブルへのクエリにはこのプロパティは必要ありません。そのクエリはWorkspaceの設定に使用できるワークスペーススラッグのリストのみを返すためです。

Bitbucketでの認証

BitbucketはOAuth認証のみをサポートしています。すべてのOAuthフローからこの認証を有効にするには、カスタムOAuthアプリケーションを作成し、AuthSchemeをOAuthに設定する必要があります。

特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを必ず確認してください。

カスタムOAuthアプリケーションの作成

Bitbucketアカウントから、以下のステップを実行します。

1. 設定（歯車アイコン）に移動し、ワークスペース設定を選択します。
2. アプリと機能セクションで、OAuthコンシューマーを選択します。
3. コンシューマーを追加をクリックします。
4. カスタムアプリケーションの名前と説明を入力します。
5. コールバックURLを設定します。
   • デスクトップアプリケーションとヘッドレスマシンの場合、http://localhost:33333または任意のポート番号を使用します。ここで設定するURIがCallbackURLプロパティになります。
   • Webアプリケーションの場合、信頼できるリダイレクトURLにコールバックURLを設定します。このURLは、ユーザーがアプリケーションにアクセスが許可されたことを確認するトークンを持って戻るWebの場所です。
6. クライアント認証情報を使用して認証する予定の場合、これはプライベートコンシューマーですを選択する必要があります。ドライバーでは、AuthSchemeをclientに設定する必要があります。
7. OAuthアプリケーションに与える権限を選択します。これにより、読み取りおよび書き込みできるデータが決まります。
8. 新しいカスタムアプリケーションを保存するには、保存をクリックします。
9. アプリケーションが保存された後、それを選択して設定を表示できます。アプリケーションのKeyとSecretが表示されます。これらを将来の使用のために記録してください。Keyを使用してOAuthClientIdを設定し、Secretを使用してOAuthClientSecretを設定します。

CData MCP Server の設定

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

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

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

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

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

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

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

ステップ 4: Cline の設定

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

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

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

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

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

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

cdatabitbucket_get_tables
cdatabitbucket_get_columns Issues

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

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

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

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

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