CData Connect AI 経由で Theia IDE からリアルタイムでBitbucket のデータにクエリ

Yazhini G
Yazhini G
Technical Marketing Engineer
CData Connect AI のリモート MCP サーバーを活用して、Theia IDE の組み込み AI エージェントからBitbucket のデータにセキュアにアクセスし、開発環境内で直接クエリを実行できます。

Theia IDE は、柔軟で拡張性の高い開発環境を提供する、オープンソースのクラウド・デスクトップ対応 IDE プラットフォームです。組み込みの AI 機能は複数の LLM プロバイダーと MCP（Model Context Protocol）ツール連携をサポートしており、開発者は IDE 内のチャットベースのエージェントから直接、外部のライブデータソースとやり取りできます。

Theia IDE と CData Connect AI を組み込みの MCP サーバーを介して連携させると、Theia の AI エージェントがリアルタイムでBitbucket のデータにセキュアにアクセスできるようになります。エディタを離れることなく、カスタムの連携コードを書く必要もなく、カタログの一覧表示やスキーマの探索、Bitbucket のデータのレコードのクエリが可能です。

この記事では、Connect AI での Bitbucket 接続の設定、必要な Personal Access Token の生成、Theia IDE への CData Connect AI MCP サーバーの登録、LLM プロバイダーによる AI 機能の有効化、そして Theia AI Chat からリアルタイムでBitbucket のデータにクエリして連携を確認する方法を解説します。

ステップ 1：Theia IDE 用に Bitbucket への接続を設定

Theia IDE から Bitbucket への接続は、Connect AI のリモート MCP サーバーを介して実現します。Theia IDE からBitbucket のデータを操作するために、まずは Connect AI で Bitbucket への接続を作成・設定しましょう。

  1. Connect AI にログインし、Sources をクリック、次に Add Connection をクリック
    2. Connect AI で接続を追加
  2. 接続を追加パネルから 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 の追加

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

  1. Connect AI 画面の右上にある歯車アイコン（）をクリックして Settings を開きます
  2. Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック
  3. PAT にわかりやすい名前を入力し、Create をクリック
    4. 新しい PAT の作成
  4. 表示されたトークンをコピーして安全に保存してください。トークンは作成時にのみ表示されます

Bitbucket の接続設定と PAT の生成が完了しました。これで Theia IDE から Connect AI を通じてBitbucket のデータに接続する準備が整いました。

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

続いて、Theia IDE に CData Connect AI のリモート MCP サーバーを登録して、組み込みの AI エージェントが Connect AI を通じてライブデータツールを検出・呼び出せるようにしましょう。

  1. Theia IDE をダウンロードしてインストール
  2. Theia IDE を開き、Settings に移動（または Ctrl + , を押す）して Settings ビューを開きます
  3. Settings パネルで AI Features を展開し、MCP を選択 Theia の Settings から AI Features の MCP に移動
  4. Edit in settings.json をクリックして設定ファイルを開き、以下の JSON を貼り付けます： 
    {
    "ai-features.mcp.mcpServers": {
        "cdata": {
            "serverUrl": "https://mcp.cloud.cdata.com/mcp",
            "serverAuthToken": "Basic your_base64_encoded_email_PAT",
            "serverAuthTokenHeader": "Authorization"
        }
    }
}

    注意：Theia IDE は Connect AI への接続に Basic 認証を使用します。Connect AI のユーザーメールアドレスと、先ほど作成した PAT を email:PAT の形式で組み合わせ、Base64 エンコードした文字列の先頭に Basic を付けます。例えば、[email protected]:ABC123...XYZ789 の場合、serverAuthToken の値は Basic dXNlckBkb21haW4uY29tOkFCQzEyMy4uLlhZWjc4OQ== のようになります。

    settings.json に CData Connect AI MCP サーバーの設定を貼り付け
  5. settings.json ファイルを保存

AI の有効化と LLM プロバイダーの設定

Theia IDE でエージェントの推論を機能させるには、AI 機能を有効化し、少なくとも 1 つの LLM プロバイダーを設定する必要があります。

  1. Settings に戻り、AI Features から AI Enablement を選択
  2. Enable AI のチェックボックスをオンにして、Theia の AI 機能を有効化 Theia IDE の Settings で AI を有効化
  3. AI Features で、使用する LLM プロバイダー（Anthropic、OpenAI、Google、Hugging Face など）を選択し、API キーを入力

MCP サーバーの登録と LLM プロバイダーの設定が完了しました。これで Theia の AI エージェントが Connect AI を通じてリアルタイムでBitbucket のデータにクエリできるようになりました。

ステップ 3：Theia AI Chat からリアルタイムでBitbucket のデータにクエリ

連携の設定が完了したので、Theia AI Chat パネルからBitbucket のデータを操作してみましょう。

  1. Theia IDE の右側サイドバーから AI Chat パネルを開きます
  2. チャットの下部にある Toggle Capabilities Configuration アイコンをクリック（または Ctrl + Shift + . を押下）して Capabilities パネルを開きます
  3. Generic Capabilities から MCP を展開し、cdata サーバー（およびエージェントに公開したい特定のツール）にチェックを入れて、Connect AI のツールをエージェントから利用可能にします AI Chat で MCP の Capabilities を有効化
  4. チャット入力欄に @AppTester と入力し、続けてプロンプトを記述します。例えば：
    • cdata mcp のすべてのカタログを一覧表示して
    • Bitbucket の利用可能なスキーマとテーブルを表示して
    • Bitbucket のデータのテーブルから上位 5 件のレコードを取得して
  5. エージェントが Connect AI MCP サーバーを呼び出し、Bitbucket のデータからリアルタイムの結果を返します Theia AI Chat からリアルタイムデータをクエリ

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

CData Connect AI の入手

クラウドアプリケーションから 数百種類の SaaS、ビッグデータ、NoSQL ソースに直接アクセスするには、CData Connect AI をぜひお試しください。 14日間の無償トライアルをダウンロードして、今すぐお試しいただけます。ご不明な点がございましたら、サポートチーム までお気軽にお問い合わせください。

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

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

無料トライアル

この記事の内容

関連記事