Google Antigravity エージェントと CData Connect AI を連携してリアルタイム NetSuite データにアクセス
Antigravity は、自律型および半自律型エージェント向けに設計された AI ネイティブ開発環境です。開発者はエディター内で直接エージェント駆動のワークフローを実行でき、計画、実行、ツール使用を単一のインターフェースで組み合わせることができます。
Antigravity と CData Connect AI を組み込みの MCP(Model Context Protocol)Server 経由で連携させることで、エージェントはリアルタイムの NetSuite のデータ に対して、ガバナンスを維持しながらリアルタイムでアクセスできるようになります。これにより、Antigravity エージェントは手動でのデータ移行やカスタム API の配線なしで、スキーマの探索、データのクエリ、アクションの実行を行えます。
この記事では、Connect AI での NetSuite 接続の設定、必要なアクセストークンの生成、Antigravity での CData MCP Server の登録、そしてエージェント駆動のワークフローからリアルタイムの NetSuite のデータ にクエリを実行して連携を検証するまでの手順を説明します。
NetSuite データ連携について
CData は、Oracle NetSuite のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- Standard、CRM、OneWorld を含む、すべてのエディションの NetSuite にアクセスできます。
- SuiteTalk API(SOAP ベース)のすべてのバージョンと、SQL のように機能し、より簡単なデータクエリと操作を可能にする SuiteQL に接続できます。
- Saved Searches のサポートにより、事前定義されたレポートとカスタムレポートにアクセスできます。
- トークンベースおよび OAuth 2.0 で安全に認証でき、あらゆるユースケースで互換性とセキュリティを確保します。
- SQL ストアドプロシージャを使用して、ファイルのアップロード・ダウンロード、レコードや関連付けのアタッチ・デタッチ、ロールの取得、追加のテーブルやカラム情報の取得、ジョブ結果の取得などの機能的なアクションを実行できます。
お客様は、Power BI や Excel などのお気に入りの分析ツールからライブ NetSuite データにアクセスするために CData ソリューションを使用しています。また、CData Sync を直接使用するか、Azure Data Factory などの他のアプリケーションとの CData の互換性を活用して、NetSuite データを包括的なデータベースやデータウェアハウスに統合しています。CData は、Oracle NetSuite のお客様が NetSuite からデータを取得し、NetSuite にデータをプッシュするアプリを簡単に作成できるよう支援し、他のソースからのデータを NetSuite と統合することを可能にしています。
当社の Oracle NetSuite ソリューションの詳細については、ブログをご覧ください:Drivers in Focus Part 2: Replicating and Consolidating ... NetSuite Accounting Data
はじめに
Step 1: Antigravity 向けに NetSuite の接続を設定
Antigravity から NetSuite への接続は、CData Connect AI の Remote MCP Server によって実現されます。Antigravity から NetSuite のデータ を操作するには、まず CData Connect AI で NetSuite 接続を作成・設定します。
- Connect AI にログインし、Sources をクリックしてから Add Connection をクリックします。
- Add Connection パネルから NetSuite を選択します。
-
NetSuite への接続に必要な認証プロパティを入力します。
NetSuiteへの接続
NetSuite では、2種類のAPI でデータにアクセスできます。どちらのAPI を使用するかは、Schema 接続プロパティで以下のいずれかを選択して指定してください。
- SuiteTalk は、NetSuite との通信に使用されるSOAP ベースの従来から提供されているサービスです。幅広いエンティティをサポートし、INSERT / UPDATE / DELETE の操作も対応しています。ただし、SuiteQL API と比べるとデータの取得速度が劣ります。また、サーバーサイドでのJOIN に対応していないため、これらの処理はCData 製品がクライアントサイドで実行します。
- SuiteQL は、より新しいAPI です。JOIN、GROUP BY、集計、カラムフィルタリングをサーバーサイドで処理できるため、SuiteTalk よりもはるかに高速にデータを取得できます。ただし、NetSuite データへのアクセスは読み取り専用となります。
データの取得のみが目的でしたらSuiteQL をお勧めします。データの取得と変更の両方が必要な場合は、SuiteTalk をお選びください。
NetSuite への認証
CData 製品では、以下の認証方式がご利用いただけます。
- トークンベース認証(TBA)はOAuth1.0に似た仕組みです。2020.2以降のSuiteTalk とSuiteQL の両方で利用できます。
- OAuth 2.0 認証(OAuth 2.0 認可コードグラントフロー)は、SuiteQL でのみご利用いただけます。
- OAuth JWT 認証は、OAuth2.0 クライアント認証フローの一つで、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。
トークンベース認証(OAuth1.0)
トークンベース認証(TBA)は、基本的にOAuth 1.0 の仕組みです。この認証方式はSuiteTalk とSuiteQL の両方でサポートされています。管理者権限をお持ちの方がNetSuite UI 内でOAuthClientId、OAuthClientSecret、OAuthAccessToken、OAuthAccessTokenSecret を直接作成することで設定できます。 NetSuite UI でのトークン作成手順については、ヘルプドキュメントの「はじめに」セクションをご参照ください。
アクセストークンを作成したら、以下の接続プロパティを設定して接続してみましょう。
- AuthScheme = Token
- AccountId = 接続先のアカウント
- OAuthClientId = アプリケーション作成時に表示されるコンシューマーキー
- OAuthClientSecret = アプリケーション作成時に表示されるコンシューマーシークレット
- OAuthAccessToken = アクセストークン作成時のトークンID
- OAuthAccessTokenSecret = アクセストークン作成時のトークンシークレット
その他の認証方法については、ヘルプドキュメントの「はじめに」をご確認ください。
- Save & Test をクリックします。
- Permissions タブに移動し、ユーザーベースの権限を更新します。
Personal Access Token の追加
Personal Access Token(PAT)は、Antigravity から Connect AI への接続を認証するために使用されます。アクセス制御を細かく管理するために、連携ごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして Settings を開きます。
- Settings ページで Access Tokens セクションに移動し、 Create PAT をクリックします。
- PAT にわかりやすい名前を付けて Create をクリックします。
- トークンが表示されたらコピーして安全に保管してください。再度表示されることはありません。
NetSuite 接続の設定と PAT の生成が完了したら、CData MCP Server 経由で Antigravity から NetSuite のデータ に接続する準備が整いました。
Step 2: Antigravity で CData MCP Server を設定
次に、Antigravity で CData MCP Server を登録します。Antigravity は Raw 設定ファイルから MCP サーバーの定義を読み込み、エージェントが Connect AI によって公開されるソースを動的に検出して呼び出せるようにします。
- Antigravity デスクトップアプリケーションをダウンロードし、Google アカウントでサインインします。
-
初期セットアップの画面で、プロンプトが表示されたら Agent-driven development を選択します。このモードにより、ツール実行機能を持つ自律エージェントが有効になります。
- Antigravity のセットアップが完了し IDE が開いたら、組み込みのエージェントインターフェースから MCP サーバーを管理できます。上部メニューから Toggle Agent をクリックするか、Ctrl + Alt + B を押してエージェントパネルを開きます。
-
エージェントパネルが開いたら、「...」をクリックしてドロップダウンから MCP Servers を選択します。
-
MCP Store から Manage MCP Servers を選択し、View raw config をクリックして MCP 設定ファイルを開きます。
-
以下の JSON をファイルに貼り付けます。
{ "mcpServers": { "cdata-mcp": { "serverUrl": "https://mcp.cloud.cdata.com/mcp", "headers": { "Authorization": "Basic your_base64_encoded_email_PAT", "Content-Type": "application/json" } } } }注意:Antigravity は Connect AI との認証に Basic 認証を使用します。Connect AI ユーザーのメールアドレスと先ほど作成した PAT を組み合わせて Base64 エンコードします。たとえば、ユーザー名と PAT が [email protected]:ABC123...XYZ789 の場合、Authorization ヘッダーの値は次のようになります:Basic dXNlckBteWRvbWFpbjphSzkvbVB4Mi9Rcjd2TjQvTHc4Qi96WTZqQzMvRnQ1SGcxL0RzMFVlL01iWHdKdg==
- 設定ファイルを保存します。
-
Manage MCP Servers ビューに戻り、Refresh をクリックして新しい MCP サーバーを読み込みます。
Step 3: Antigravity エージェントからリアルタイムの NetSuite のデータ にクエリ
MCP サーバーが登録されると、Antigravity エージェントは Connect AI によって公開されるリアルタイムのデータソースと対話し、スキーマの探索やクエリの実行が可能になります。
- Toggle Agent を使用して再度エージェントパネルを開きます。
- エージェントチャットで新しい会話を開始します。
-
以下のようなプロンプトを入力してエージェントと対話を開始します。
- List all catalogs in my cdata-mcp connection.
- Show schemas and tables available for NetSuite.
- Query the top 3 records from a table in NetSuite のデータ.
これで、Antigravity エージェントは CData Connect AI MCP Server と通信し、リモート MCP ツールを通じてリアルタイムの NetSuite のデータ を取得できるようになりました。
CData Connect AI の詳細
300 以上の SaaS、ビッグデータ、NoSQL ソースにクラウドアプリケーションから直接アクセスするには、CData Connect AI をぜひお試しください。