CData Connect AI を使って Roo Code からリアルタイムの Zuora データにアクセス

Anusha M B
Anusha M B
Technical Marketing Engineer
CData Connect AI のリモート MCP サーバーを活用して、Roo Code エージェントからセキュアにZuora のデータにアクセスし、MCP 連携でアプリケーションを構築できるようにします。

Roo Code は、VS Code 内で動作するオープンソースの AI コーディングエージェントです。ファイルシステムへのアクセス、ターミナル制御、マルチステップワークフローなどの機能を備えています。Code、Architect、Orchestrator といった専門モードを通じて、プロジェクトワークスペース全体にわたって作業できます。ローカル開発用の VS Code 拡張機能として利用できるほか、Slack や GitHub と連携する Cloud Agents としても提供されています。Roo Code は MCP をネイティブにサポートしており、STDIO や Streamable HTTP を介して外部ツールやデータソースに接続できます。

デフォルトでは、Roo Code からライブのエンタープライズデータにアクセスすることはできません。CData Connect AI は、350 を超えるデータソースを公開することでこのギャップを埋めます。接続すると、Roo Code は VS Code 内でリアルタイムのスキーマを参照し、クエリを検証し、実際のエンタープライズデータに基づいたコードを直接生成できるようになります。

ステップ 1:Roo Code 用の Zuora 接続を設定

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

  1. Connect AI にログインし、Sources をクリック、次に Add Connection をクリック
  2. Add Connection パネルから Zuora を選択
  3. 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 サービスを使用します。デフォルトでは、ZuoraServiceAQuADataExport に設定されています。

    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回再試行可能で、その後失敗として返されます。
  4. Save & Test をクリック
  5. Permissions タブに移動し、ユーザーベースのアクセス許可を設定

パーソナルアクセストークンの取得

パーソナルアクセストークン(PAT)は、Roo Code から Connect AI への接続を認証するために使用されます。きめ細かいアクセス制御を維持するため、統合ごとに個別の PAT を作成することをお勧めします。

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

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

ステップ 2:Roo Code で Connect AI を設定

CData Connect AI は、Roo Code の MCP 設定パネルで MCP サーバーを直接登録することで統合できます。登録が完了すると、Roo Code エージェントは追加設定なしで MCP ツールを通じてリアルタイムのZuora のデータを呼び出せるようになります。

方法 1:MCP を直接設定

CData Connect AI MCP サーバーを Roo Code の MCP 設定に直接登録できます。登録が完了すると、どのプロジェクトのエージェントからでも、追加設定なしで MCP ツールを通じてリアルタイムのZuora のデータをクエリできます。

  1. Roo Code 拡張機能がインストールされた VS Code を開く
  2. アクティビティバーの Roo Code アイコン をクリック
  3. Settings に移動し、Roo Code ペインで MCP Servers を選択して Enable MCP Servers をオンにします。次に Edit Global MCP をクリックして MCP 設定ファイルを開きます
  4. mcp_settings.json ファイルの mcpServers オブジェクト内に以下を追加します。base64encode の部分は、Base64 エンコードした email:PAT に置き換えてください
    {
        "mcpServers": {
            "cdata-mcp": {
                "type": "streamable-http",
                "url": "https://mcp.cloud.cdata.com/mcp",
                "headers": {
                    "Authorization": "Basic base64encode(USERNAME:PAT)"
                }
            }
        }
    }
            
  5. ファイルを保存して MCP サーバーを登録
  6. MCP Servers パネルに戻り、cdata-mcp がリストに表示され、トグルが有効になっていることを確認します。有効になっていない場合は、トグルをオンにしてください

CData MCP サーバーの登録と有効化が完了すると、Roo Code エージェントは、どのプロジェクトからでも Connect AI を通じてリアルタイムのZuora のデータをクエリ・操作できるようになります。

Roo Code からリアルタイムのZuora のデータをクエリ

MCP サーバーの設定が完了したら、Roo Code のチャットパネルで会話を開始して、リアルタイムのZuora のデータを操作してみましょう。

  1. Roo Code のチャットを開き、データを探索するプロンプトを入力します。例:
    • List all available catalogs in my cdata-mcp connection.
    • Show the schemas and tables available for Zuora.
    • Query the top 5 records from Zuora のデータ.
  2. エージェントが CData Connect AI MCP サーバーを呼び出し、Zuora のデータからリアルタイムの結果を返します

方法 2:自然言語でアプリケーションを構築

自然言語プロンプトを使って、CData Connect AI MCP サーバーに接続するアプリケーションを Roo Code に構築させることもできます。エージェントが必要なエンドポイントや認証情報を対話的に収集し、リアルタイムのZuora のデータに接続する動作するアプリケーションを生成します。すべて VS Code 内の Roo Code チャットパネルから操作できます。

  1. VS Code で Roo Code パネルを開き、ドロップダウンから使用するモデルを選択
  2. 構築したいアプリケーションを記述するプロンプトを入力します。例:
    I would like to build a small application that connects to a remote MCP
    HTTPS server. I already have the MCP endpoint URL and the required
    credentials. The application should:
      - Establish a connection to the remote MCP server
      - Authenticate using the provided credentials
      - Retrieve and list all available catalogs from the MCP
    
    Please make sure the credentials are stored securely in a .env file
    and not hardcoded in the application.
            
  3. Roo Code が MCP エンドポイント URL と認証情報の入力を求めてきます。以下の値を入力してください:
    • MCP Endpoint URL: https://mcp.cloud.cdata.com/mcp
    • Authorization: Basic base64(email:PAT)
  4. Roo Code がプロジェクトディレクトリを作成し、Node.js プロジェクトを初期化、必要なパッケージをインストールし、認証情報を .env ファイルに安全に保存します

これで、Roo Code が VS Code 内の自然言語プロンプトひとつで、CData Connect AI MCP サーバーと通信しリアルタイムのZuora のデータを取得するアプリケーションを構築できました。

CData Connect AI の入手

350 を超える SaaS、ビッグデータ、NoSQL ソースに Roo Code から直接アクセスするには、CData Connect AI をお試しください。14 日間の無償トライアルをぜひご利用ください。ご不明な点がございましたら、サポートチームまでお気軽にお問い合わせください。

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

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

無料トライアル