CData Connect AI 経由で LibreChat とリアルタイム NetSuite データを連携
LibreChat は、複数の LLM プロバイダー、エージェント、アシスタントを単一のインターフェースにまとめたオープンソースのセルフホスト型 AI チャットプラットフォームです。Model Context Protocol(MCP) にも対応しており、外部ツールやデータソースをチャットに直接接続し、既存のシステムからリアルタイムデータを取得できます。
LibreChat を組み込みの MCP Server 経由で CData Connect AI と連携することで、LibreChat はリアルタイムNetSuite のデータへの管理されたリアルタイムアクセスを取得できます。これにより、自然言語プロンプトを使用してNetSuite のデータのカタログ一覧表示、スキーマ探索、レコードのクエリが可能になり、すべてのデータアクセスは認可されたソースに対してセキュアに実行されます。
この記事では、Connect AI での NetSuite 接続設定、必要な Personal Access Token の生成、LibreChat のインストール、Connect AI MCP Server の登録、LLM プロバイダーの設定、そして LibreChat インターフェースからリアルタイム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
はじめに
ステップ 1:LibreChat 用に NetSuite への接続を設定
LibreChat から NetSuite に接続するには、Connect AI の Remote MCP Server を経由します。LibreChat からNetSuite のデータを操作するには、まず 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)は LibreChat から Connect AI への接続認証に使用します。アクセス制御の粒度を維持するために、連携ごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリ右上の歯車アイコン()をクリックして Settings を開く
- Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック
- PAT にわかりやすい名前を付けて Create をクリック
- 表示されたトークンをコピーして安全に保管してください。再表示されません
NetSuite のコネクションと PAT が設定できたので、LibreChat は Connect AI 経由でNetSuite のデータに接続する準備が整いました。
ステップ 2:LibreChat をインストールして Connect AI MCP を設定
次に LibreChat をローカルにインストールし、Connect AI Remote MCP Server を設定することで、チャットインターフェースが Connect AI 経由でリアルタイムデータツールを検出・呼び出せるようにします。
- 公式のインストールガイドに従って LibreChat をインストールします。npm セットアップを使用する場合は、MongoDB と MeiliSearch がローカルにインストールされ起動していることを確認してください
-
インストール完了後、LibreChat を起動してブラウザで http://localhost:3080/ を開いてチャットインターフェースにアクセスします
-
左ナビゲーションバーで MCP Settings アイコンをクリックし、 Add MCP をクリック
-
Add MCP パネルで以下の値を設定します:
- Name: CData MCP、または任意の名前
- Description: サーバーの説明(任意)
- MCP Server URL: https://mcp.cloud.cdata.com/mcp
- Transport: Streamable HTTPS
- Authentication: API Key
- Header Format: Basic
- API Key: email:PAT を Base64 エンコードした値
注意:LibreChat は Connect AI との通信に Basic 認証を使用します。Connect AI のユーザーメールと前の手順で作成した PAT を email:PAT の形式で組み合わせ、その文字列を Base64 エンコードして API Key フィールドに貼り付けてください。例えば、[email protected]:ABC123...XYZ789 を Base64 エンコードすると dXNlckBkb21haW4uY29tOkFCQzEyMy4uLlhZWjc4OQ== のような値になります
- I trust this application にチェックを入れて Add をクリックしてサーバーを保存
-
CData MCP サーバーが左ナビゲーションバーに表示されます。隣の接続アイコンをクリックして Connect AI への接続を確立します
MCP サーバーの有効化と LLM プロバイダーの設定
LibreChat はチャットを動かすために少なくとも 1 つの LLM プロバイダーが必要です。チャット入力で MCP サーバーを有効化し、モデルが Connect AI 経由で MCP ツールを呼び出せるよう、使用するプロバイダーの API キーを追加します。
-
チャットインターフェースで入力ボックス下部の MCP セレクターをクリックし、CData MCP にチェックが入っていることを確認してツールをチャットに公開します
-
チャット上部のモデルセレクターをクリックして、使用する LLM プロバイダー(OpenAI、Anthropic、Google など)とモデルを選択します
-
選択したプロバイダーの横にある Set API Key をクリックし、プロバイダーの API キーを貼り付けて Submit をクリック
MCP サーバーと LLM プロバイダーの設定が完了したので、LibreChat は Connect AI 経由でリアルタイムNetSuite のデータをクエリできる状態になりました。
ステップ 3:LibreChat からリアルタイム NetSuite のデータ をクエリ
連携設定が完了したら、LibreChat のチャット入力を使用して、設定した LLM が処理する自然言語プロンプトでリアルタイムNetSuite のデータを操作します。
-
CData MCP サーバーが有効でモデルが選択された状態で、チャット入力にプロンプトを入力します。例:
- CData MCP のカタログを一覧表示して
- NetSuite で利用可能なスキーマとテーブルを表示して
- NetSuite のデータ のテーブルから上位 5 件のレコードをクエリして
-
LibreChat が Connect AI MCP Server を呼び出し、NetSuite のデータのリアルタイム結果を返します
これで LibreChat インスタンスが Connect AI MCP Server と通信し、チャットインターフェースから直接 Remote MCP ツールを通じてリアルタイムNetSuite のデータを取得できるようになりました。
CData Connect AI を入手
クラウドアプリケーションから直接数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを取得するには、CData Connect AI をお試しください。 14 日間の無料トライアルをご活用ください。ご不明な点はいつでもワールドクラスのサポートチームがお手伝いします。