Cursor で Zuora 対応アプリケーションを構築する方法 - CData Code Assist MCP

Cursor は、日々の開発ワークフローにエージェント型 AI を統合した AI 搭載コードエディタです。MCP をサポートしているため、エディタから直接ローカルツールやエンタープライズデータソースに接続でき、コンテキストを切り替えることなく自然言語でライブシステムとやり取りできます。

Model Context Protocol（MCP）は、LLM クライアントを構造化されたツールインターフェースを通じて外部サービスに接続するためのオープンスタンダードです。MCP サーバーはスキーマ検出やリアルタイムクエリなどの機能を公開し、AI エージェントがリアルタイムデータを安全かつ一貫した方法で取得・推論できるようにします。

この記事では、CData Code Assist MCP for Zuora のインストール、Zuora への接続設定、Code Assist MCP アドオンの Cursor への接続、そしてエディタ内からのリアルタイム Zuora のデータへのクエリ方法を順を追って解説します。

ステップ1：CData Code Assist MCP for Zuora のダウンロードとインストール

1. まず、CData Code Assist MCP for Zuora をダウンロードします。
2. ダウンロードしたインストーラーをダブルクリックして実行します。
3. 画面の指示に従ってインストールを完了させます。

インストールが完了したら、Zuora への接続設定に進みましょう。

ステップ2：Zuora への接続を設定

1. インストール完了後、CData Code Assist MCP for Zuora 設定ウィザードを開きます。

   注意：ウィザードが自動的に開かない場合は、Windows の検索バーで「CData Code Assist MCP for Zuora」を検索してアプリケーションを起動してください。

   
2. MCP Configuration > Configuration Name で、既存の構成を選択するか、 を選択して新しい構成を作成します。
3. 構成名を入力し（例：「cdata_zuora」）、OK をクリックします。

4. 設定ウィザードで適切な接続プロパティを入力します。

   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回再試行可能で、その後失敗として返されます。
   
5. Connect をクリックして、OAuth 経由で Zuora の認証を行います。
6. 次に、Save Configuration をクリックして Code Assist MCP アドオンの構成を保存します。

この操作により、Cursor が Code Assist MCP アドオンを起動する際に参照する .mcp 設定ファイルが作成されます。Code Assist MCP アドオンの設定が完了したら、Cursor に接続していきましょう。

ステップ3：Code Assist MCP アドオンを Cursor に接続

1. Cursor デスクトップアプリケーションをダウンロードし、アカウントのサインアップを完了します。
2. 上部メニューから Settings をクリックして設定パネルを開きます。
3. 左側のナビゲーションで Tools & MCP タブを開き、Add Custom MCP をクリックします。

オプション1：MCP 設定を手動で追加

1. Cursor がエディタ内に mcp.json ファイルを開きます。
2. 以下のコードを追加してファイルを保存します。

{
  "mcpServers": {
    "cdata-local": {
      "command": "C:/Program Files/Java/jdk-17/bin/java.exe",
      "args": [
        "-jar",
        "C:/Program Files/CData/CData Code Assist MCP for Zuora/lib/cdata.mcp.zuora.jar",
        "cdata_zuora"
      ]
    }
  }
}



注意：command の値は Java 17 以上の java.exe 実行ファイルのパスを、JAR パスはインストールされた CData Code Assist MCP アドオンの .jar ファイルのパスを指定してください。最後の引数は、CData 設定ウィザードで保存した MCP 構成名と一致させる必要があります（例：「cdata_zuora」）。

オプション2：CData Code Assist MCP for Zuora の UI から MCP 設定をコピー

1. 設定ウィザードで接続の保存とテストが完了したら、Next をクリックします。

2. AI MCP Tool ドロップダウンから Cursor を選択します。

3. MCP Client Instructions の手順に従って、MCP 設定に必要なフォルダを作成します。

4. 表示された JSON コードをコピーして、設定ファイルに貼り付けます。
5. Cursor で、mcp.json 設定を含むプロジェクトフォルダを開きます。
4. Code Assist MCP アドオンが、Installed MCP Servers の一覧に Running と表示されていれば設定完了です。

ステップ4：Cursor からリアルタイムの Zuora のデータにクエリ

1. 上部バーの Toggle AI Pane をクリックして、チャットウィンドウを開きます。
2. 自然言語を使って Zuora のデータについて質問してみましょう。例：

   "List all tables available in my Zuora のデータ connection."

   

これで Cursor と CData Code Assist MCP for Zuora の連携が完了しました。MCP ツールを活用して、スキーマの探索や Zuora に対するリアルタイムクエリを実行できます。

Code Assist MCP で構築。CData Drivers で本番運用。

Code Assist MCP を無料でダウンロードして、開発中にライブの Zuora のデータ へのスキーマ対応アクセスを AI ツールに提供しましょう。本番環境に移行する際は、CData Zuora Drivers が同じ SQL ベースのアクセスをエンタープライズグレードのパフォーマンス、セキュリティ、信頼性で提供します。

CData コミュニティにアクセスして、インサイトの共有や質問、MCP を活用した AI ワークフローの可能性を探索しましょう。