Sourcegraph AmpからBitbucket にConnect AI経由で接続

Somya Sharma
Somya Sharma
Technical Marketing Engineer
Sourcegraph Amp と CData Connect AI を統合して、Bitbucket のデータ をリアルタイムでセキュアにクエリ・管理できます。

Sourcegraph Amp は、ステートフルな推論、自動コンテキスト管理、ネイティブ MCP(Model Context Protocol)統合を備えた、インテリジェントで本番環境対応のアシスタントを構築するための最新の AI エージェント環境です。CData Connect AI と組み合わせることで、Amp を活用してBitbucket のデータに自然言語または SQL ベースのクエリでリアルタイムにやりとりするエージェントを作成できます。

CData Connect AI は、Bitbucketを含む数百のデータソースをMCP経由でAIツールにつなげるクラウドサービスです。接続情報はConnect AI側で一元管理されるため、AmpにBitbucketの認証情報を直接渡すことなくセキュアに連携できます。

この記事では、Amp エージェントを設定して自然言語または SQL を使ってBitbucket のデータを会話的に探索する方法を説明します。Connect AI を使用すると、Bitbucket を含む数百のエンタープライズデータソースにセキュアかつリアルタイムにアクセスできるエージェントを簡単に構築できます。

前提条件

  1. アクティブな CData Connect AI アカウント
  2. Sourcegraph Amp VS Code 拡張機能または Amp CLI がインストールされていること
  3. Node.js v20 以上がインストールされていること
  4. Bitbucket へのアクセス

ステップ 1:Sourcegraph Amp 用に Bitbucket への接続を設定

Amp から Bitbucket への接続は CData Connect AI Remote MCP を介して行います。Amp でBitbucket のデータを操作するには、まず CData Connect AI で Bitbucket への接続を作成・設定します。

  1. Connect AI にログインして「Sources」をクリック、次に「 Add Connection」をクリック
  2. 接続の追加
  3. 接続を追加パネルから「Bitbucket」を選択
  4. データソースの選択
  5. 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 の例)
  6. 「Save & Test」をクリック

ステップ 2:CData Connect AI 用に Amp を設定

MCP エンドポイントをコピー

Amp はホストされた MCP エンドポイントを介して Connect AI と通信します。

https://mcp.cloud.cdata.com/mcp

このエンドポイントにより、Amp と Connect AI ワークスペース間のセキュアなクラウド間通信が可能になります。

Base64 資格情報を生成

Amp で Connect AI に認証するには、Base64 エンコードされた資格情報を生成します。例えば PowerShell では以下のようになります。


{Convert}::ToBase64String{(Text.Encoding)}::ASCII.GetBytes("[email protected]:yourPAT")

[email protected] を Connect AI のメールアドレスに、yourPAT を Personal Access Token に置き換えてください。

Amp に MCP Server を登録

Base64 文字列を取得したら、以下のコマンドで CData Connect AI MCP サーバーを Amp に登録します。


amp mcp add cdata-connect-ai -- npx -y mcp-remote@latest https://mcp.cloud.cdata.com/mcp --header "Authorization: Basic "

これにより Connect AI の設定が Amp の設定ファイルに追加され、CData Connect AI との通信が有効になります。

接続を確認してデータを探索

  1. 新しいスレッドを作成
  2. 新しい Amp セッションを開始してデータとのやりとりを始めます。

    amp thread new
    新しい Amp スレッドの開始

  3. インタラクティブチャットに入る
  4. 以下のコマンドで新しいスレッドに接続します:

    amp

    Amp でインタラクティブチャットを開く

  5. MCP サーバーを確認
  6. Amp シェル内で登録された MCP サーバーを確認します:

    list mcp

    MCP サーバーの一覧

  7. データソースを確認
  8. getCatalogs
    を実行して、接続されたBitbucket のデータがカタログとして表示されることを確認します。

    接続されたデータソースの確認

ステップ 3:ライブ Bitbucket データアクセスでインテリジェントエージェントを構築

Amp アプリケーションが設定され CData Connect AI に接続されたので、自然言語を使ってBitbucket のデータとやりとりする高度なエージェントを構築できます。MCP 統合により、エージェントに強力なデータアクセス機能が提供されます。

エージェントで利用可能な MCP ツール

Amp アプリケーションは以下の CData Connect AI MCP ツールにアクセスできます。

  • getCatalogs: すべてのデータソースカタログを一覧表示(例: Bitbucket1)
  • getSchemas: 接続されたカタログ内のデータベーススキーマを返却
  • getTables: 指定したスキーマで利用可能なすべてのテーブルとビューを一覧表示
  • getColumns: 特定のテーブルまたはビューのカラム定義を返却
  • queryData: SQL クエリ(SELECT、INSERT、UPDATE、DELETE)を実行
  • getProcedures: ストアドプロシージャまたは API エンドポイントを一覧表示
  • getProcedureParameters: ストアドプロシージャのパラメータメタデータを返却
  • executeProcedure: ストアドプロシージャを実行(例: Bitbucket アクション)

Amp の主な機能

Amp はインテリジェントでデータ対応の AI エージェント構築に最適な、本番環境対応の機能を提供します。

  • 自動コンテキスト管理: Amp は会話コンテキストを自動的に維持・呼び出し、手動での状態追跡なしにシームレスなマルチターンインタラクションを実現
  • ステートフルな会話: 複数のクエリにわたってコンテキストとメモリを保持し、自然で人間らしい会話を作成
  • ネイティブ MCP 統合: Amp は Model Context Protocol(MCP)をネイティブサポートし、CData Connect AI や他の MCP 対応サーバーからライブデータにセキュアかつリアルタイムにアクセス可能
  • ツール指向アーキテクチャ: ツールは管理された呼び出し、入力検証、エラー処理を備えたファーストクラスコンポーネントとして扱われる
  • 効率的なコンテキスト処理: Amp はプロンプトを動的に最適化し、モデルのトークン制限に近づいても関連情報を保持
  • クロスソースクエリ: 単一の会話ワークフロー内で複数の接続データソースを組み合わせてクエリ可能
  • きめ細かいアクセス許可制御: ツールアクセスレベルを定義・適用してデータガバナンスとセキュアな統合を維持
  • 開発者フレンドリーな CLI と SDK: Amp CLI または VS Code 拡張機能から MCP 接続の管理、エージェントの設定、ワークフローのテストを簡単に実行

使用例

CData Connect AI を通じたライブデータアクセスで Amp エージェントができることの例を紹介します。

  • データ分析エージェント:Bitbucket のデータのトレンドや異常を特定
  • レポート生成エージェント: 自然言語プロンプトからレポートを生成
  • インタラクティブチャットボット: ライブデータを使ってインサイトを会話形式で説明
  • データ品質エージェント: リアルタイムでデータの不整合を監視・フラグ付け
  • 自動化ワークフローエージェント: 定義されたデータ条件に基づいてアラートをトリガー

エージェントのテスト

エージェントが動作したら、自然言語クエリでやりとりできます。例えば:

  • 「過去 30 日間のすべての新規リードを表示して」
  • 「今四半期で最もパフォーマンスの高いキャンペーンは?」
  • 「売上の成長を分析して異常を特定して」
  • 「現在のオポチュニティのサマリーレポートを生成して」
  • 「ステータスが承認待ちのすべてのレコードを検索して」

CData Connect AI を入手

Amp エージェント環境から直接 数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを取得するには、CData Connect AI をお試しください。

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

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

無料トライアル