CData Connect AI を使って Windsurf IDE からリアルタイム Bitbucket データにアクセス

Yazhini G
Yazhini G
Technical Marketing Engineer
CData Connect AI のリモート MCP サーバーを活用して、Windsurf の Cascade エージェントが IDE 内からセキュアにBitbucketのリアルタイムデータにアクセスし、クエリを実行できるようにします。

Windsurf は、プロジェクトのコンテキストを理解し、エディタ内で複雑なタスクを自律的に実行するコーディングエージェント Cascade を中心に設計された AI ネイティブ IDE です。Cascade は MCP（Model Context Protocol） をサポートしており、エージェントが開発環境から離れることなく外部ツールやデータソースを検出し、呼び出すことができます。

Windsurf を CData Connect AI の組み込み MCP サーバー と連携することで、Cascade エージェントはガバナンスの効いたリアルタイムBitbucket のデータに IDE 内からアクセスできるようになります。これにより、開発者は自然言語プロンプトを使って、Windsurf から直接カタログの一覧表示、スキーマの確認、Bitbucket のデータレコードのクエリが行えます。

この記事では、Connect AI での Bitbucket 接続の設定、必要な Personal Access Token の生成、Windsurf への Connect AI MCP Server の設定、そして Cascade チャットからリアルタイムBitbucket のデータをクエリして連携を確認する方法について説明します。

ステップ 1：Windsurf 用の Bitbucket 接続を設定

Windsurf から Bitbucket への接続は、CData Connect AI のリモート MCP サーバーによって実現されます。Windsurf からBitbucket のデータを操作するには、まず CData Connect AI で Bitbucket 接続を作成・設定します。

  1. Connect AI にログインし、Sources をクリック、次に Add Connection をクリック
    2. Connect AI で接続を追加
  2. Add Connection パネルから Bitbucket を選択
    3. データソースを選択
  3. 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を設定します。
    接続を設定（Salesforce の例）
  4. Save & Test をクリック
  5. Permissions タブに移動し、ユーザーベースの権限を更新
    6. 権限を更新

Personal Access Token を追加

Personal Access Token（PAT）は、Windsurf から Connect AI への接続を認証するために使用されます。きめ細かいアクセス制御を維持するため、連携ごとに個別の PAT を作成することをお勧めします。

  1. Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings を開く
  2. Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック
  3. PAT にわかりやすい名前を付けて Create をクリック
    4. 新しい PAT を作成
  4. Personal Access Token は作成時にのみ表示されるので、必ずコピーして安全な場所に保存してください

Bitbucket 接続の設定と PAT の生成が完了したら、Windsurf から Connect AI 経由でBitbucket のデータに接続できます。

ステップ 2：Windsurf で Connect AI MCP を設定

次に、Cascade エージェントが Connect AI を通じてリアルタイムデータツールを検出・呼び出せるよう、Windsurf に Connect AI リモート MCP サーバーを設定します。

  1. Windsurf IDE をダウンロードしてインストール
  2. Windsurf を開き、右上のプロフィールアイコンをクリックして Windsurf Settings を選択 プロフィールメニューから Windsurf Settings を開く
  3. Cascade セクションで MCP Servers を見つけ、Open MCP Registry をクリック Cascade 設定から MCP Registry を開く
  4. MCP Marketplace で右上の Add custom MCP をクリック カスタム MCP サーバーを追加
  5. この操作で mcp_config.json ファイルが開きます。以下の JSON を貼り付けてください： 
    {
    "mcpServers": {
        "cdata-mcp": {
            "serverUrl": "https://mcp.cloud.cdata.com/mcp",
            "headers": {
                "Authorization": "Basic your_base64_encoded_email_PAT",
                "Content-Type": "application/json"
            }
        }
    }
}

    注意：Windsurf は Connect AI に対して Basic 認証を使用します。Connect AI のユーザーメールアドレスと先ほど作成した PAT を email:PAT の形式で連結し、その文字列を Base64 エンコードして Basic を先頭に付けてください。例えば [email protected]:ABC123...XYZ789 の場合、Authorization ヘッダーの値は Basic dXNlckBkb21haW4uY29tOkFCQzEyMy4uLlhZWjc4OQ== のようになります。

    Connect AI MCP Server の設定を貼り付け
  6. mcp_config.json ファイルを保存し、MCP Registry に戻る
  7. Installed の下に cdata-mcp が表示され、Enabled とマークされていることを確認 cdata-mcp がインストールされ有効であることを確認

MCP サーバーの登録と有効化が完了したら、Windsurf から Connect AI を通じてリアルタイムのBitbucket のデータをクエリする準備が整いました。

ステップ 3：Windsurf からリアルタイムのBitbucket のデータをクエリ

連携が完了したら、Windsurf の Cascade チャットパネルを使って自然言語プロンプトでリアルタイムのBitbucket のデータを操作できます。

  1. Windsurf の上部バーで Editor から Agent に切り替えて新しい Cascade チャットを開く
  2. チャットパネルの下部で cdata-mcp サーバーが表示され、トグルが有効になっていることを確認 Cascade チャットで cdata-mcp サーバーを有効化
  3. 以下のようなプロンプトを入力してエージェントとのやり取りを開始：
    • cdata-mcp 接続内のすべてのカタログを一覧表示して
    • Bitbucket で利用可能なスキーマとテーブルを表示して
    • Bitbucket のデータ のテーブルからトップ 5 件のレコードをクエリして
  4. Cascade エージェントが Connect AI MCP Server を呼び出し、リアルタイムのBitbucket のデータを返します Windsurf の Cascade でリアルタイムデータをクエリ

これで、Windsurf IDE が Connect AI MCP Server と通信し、エディタから直接リモート MCP を通じてリアルタイムのBitbucket のデータを取得できるようになりました。

CData Connect AI を入手

数百種類の SaaS、ビッグデータ、NoSQL データソースに開発ツールから直接アクセスするには、CData Connect AI をお試しください！

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル

この記事の内容

関連記事