CData Connect AI を使用して Cline をZuora データと連携

Yazhini G
Technical Marketing Engineer

CData Connect AI のリモートMCP サーバーを活用し、IDE 内からCline でZuora のデータへのセキュアなアクセスとクエリを実現します。

Cline は、VS Code やCursor などの最新IDE 内で動作する自律型AI コーディングエージェントです。開発者は、構造化された実行モデルを使用してエディタ内から直接タスクを推論し、アクションを実行し、外部システムと対話するエージェント駆動型ワークフローを構築できます。

Cline を組み込みのMCP（Model Context Protocol）サーバーを通じてCData Connect AI と連携させることで、エージェントはZuora のデータをリアルタイムでクエリ、分析、操作できるようになります。この連携により、Cline のIDE 内エージェントフレームワークとCData Connect AI のガバナンスされたエンタープライズ接続が橋渡しされ、手動でのデータ移動なしに、すべてのデータアクセスが許可されたソースに対してセキュアに実行されます。

この記事では、Connect AI でZuora の接続を設定し、必要なパーソナルアクセストークンを生成し、Cline にConnect AI MCP サーバーを登録し、エージェントがIDE 内からZuora のデータと正常に対話できることを確認する手順を説明します。

ステップ1：Cline 用のZuora 接続を設定

Cline からZuora への接続は、CData Connect AI のリモートMCP サーバーを通じて実現されます。Cline からZuora のデータにアクセスするには、まずCData Connect AI でZuora 接続を作成して設定します。

Connect AI にログインし、Sources をクリックし、 Add Connection をクリックします

Add Connection パネルからZuora を選択します

Zuora に接続するために必要な認証プロパティを入力します。
Zuora はユーザー認証にOAuth 標準を使用しています。OAuth 認証ついて詳しくは、オンラインヘルプドキュメントを参照してください。

Tenant プロパティの設定
プロバイダへの有効な接続を作成するには、アカウントの設定と合致するテナント値を1つ選択する必要があります。以下は、利用可能なオプションのリストです。
- USProduction：リクエストはhttps://rest.zuora.com に送信されます。
- USAPISandbox：リクエストはhttps://rest.apisandbox.zuora.com に送信されます。
- USPerformanceTest：リクエストはhttps://rest.pt1.zuora.com に送信されます。
- EUProduction：リクエストはhttps://rest.eu.zuora.com に送信されます。
- EUSandbox：リクエストはhttps://rest.sandbox.eu.zuora.com に送信されます。
デフォルトではUSProduction テナントを使用します。
Zuora サービスの選択
データクエリとAQuA API の2つのZuora サービスを使用します。デフォルトでは、ZuoraService はAQuADataExport に設定されています。
DataQuery
データクエリ機能は、非同期の読み取り専用SQL クエリを実行することで、Zuora テナントからのデータのエクスポートを実現します。このサービスは、素早く軽量なSQL クエリでの使用を推奨します。
制限
- フィルタ適用後の、テーブルごとの入力レコードの最大数： 1,000,000
- 出力レコードの最大数： 100,000
- テナントごとの、実行用に送信される同時クエリの最大数： 5
- テナントごとの、同時クエリの制限に達した後に実行用に送信され、キューに追加されるクエリの最大数： 10
- 1時間単位での、各クエリの最大処理時間： 1
- GB 単位での、各クエリに割り当てられるメモリの最大サイズ： 2
- Index Join を使用する際のインデックスの最大値。言い換えれば、Index Join を使用する際にWHERE 句で使われる一意の値に基づいた、左のテーブルから返されるレコードの最大数： 20.000
AQuADataExport
AQuA API のエクスポートは、すべてのオブジェクト（テーブル）のすべてのレコードをエクスポートするように設計されています。AQuA のクエリジョブには以下の制限があります。
制限
- AQuA のジョブ内のクエリが8時間以上実行されている場合、ジョブは自動的に停止されます。
- 停止されたAQuA のジョブは3回再試行可能で、その後失敗として返されます。
Save & Test をクリックします
Permissions タブに移動し、ユーザーベースの権限を更新します

パーソナルアクセストークンの追加

パーソナルアクセストークン（PAT）は、Cline からConnect AI への接続を認証するために使用されます。きめ細かなアクセス制御を維持するため、連携ごとに個別のPAT を作成することがベストプラクティスです。

Connect AI アプリの右上にある歯車アイコン（）をクリックしてSettings を開きます
Settings ページでAccess Tokens セクションに移動し、 Create PAT をクリックします
PAT にわかりやすい名前を付けてCreate をクリックします

トークンが表示されたらコピーし、安全に保管してください。再度表示されることはありません

Zuora 接続の設定とPAT の生成が完了したので、Cline はCData Connect AI を通じてZuora のデータに接続できるようになりました。

ステップ2：Cline のインストールとセットアップ

Cline はIDE 拡張機能として配布されており、VS Code やCursor などの環境にインストールできます。この例ではCursor を使用しますが、手順はサポートされているIDE で同じです。

Cursor を開き、Extensions Marketplace からCline 拡張機能をインストールします
モデルの選択や権限プロンプトを含む、Cline の初期セットアップフローを完了します
セットアップが完了すると、Cline エージェントパネルがIDE 内に自動的に開きます

ステップ3：Connect AI リモートMCP サーバーの追加

Cline が実行されたら、エージェントがConnect AI を通じてZuora のデータにアクセスできるようにCData Connect AI リモートMCP サーバーを追加します。

Cline パネルでMCP Servers をクリックします
Remote Servers を開き、Edit Configuration をクリックします
JSON 設定ファイルが開きます。以下の設定を貼り付けます
```
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.cloud.cdata.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Basic your_email:your_PAT"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```
注：Cline はConnect AI でBasic 認証を使用します。Connect AI のユーザーメールアドレスと先ほど作成したPAT を組み合わせます。例えば、[email protected]:ABC123...XYZ789 のように、Authorization ヘッダーの値としてBasic [email protected]:ABC123...XYZ789 のように追加します。
ファイルを保存し、MCP Servers 画面に戻ってサーバーがリストに表示され有効になっていることを確認します

ステップ4：Cline からリアルタイムデータをクエリ

MCP サーバーが登録されると、Cline はConnect AI で公開されているリアルタイムデータソースと対話できるようになります。

Cline パネルのアイコンをクリックしてNew Task/Chat を開始します
チャットウィンドウの下部で、設定したMCP サーバーが選択されていることを確認します
以下のようなプロンプトを入力してエージェントと対話を開始します：
- List connections
- Show schemas for a catalog
- Query recent records from Zuora のデータ