【MCP Server】Gemini CLI からNetSuite のデータにリアルタイムで接続する方法

Gemini CLI は、Google のGemini AI モデルへのアクセスを提供するコマンドラインインターフェースツールです。コード生成、テキスト分析、会話型AI 機能を利用できます。コーディングで活用している方も多いのではないでしょうか。CData Connect AI と組み合わせることで、Gemini CLI をNetSuite とリアルタイムに連携できるようになります。この記事では、Connect AI を使用したNetSuite への接続方法と、NetSuite と対話するためのGemini CLI の構成手順をご紹介します。

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

はじめに

---

ステップ1: Gemini CLI 用の NetSuite 接続を構成

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

1. Connect AI にログインし、「Connections」をクリックして「 Add Connection」をクリックします
2. 「Add Connection」パネルから「NetSuite」を選択します
3. 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 = アクセストークン作成時のトークンシークレット

   その他の認証方法については、ヘルプドキュメントの「はじめに」をご確認ください。

   「Create & Test」をクリックします
4. 「Add NetSuite Connection」ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。

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

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

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

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

ステップ 2: CData Connect AI 用に Gemini CLI を構成

それでは、CData Connect AI に接続するための Gemini CLI を構成していきましょう。

1. システムに Gemini CLI がインストールされていることを確認します。インストールされていない場合は、npm を使用してインストールしましょう。

   npm install -g @google/gemini-cli

2. Gemini CLI の設定ファイルを見つけましょう。ファイルが存在しない場合は新規作成してください。
   • Linux/Unix/Mac: ~/.gemini/settings.json
   • Windows: %USERPROFILE%\.gemini\settings.json
3. 設定ファイルの「mcpServers」オブジェクトに CData Connect AI を追加します。YOUR_EMAIL とYOUR_PAT を、Connect AI のメールアドレスと先ほど作成したPAT に置き換えてください。

   {
     "mcpServers": {
       "cdata-connect-cloud": {
         "httpUrl": "https://mcp.cloud.cdata.com/mcp",
         "headers": {
           "Authorization": "Basic YOUR_EMAIL:YOUR_PAT"
         }
       }
     }
   }    
   

   例えば、メールアドレスが [email protected] で、PAT が Uu90pt5vEO... の場合、Authorization ヘッダーは次のようになります:

   "Authorization": "Basic [email protected]:Uu90pt5vEO..."

4. 設定ファイルを保存します。これで、Gemini CLI はデータ操作に CData Connect AI MCP Server を使用するようになります。

ステップ 3: 自然言語でライブの NetSuite のデータ をクエリする

Gemini CLI が構成され、CData Connect AI に接続されたので、自然言語クエリを使用して NetSuite と対話できるようになりました。MCP 統合により、質問をして NetSuite データソースからリアルタイムで応答を受け取ることができます。

Gemini CLI を使ってデータの探索を始めてみましょう:

1. ターミナルを開いて、Gemini CLI セッションを開始します:

   gemini

2. これで、自然言語を使って NetSuite をクエリできます。例えば:
   • 「過去 30 日間のすべての顧客を表示して」
   • 「最もパフォーマンスの良い製品は何ですか?」
   • 「第 4 四半期の売上トレンドを分析して」
   • 「すべてのアクティブなプロジェクトとその現在のステータスをリスト表示して」
3. Gemini CLI は、自然言語クエリを適切な SQL クエリに自動的に変換し、CData Connect AI MCP Server を通じて NetSuite データに対して実行します。

Gemini CLI の自然言語処理機能と CData Connect AI の堅牢なデータ接続機能を組み合わせることで、複雑な SQL クエリを記述したり、基礎となるデータ構造の深い技術知識を必要とすることなく、NetSuite を探索して分析できます。

CData Connect AI を入手する

クラウドアプリケーションから 300 以上の SaaS、ビッグデータ、NoSQL ソースへのライブデータアクセスを取得するには、今すぐ CData Connect AI をお試しください!