【MCP Server】Gumloop をZuora のデータと連携するフローを作る

加藤龍彦
デジタルマーケティング

CData Connect AI のリモートMCP サーバーを活用し、Gumloop から自動化ワークフロー内でZuora にセキュアにアクセスしてアクションを実行します。

Gumloop は、トリガー、AI ノード、API、データコネクタを組み合わせてAI を活用したワークフローを作成できるビジュアル自動化プラットフォームです。Gumloop と CData Connect AI を組み込みの「MCP (Model Context Protocol) Server」を通じて統合することで、ワークフローからライブのにシームレスにアクセスして対話できるようになります。

このプラットフォームはローコード環境を提供しているため、大規模な開発作業なしで複雑なプロセスを簡単にオーケストレーションできます。柔軟性が高く、複数のビジネスアプリケーション間での統合が可能で、ライブデータを使ったエンドツーエンドの自動化を実現します。

CData Connect AI は、Zuora のデータに接続するための専用クラウド間インターフェースを提供します。CData Connect AI Remote MCP Server により、Google ADK エージェントと Zuoraの間でセキュアな通信が可能になります。これにより、ネイティブ対応データベースへのデータレプリケーションを必要とせずに、エージェントから Zuora のデータの読み取りや操作を実行できます。CData Connect AIは最適化されたデータ処理機能を備えており、フィルタや JOIN を含むサポート対象のすべての SQL 操作を効率的に Zuoraへ直接送信します。サーバーサイド処理を活用することで、要求されたZuora のデータを迅速に取得できます。

この記事では、Connect AI での Zuora 接続の構成、Gumloop への MCP Serverの登録、そして Zuora をクエリするワークフローの構築に必要な手順をご紹介します。

ステップ 1: Gumloop 用のZuora 接続を構成する

それでは早速、Gumloop からZuora への接続を設定していきましょう。Gumloop から Zuora と対話するには、まず CData Connect AI で Zuora への接続を作成して構成します。

Connect AI にログインし、「Connections」をクリックして「 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回再試行可能で、その後失敗として返されます。
「Create & Test」をクリックします
「Add Zuora Connection」ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。

パーソナルアクセストークンを追加する

パーソナルアクセストークン (PAT) は、Gumloop からConnect AI への接続を認証するために使用します。アクセスの粒度を維持するために、サービスごとに個別の PAT を作成することをおすすめします。

Connect AI アプリの右上にある歯車アイコン () をクリックして、設定ページを開きます。
「Settings」ページで、「Access Tokens」セクションに移動し、「Create PAT」をクリックします。
PAT に名前を付けて「Create」をクリックします。
パーソナルアクセストークンは作成時にのみ表示されます。必ずコピーして、今後の使用のために安全に保管してください。

これで、Gumloop からZuora に接続する準備が整いました！

ステップ2：Gumloop でMCP Server に接続する

続いて、Connect AI の MCP Server エンドポイントと認証情報をGumloop の認証情報に追加します。

Gumloop のアカウントを作成して（アカウント未作成の場合）、サインインしましょう。
Gumloop Credentials のページにアクセスして、MCP Server を構成します。
「Add Credentials」をクリックし、「MCP Server」を検索して選択します

以下の詳細情報を入力します。
- URL: https://mcp.cloud.cdata.com/mcp
- Label: Zuora-mcp-server などのわかりやすい名前
- Access Token / API Key: 空白のままにします
- Additional Header: Authorization: Basic YOUR EMAIL:YOUR PAT
- 認証情報を保存します